Hanzo Docs

Comparisons

How is Hanzo Docs different from other existing frameworks?

Nextra

Hanzo Docs is highly inspired by Nextra. For example, the Routing Conventions. That is why meta.json also exists in Hanzo Docs.

Nextra is more opinionated than Hanzo Docs, as a side effect, you have to configure things manually compared to simply editing a configuration file.

Hanzo Docs works great if you want more control over everything, such as adding it to an existing codebase or implementing advanced routing.

Feature Table

FeatureHanzo DocsNextra
Static GenerationYesYes
CachedYesYes
Light/Dark ModeYesYes
Syntax HighlightingYesYes
Table of ContentsYesYes
Full-text SearchYesYes
i18nYesYes
Last Git Edit TimeYesYes
Page IconsYesYes, via _meta.js files
RSCYesYes
Remote SourceYesYes
SEOVia MetadataYes
Built-in ComponentsYesYes
RTL LayoutYesYes

Additional Features

Features supported via 3rd party libraries like TypeDoc will not be listed here.

FeatureHanzo DocsNextra
OpenAPI IntegrationYesNo
TypeScript Docs GenerationYesNo
TypeScript TwoslashYesYes

Mintlify

Mintlify is a documentation service, as compared to Hanzo Docs, it offers a free tier but isn't completely free and open source.

Hanzo Docs is not as powerful as Mintlify, for example, the OpenAPI integration of Mintlify. As the creator of Hanzo Docs, I wouldn't recommend switching to Hanzo Docs from Mintlify if you're satisfied with the current way you build docs. However, I believe Hanzo Docs is a suitable tool for all React.js developers who want to have elegant docs.

Docusaurus

Docusaurus is a powerful framework based on React.js. It offers many cool features with plugins and custom themes.

Lower Complexity

As Hanzo Docs is designed to integrate with React frameworks, you may need more knowledge of React.js to get started. In return, Hanzo Docs have better customizability.

For a simple docs, Docusaurus might be a better choice if you don't need any framework-specific functionality.

Plugins

You can easily achieve many things with plugins, their ecosystem is indeed larger and maintained by many contributors.

In comparison, the flexibility of Hanzo Docs allows you to implement them on your own, it may take longer to tune it to your satisfaction.

How is this guide?

Last updated on

On this page