アップグレード

Fumadocs のパッケージはすべてまとめてアップグレードしてください。Fumadocs UI は、同時にリリースされたバージョンと完全に一致する fumadocs-core をピア依存関係として必要とします。

以下のコマンドは、すべての fumadocs-* および @fumadocs/* パッケージをアップグレードします。また、テンプレートで使用されている fumadocs-ui から @fumadocs/base-ui へのエイリアスもそのまま維持されます。

npx npm-check-updates -u "fumadocs-*" "@fumadocs/*" && npm install

yarn up を使うとエイリアスが Radix UI 版の fumadocs-ui に置き換えられてしまうため、Yarn のコマンドでは npm-check-updates を使用しています。

メジャーバージョンアンカーリンクをコピー

メジャーバージョンをまたいでアップグレードする際は、該当するバージョンのリリースノートを確認してください。

• Fumadocs 16: 15.2 から非推奨となっていた API を削除し、fumadocs-core/server のエクスポートを個別のモジュールに移動しました。また、React 19.2 が必要になりました。
• Fumadocs 15: スタイルを Tailwind CSS v4 に移行しました。

• Fumadocs MDX 15: fumadocs-core 16.7.0 以降、および ESM 形式の `next.config`が必要になりました。
• Fumadocs MDX 14: 生成される .source フォルダーを、サーバー用、ブラウザー用、動的読み込み用の各エントリーに分割しました。