サンプル
zfb を示す 10 のスタンドアロンなリポジトリの比較表。9 つはデプロイ済みの Cloudflare Workers プロジェクトで、1 つはローカル専用のサンプルです。
zfb には、スタンドアロンなサンプルリポジトリが 10 個付属しています。そのうち 9 つは 小さくデプロイ可能なプロジェクトで、それぞれ単一の Cloudflare レシピを端から端まで 示します。10 個目の Agent Conversations はローカル専用です。各リポジトリは独立して pnpm install でき、ローカルでの実行手順を記した独自の README を備えています。 Cloudflare のサンプルには、プロビジョニングコマンドも記されています — スニペットを 断片的にコピーするのではなく、いずれか 1 つをクローンして全体が組み上がった様子を 確認してください。
このページは比較表です。掲載しているリポジトリはすべて zfb 3.1.0 を固定し(2026-10-03 時点で確認)、zfb の zudo-react JSX ランタイムを使っています。スタイリング欄には zudo-wind のユーティリティを 使うか、リセットだけを使うか、CSS を自分で記述するかを示しています。各行から レシピ にある詳しい解説ページへ移動でき、そのサンプルが何を示しているか、どう動くか、ローカルで どう実行するかを確認できます。
Cloudflare の 9 つのサンプルは Cloudflare Workers として takazudomodular.com のサブドメインに デプロイされています。7 つはサーバーコードを持ち、残り 2 つは Worker スクリプトを まったく持たないアセットのみの Worker です。
password-gate は意図的に 401 を返す
以下のデモのリンク先はすべて稼働中ですが、1 つだけ意図的な例外があります。zfb-example-password-gate.takazudomodular.comはサイトの内容ではなくログインページと 401 Unauthorized を返します。これは壊れて いるのではなく、コンテンツをゲートすることこそがこのサンプルの目的だからです。
Worker を伴うサンプル
以下の 7 つは、自分が受け持つリクエストごとに実行される Worker スクリプトを出力するか、 自分で書いています。6 つは @takazudo/zfb-adapter-cloudflare を使って prerender = false のルートを実行します — SSR と Cloudflare バインディング で扱っているパターンです。残る 1 つの password-gate はアダプタを一切インストールせず、 静的ビルドの前段に自分で書いた Worker を置いています。
| サンプル | レンダリング | バインディングとシークレット | スタイリング | リンク |
|---|---|---|---|---|
| AI Summarizer | SSG と prerender = false の API ルート 1 つ(アダプタ) | Workers AI AI、名前付き環境 ai にのみ宣言 | CSS を記述、zudo-wind はリセットのみ | リポジトリ · デモ |
| JSON API | SSG と prerender = false の API ルート 2 つ(アダプタ) | なし | CSS を記述、zudo-wind はリセットのみ | リポジトリ · デモ |
| KV Guestbook | / を除く全ルートが SSR(アダプタ) | Workers KV GUESTBOOK、ADMIN_TOKEN シークレット | インライン CSS、zudo-wind のリセットは / のみ | リポジトリ · デモ |
| Password Gate | 純粋 SSG を手書き Worker の後ろに配置、run_worker_first = true、アダプタなし | SITE_PASSWORD シークレット | CSS を記述、zudo-wind はリセットのみ | リポジトリ · デモ |
| Reverse Proxy | SSG とキャッチオールの prerender = false ルート 1 つ(アダプタ) | なし、公開の PROXY_ORIGIN 変数が 1 つ | CSS を記述、zudo-wind はリセットのみ | リポジトリ · デモ |
| Webshop | 全ルート SSR、HTML は出力されない(アダプタ) | D1 DB | zudo-wind のユーティリティと明示的なトークン | リポジトリ · デモ |
| Workers Cache | 全ルート SSR、HTML は出力されない(アダプタ) | PURGE_TOKEN シークレット | インラインの CSS を記述、zudo-wind は無効 | リポジトリ · デモ |
静的なサンプル
以下の 2 つは、Worker スクリプトを持たずに dist/ を Workers Static Assets として デプロイします。wrangler.toml には [assets] テーブルがあるだけで main キーは意図的に なく、@takazudo/zfb-adapter-cloudflare も依存に含まれていません。サーバーコードが まったく不要なサイトでは、この形をまねてください。
| サンプル | レンダリング | バインディングとシークレット | スタイリング | リンク |
|---|---|---|---|---|
| Blog | 純粋 SSG、アセットのみの Worker | なし | CSS を記述、zudo-wind はリセットのみ | リポジトリ · デモ |
| Corporate Website | 純粋 SSG、アセットのみの Worker | なし | CSS Modules、zudo-wind は無効 | リポジトリ · デモ |
ローカル専用のサンプル
このサンプルにはデプロイがありません。公開用のショーケースは zfb の静的ビルドで、同じ UI の 2 つ目のビルドがループバックの HTTP と SQLite のサーバーと通信します。Cloudflare Worker のハンドラーファクトリーも含みますが、Worker、D1 データベース、Queue は用意されて いないため、デプロイ済みの Cloudflare アプリケーションとして読まないでください。
| サンプル | レンダリング | バインディングとシークレット | スタイリング | リンク |
|---|---|---|---|---|
| Agent Conversations | 純粋 SSG と <Island when="load"> 1 つ、アダプタなし | なし。プロバイダーとホストは合成で、認証情報なし | CSS を記述、zudo-wind は無効 | リポジトリ |