# zfb

> The Rust engine under your content-site framework — router, renderer, content pipeline. Author in TypeScript/JSX, runs as a single binary.

## Docs

- [zfb を選ぶ](https://takazudomodular.com/pj/zudo-front-builder/ja/docs/concepts/choosing-zfb): zfb がプロジェクトに合うのはどんなときか、合わないのはどんなときか、そしてスケールのスイートスポットはどこか。
- [設計哲学](https://takazudomodular.com/pj/zudo-front-builder/ja/docs/concepts/design-philosophy): なぜ zfb は意図的に狭いままでいるのか、そしてなぜ AI 時代がそのバランスを「プラグインよりレシピ」へとさらに傾けるのか。
- [アーキテクチャ概要](https://takazudomodular.com/pj/zudo-front-builder/ja/docs/concepts/architecture-overview): zfb のランタイムスタックをトップダウンで捉えるメンタルモデル — 2 つのバンドル、何がどこで動くのか、そしてなぜ Hono/Workers の形が安定したコントラクトなのか。
- [エンジンとフレームワーク](https://takazudomodular.com/pj/zudo-front-builder/ja/docs/concepts/engine-vs-framework): zfb はエンジン、フレームワークがその上に乗る
- [はじめに](https://takazudomodular.com/pj/zudo-front-builder/ja/docs/getting-started): はじめにのセクションへようこそ。以下からトピックを選択してください。
- [フロントマター](https://takazudomodular.com/pj/zudo-front-builder/ja/docs/concepts/frontmatter): MD/MDX の YAML と TSX の export const literal、統一された JSON 表現
- [defineConfig](https://takazudomodular.com/pj/zudo-front-builder/ja/docs/api/define-config): 完全な型推論つきで zfb プロジェクトの設定を定義します。
- [ビルドエンジン](https://takazudomodular.com/pj/zudo-front-builder/ja/docs/architecture/build-engine): zfb のクレートがどう組み合わさるか、なぜリビルドがページ単位なのか、そして `dist/` への書き込みを安全にしている仕組み。
- [ルーティング](https://takazudomodular.com/pj/zudo-front-builder/ja/docs/concepts/routing): pages/ 配下のファイルシステムルーティングが zfb で URL にどうマッピングされるか。
- [はじめに](https://takazudomodular.com/pj/zudo-front-builder/ja/docs/getting-started/introduction): zfb とは何か、誰のためのものか、Astro や Next.js とどう比較されるか。
- [Astro からの移行](https://takazudomodular.com/pj/zudo-front-builder/ja/docs/guides/migrating-from-astro): 既存の Astro 静的サイトを zfb に移行するための概念対応マップ。
- [Node なしでインストール](https://takazudomodular.com/pj/zudo-front-builder/ja/docs/install/node-free): zfb を Node.js / npm 不要のスタンドアロンバイナリとしてインストールする方法。curl・Homebrew・Windows PowerShell の各インストール経路を解説します。
- [レシピ](https://takazudomodular.com/pj/zudo-front-builder/ja/docs/recipes): zfb を使うための自己完結したパターン集。キュレーションされたセクションで、コンテンツは順次追加されます。
- [動的ルート](https://takazudomodular.com/pj/zudo-front-builder/ja/docs/concepts/dynamic-routes): paths() の形と、params と props の渡し方
- [Markdown と HTML ページ](https://takazudomodular.com/pj/zudo-front-builder/ja/docs/concepts/md-html-pages): .md と .html を .tsx と同様にページエントリとして使う方法
- [getCollection](https://takazudomodular.com/pj/zudo-front-builder/ja/docs/api/get-collection): コンテンツまたはデータコレクションのすべてのエントリを読み込みます。
- [JS ランタイム](https://takazudomodular.com/pj/zudo-front-builder/ja/docs/architecture/js-runtime): zfb がサーバーサイドの JavaScript 実行を組み込み V8 アイソレートでどうホストしているか、そしてなぜランタイムがバイナリによって固定されるのか。
- [Content Collections](https://takazudomodular.com/pj/zudo-front-builder/ja/docs/concepts/content-collections): Define typed collections of Markdown content in zfb.config and load them from pages.
- [インストール](https://takazudomodular.com/pj/zudo-front-builder/ja/docs/getting-started/installation): zfb CLI を npm からインストールする。
- [Eleventy からの移行](https://takazudomodular.com/pj/zudo-front-builder/ja/docs/guides/migrating-from-eleventy): 11ty サイトを zfb に移行するための概念ごとのガイダンスと、適合しないケースについての率直な注記。
- [MDX Components](https://takazudomodular.com/pj/zudo-front-builder/ja/docs/concepts/mdx-components): MDX エントリがレンダリング可能な React/Preact コンポーネントとしてページに届く仕組みと、components prop で個々の要素をオーバーライドする方法。
- [カスタムディレクティブ](https://takazudomodular.com/pj/zudo-front-builder/ja/docs/concepts/custom-directives): MDX ディレクティブレジストリで Rust を書かずにディレクティブを追加する
- [paginate](https://takazudomodular.com/pj/zudo-front-builder/ja/docs/api/paginate): アイテムのリストをページネーションされたルートインスタンスへ展開します。
- [フレームワークアダプター](https://takazudomodular.com/pj/zudo-front-builder/ja/docs/architecture/framework-adapters): zfb が単一のレンダラーの背後で Preact と React の両方をどう支えているか、そして 3 つ目のフレームワークの追加を加算的にする境界の形。
- [データ](https://takazudomodular.com/pj/zudo-front-builder/ja/docs/concepts/data): zfb で構造化データを取り込む 3 つの選択肢 — コンテンツコレクション、データコレクション、プレーンな TS モジュール。
- [最初のサイト](https://takazudomodular.com/pj/zudo-front-builder/ja/docs/getting-started/your-first-site): zfb プロジェクトをおよそ 5 分でスキャフォールド・実行・ビルドする。
- [Markdown のカスタマイズ](https://takazudomodular.com/pj/zudo-front-builder/ja/docs/guides/customizing-markdown): zfb の Markdown レンダリングパイプライン、設定可能な範囲、拡張方法
- [Markdown パイプラインの拡張](https://takazudomodular.com/pj/zudo-front-builder/ja/docs/guides/extending-the-markdown-pipeline): zfb の Markdown / MDX パイプラインに新しい機能を追加する方法 — ディレクティブで足りるとき、Rust の visitor を書くとき、AST コンバーター自体に手を入れるとき
- [Island](https://takazudomodular.com/pj/zudo-front-builder/ja/docs/api/island): Island JSX ラッパーを使って、コンポーネントをクライアントでハイドレートされる島としてラップします。
- [なぜ Rust か](https://takazudomodular.com/pj/zudo-front-builder/ja/docs/architecture/why-rust): 静的サイトフレームワークを Rust で書くという賭け、それが何をもたらし、何を犠牲にするか。
- [スタイリング](https://takazudomodular.com/pj/zudo-front-builder/ja/docs/concepts/styling): グローバル CSS、Tailwind v4、そして zfb におけるコンポーネントスコープなスタイリングの位置づけ。
- [プロジェクト構造](https://takazudomodular.com/pj/zudo-front-builder/ja/docs/getting-started/project-structure): デフォルトテンプレートが配置するすべてのファイルとディレクトリを案内する。
- [シンタックスハイライト](https://takazudomodular.com/pj/zudo-front-builder/ja/docs/guides/syntax-highlighting): zfb は syntect によるサーバーサイドのシンタックスハイライトを搭載しています。このページでは組み込みテーマの設定方法、カスタム .tmTheme ファイルの使い方、補足パターンを解説します。
- [静的アセット](https://takazudomodular.com/pj/zudo-front-builder/ja/docs/concepts/static-assets): 画像・SVG・フォント・favicon・robots.txt など、バイト単位でそのまま配信するファイルを zfb の public/ ディレクトリ経由でどう配信するか。
- [meta export](https://takazudomodular.com/pj/zudo-front-builder/ja/docs/api/meta-export): meta エクスポートでページごとの head メタデータを宣言します。
- [Islands](https://takazudomodular.com/pj/zudo-front-builder/ja/docs/concepts/islands): クライアントでインタラクティブなコンポーネントを "use client" でマークすると、zfb がブラウザでハイドレートします。
- [HTML 以外のページ](https://takazudomodular.com/pj/zudo-front-builder/ja/docs/concepts/non-html-pages): ファイル名規約と frontmatter.extension で sitemap.xml.tsx などを出力する
- [ビルドパイプライン](https://takazudomodular.com/pj/zudo-front-builder/ja/docs/concepts/build-pipeline): zfb がプロジェクトをビルド済みサイトに変えるまでの端から端までのツアー。
- [デスクトップ展開](https://takazudomodular.com/pj/zudo-front-builder/ja/docs/guides/desktop-deployment): zfb でビルドしたサイトを Tauri・Electron などのデスクトップアプリケーションに組み込む方法。
- [インクリメンタルリビルド](https://takazudomodular.com/pj/zudo-front-builder/ja/docs/concepts/incremental-rebuild): zfb の依存グラフが、各リビルドを実際にファイル変更の影響を受けるページだけに限定する仕組み。
- [ライブラリとして組み込む](https://takazudomodular.com/pj/zudo-front-builder/ja/docs/guides/embed-as-library): Server ビルダー API を介して、Rust ホスト（Tauri・CLI・サービス）から zfb の HTTP サーバーをインプロセスで動かす。
- [SSR と Cloudflare バインディング](https://takazudomodular.com/pj/zudo-front-builder/ja/docs/guides/ssr-and-cloudflare-bindings): Cloudflare アダプターで動的ルートを配信し、Worker バインディング（シークレット・KV・D1 データベース）を SSR ハンドラ内から読み取る。
- [dev モードのライフサイクル](https://takazudomodular.com/pj/zudo-front-builder/ja/docs/concepts/dev-mode-lifecycle): .tsx ファイルを保存してからブラウザで変更が見えるまでに何が起こるか — ウォッチャー、リバンドル、SSR リフレッシュ、そして 3 つの SSE イベント種別。
- [Worker 上の SSR（アダプターモード）](https://takazudomodular.com/pj/zudo-front-builder/ja/docs/concepts/ssr-on-a-worker): prerender = false の zfb ページがプロダクションで実際にどう動くか — 2 層のワーカー出力、ASSETS 優先のディスパッチ、そして getCloudflareContext() を支える AsyncLocalStorage のトリック。
- [プラグイン](https://takazudomodular.com/pj/zudo-front-builder/ja/docs/concepts/plugins): zfb プラグインの作成と利用 — 4 つのライフサイクルフック、仮想モジュール、インポートエイリアス、開発専用の注入ルート。
- [変更履歴](https://takazudomodular.com/pj/zudo-front-builder/ja/docs/changelog): 変更履歴
- [v0.1.0-next.5](https://takazudomodular.com/pj/zudo-front-builder/ja/docs/changelog/v0.1.0-next.5): v0.1.0-next.5