コンテンツへスキップ
Fumadocs

静的ビルド

Fumadocs で静的サイトを出力します。

セットアップ

Fumadocs はデフォルトでサーバーファーストのアプローチを採用しているため、稼働中のサーバーが必要です。 TanStack Start を設定すれば、静的ビルドを出力できます。

静的ビルドにはサーバーが存在しないため、次の機能は動作しません。

  • 検索サーバー。代わりに静的検索を使用してください。
  • AIに質問。チャットルートから AI モデルを呼び出す必要があるためです。
  • MCP サーバー。

また、ミドルウェアも実行されないため、Accept ヘッダーに応じた Markdown の配信も行われません。

  1. 検索サーバーを設定します。
  2. 検索 UI/クライアントを設定します。

設定が完了すると、検索インデックスがアプリに静的に保存され、検索処理はブラウザ側で行われるようになります。

クラウドソリューション

検索機能はリモートサーバーで動作するため、静的エクスポートでも追加の設定なしで利用できます。

デプロイ

SPA モードとプリレンダリングを設定します。詳細については、SPA Mode を参照してください。

vite.config.ts
import { tanstackStart } from '@tanstack/react-start/plugin/vite';
import { defineConfig } from 'vite';

export default defineConfig({
  plugins: [
    // ...その他のプラグイン
    tanstackStart({
      spa: {
        enabled: true,
        // TanStack Router がページを自動的にクロールします
        prerender: {
          enabled: true,
        },
        // UI 上に表示されない隠れたパスがある場合は、明示的に追加できます。
        pages: [
          {
            path: '/docs/test',
          },
        ],
      },
    }),
  ],
});

How is this guide?

最終更新日