Fumadocs — это открытый фреймворк для сайтов документации на React, чаще всего на Next.js: контент в MDX, готовый интерфейс, поиск и генерация страниц API.
Главное отличие от Mintlify и GitBook — документация остаётся вашим кодом. Вы полностью управляете вёрсткой и хостингом и не платите за сервис.
Возможности
- Контент в MDX с компонентами: вкладки, карточки, подсказки, шаги.
- Готовый интерфейс на Tailwind CSS с тёмной темой и мобильной версией.
- Встроенный поиск и подключение внешних поисковых движков.
- Страницы API из спецификации OpenAPI.
- Подсветка кода с типами TypeScript и выдача текстов для ИИ, например в формате llms.txt.
Кому подходит
Разработчикам и командам продуктов, которые хотят документацию в своём репозитории и стиле, без ограничений SaaS-платформ.
Как начать
Создайте проект командой npm create fumadocs-app, выберите фреймворк и источник контента, добавьте MDX-страницы и опубликуйте на Vercel или своём хостинге.
Совет
Держите документацию в том же репозитории, что и продукт: правки кода и текста попадают в один пулл-реквест, и документация не отстаёт от релизов.
Ограничения
Нужны навыки React и Next.js, контент-менеджеру без разработчика будет сложно. Нет визуального редактора. Если нужна простая документация без кода, подойдёт GitBook, для статического сайта на React — Docusaurus.