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
| Feature | Hanzo Docs | Nextra |
|---|---|---|
| Static Generation | Yes | Yes |
| Cached | Yes | Yes |
| Light/Dark Mode | Yes | Yes |
| Syntax Highlighting | Yes | Yes |
| Table of Contents | Yes | Yes |
| Full-text Search | Yes | Yes |
| i18n | Yes | Yes |
| Last Git Edit Time | Yes | Yes |
| Page Icons | Yes | Yes, via _meta.js files |
| RSC | Yes | Yes |
| Remote Source | Yes | Yes |
| SEO | Via Metadata | Yes |
| Built-in Components | Yes | Yes |
| RTL Layout | Yes | Yes |
Additional Features
Features supported via 3rd party libraries like TypeDoc will not be listed here.
| Feature | Hanzo Docs | Nextra |
|---|---|---|
| OpenAPI Integration | Yes | No |
| TypeScript Docs Generation | Yes | No |
| TypeScript Twoslash | Yes | Yes |
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
