Сравнения

Nextra

Fumadocs сильно вдохновлен Nextra. Например, соглашения о маршрутизации. Именно поэтому meta.json также существует в Fumadocs.

Nextra более ориентирован на определённый подход, чем Fumadocs. Fumadocs ускорен благодаря App Router. В результате он предоставляет множество серверных функций, и вам приходится настраивать всё вручную по сравнению с простым редактированием файла конфигурации.

Fumadocs отлично работает, если вы хотите больше контроля над всем, например, при добавлении его в существующую кодовую базу или реализации сложной маршрутизации.

Таблица возможностей

Дополнительные возможности

Возможности, поддерживаемые через сторонние библиотеки, такие как TypeDoc, здесь не перечислены.

Mintlify

Mintlify — это сервис документации, в отличие от Fumadocs, он предлагает бесплатный тариф, но не является полностью бесплатным и открытым исходным кодом.

Fumadocs не так мощен, как Mintlify, например, в части интеграции с OpenAPI. Как создатель Fumadocs, я не рекомендую переходить на Fumadocs с Mintlify, если вас устраивает текущий способ создания документации. Однако я считаю, что Fumadocs — подходящий инструмент для всех разработчиков Next.js, которые хотят иметь элегантную документацию.

Docusaurus

Docusaurus — это мощный фреймворк на основе React.js. Он предлагает множество крутых возможностей с помощью плагинов и пользовательских тем.

Лучший DX (Developer Experience)

Поскольку Fumadocs построен поверх Next.js, вам каждый раз придётся запускать dev-сервер Next.js для проверки изменений, а начальный шаблонный код относительно больше по сравнению с Docusaurus.

Для простой документации Docusaurus может быть лучшим выбором, если вам не нужна какая-либо специфичная для Next.js функциональность.

Однако, если вы хотите использовать Next.js или ищете дополнительную настраиваемость, например, настройку компонентов UI по умолчанию, Fumadocs может быть лучшим выбором.

Плагины

С помощью плагинов можно легко достичь многих вещей, их экосистема действительно больше и поддерживается многими участниками.

В сравнении, гибкость Fumadocs позволяет реализовать их самостоятельно, но может потребоваться больше времени, чтобы настроить его по своему вкусу.