評価
日英の静的製品ドキュメントを想定した Fumadocs の日付付き実践評価です。
この評価では、実使用の印象と外部から検証できる事実を分けます。 パッケージと公式資料は 2026-07-19 に確認しました。
結論
実使用の印象（主観）: Fumadocs は React 系の比較対象の中で、 最も構成可能で機能の厚い初期状態を提供します。既定 UI は洗練され、 コンテンツ Loader とページツリーも一貫しています。一方で、 小さな Markdown 中心のジェネレーターより概念と設定は多めです。
長所
- 実使用の印象: Core / MDX / UI の分離により、既定テーマを使いながら 責務の境界を理解しやすいです。
- この実装での事実: 1 つの Loader がルート、言語別サイドバー、 前後ナビゲーション、検索用構造化データを提供します。
- この実装での事実: 公式の静的テンプレートに沿い、 サーバー不要の HTML とブラウザ内 Orama 索引を出力します。
懸念とトレードオフ
- 実使用の印象:
fumadocs-core、fumadocs-mdx、UI、Next.js、 Tailwind、各種統合という層は、VitePress の小さな基本構成より アップグレード面が多くなります。 - 事実: Fumadocs は i18n の基礎機能とレイアウト内ナビゲーションを 提供しますが、アプリ全体の翻訳は行いません。このプロジェクトが ルーティング、日本語 UI、1:1 の原稿対応を所有します。
- 事実: Mermaid と数式は別途統合が必要です。GitHub Alerts のマーカーは
この基本構成で専用表示にならず、Fumadocs では
Calloutが実用的な代替です。 - 事実: 静的検索は索引をブラウザにダウンロードするため、 公式ガイドは大規模サイトでのコストに注意を促しています。
メンテナンスのスナップショット — 2026-07-19
外部から検証できる事実: 現行の公式ジェネレーターは、
fumadocs-core と @fumadocs/base-ui 16.11.5、fumadocs-mdx 15.2.0、
Next.js 16.2.10 を静的テンプレートに選択しました。npm の
fumadocs-core@16.11.5、
@fumadocs/base-ui@16.11.5、
公開 リリース履歴 で確認できます。
最近の公開は将来の保守を保証するものではありません。
公式資料の 静的ビルド、 Next.js での国際化、 静的 Orama 検索 は、この実装内容と対応します。
選定の目安
React / Next.js チームが、ヘッドレスな拡張性を保ったまま完成度の高い ドキュメント UI を求めるなら Fumadocs が向いています。多層の依存関係と アプリ側がi18n を所有するコストを見込みます。Markdown、サイドバー、静的出力だけなら、 より小さなジェネレーターの方が簡単です。