クイックスタート

お探しのAPIや修正は、新しいバージョンで提供されている可能性があります。Fumadocsをアップグレードしてから、もう一度お試しください。

ルーティングは Next.js が処理します。まず、docs ルートを移動します (/docs/* -> /info/*) 。

ルートの名前を変更します。

または、ルートグループを使用して /docs/* を /* に変更することもできます。

最後に、source.ts でページのベース URL を更新します。

import { loader } from 'fumadocs-core/source';

export const source = loader({
  baseUrl: '/info', // 新しい値に変更
});

テンプレートでは、この値は lib/shared.ts 内で docsRoute として定義されています。Markdown のリンクにも反映されるよう、こちらで変更してください。

レイアウトタブの使用をおすすめします。

Next.js App Router でレイアウトを管理する場合と同様に、まずコンテンツディレクトリ (/content/docs) から元の MDX ファイルを削除します。 これにより、ページの重複によるエラーを防げます。

次に、Docs レイアウトの配下にない別のルートグループにページを追加します。

たとえば、/docs/test を置き換える場合は次のようになります。

/docs を置き換える場合は、catch-all ルートを省略不可の形式に変更する必要があります。

次のような Turbopack のエラーが発生する場合:

JSON file not found: FileSystemPath { ... path: "lib/locales/sources/file.json.json" }

多くの場合、require(esm) がサポートされていないことが原因です (#3312) 。Node.js 22 以上にアップグレードしてください。

Node.js 23.1 で、本番ビルド時に次のエラーが発生する場合:

Could not find a production build in the '.next' directory.

これは既知の問題です (#1021 を参照) 。Node.js を 23.6.0 以上にアップグレードすると解決できます。

Next.js では、generateStaticParams が設定されていると、動的ルートが静的ルートに変換されます。 そのため、静的ページと同等の速度で動作します。

静的エクスポートを有効にすると、静的なビルド出力を得ることもできます。