Comparisons
How is Adalt different from other existing frameworks?
Philosophy
Less Abstraction: Adalt, unlike the other frameworks, expects you to write code and cooperate with the rest of your software. While most frameworks are configured with a configuration file, they usually lack of flexibility when you attempt to complete something more advanced. You can’t control how they render the page nor the internal logic. Adalt shows you how the app works, instead of a single configuration file.
Next.js Fundamentals: It gives you the utilities and a good-looking UI. You are still using the features of Next.js App Router, configuring Static Site Generation same as a normal Next.js application. There is nothing new for Next.js developers, you can use it with confidence.
For instance, in this docs, the cards of index pages are rendered dynamically. Feel free to take a look at the source code of this documentation.
Opinionated on UI: The only thing Adalt UI (the default theme) offers is User Interface, it is opinionated on UI for the best mobile responsiveness and user experience. The design is regularly updated, and we welcome feedback about the UI.
Nextra
Adalt is highly inspired by Nextra. For example, the Routing Conventions. That is why
meta.json also exists in Adalt.
Nextra is more opinionated than Adalt. Adalt is accelerated by App Router. As a result, It provides many server-side functions, and you have to configure things manually compared to simply editing a configuration file.
Adalt works great if you want more control over everything, such as adding it to an existing codebase or implementing advanced routing.
Feature Table
| Feature | Adalt | 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 | No |
| RSC | Yes | Pages Router Only |
| Remote Source | Yes | Not Documented |
| 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 | Adalt | Nextra |
|---|---|---|
| OpenAPI Integration | Yes | No |
| TypeScript Docs Generation | Yes | No |
| TypeScript Twoslash | Yes | No |
Mintlify
Mintlify is a documentation service, as compared to Adalt, it offers a free tier but isn't completely free and open source.
Adalt is not as powerful as Mintlify, for example, the OpenAPI integration of Mintlify. As the creator of Adalt, I wouldn't recommend switching to Adalt from Mintlify if you're satisfied with the current way you build docs. However, I believe Adalt is a suitable tool for all Next.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.
Better DX
Since Adalt is built on the top of Next.js, you'll have to start the Next.js dev server every time to review changes. And boilerplate code is relatively more compared to Docusaurus. For a simple docs, Docusaurus might be a better choice if you don't need any Next.js specific functionality.
Plugins
You can easily achieve many things with plugins. Although the flexibility of Adalt is high, their eco-system is larger and maintained by many contributors.
When to use Adalt?
For most of the web applications, vanilla React.js is no longer enough. Nowadays, we also wish to have a blog, a showcase page, a FAQ page, etc. With a fancy UI that's breathtaking, in these cases, Adalt can help you build the docs easier, with less boilerplate.
We are moving forward
More and more advanced features are rolling out. We currently support multiple searching solutions including Algolia Search. A good UI and user experience is always our priority, welcome to give us feedback via Github discussions!
Last updated on