Node なしでインストール

zfb を Node.js / npm 不要のスタンドアロンバイナリとしてインストールする方法。curl・Homebrew・Windows PowerShell の各インストール経路を解説します。

zfb は自己完結型の Rust バイナリとして配布されます。インストールにも実行にも Node.js は不要です — esbuild と Tailwind は zfb 実行ファイルの vendor snapshot に 埋め込まれ、サブプロセスとして呼び出される前に runtime で展開されます。zfb の隣に 別々の release-tarball バイナリとして同梱されるわけではありません。Node が必要になるのは 一部の機能をオプトインで使う場合だけです（下記の「Node が依然として必要なケース」を参照）。

Node なしの経路でもコンテンツサイト向けの全機能が利用できます。Markdown・MDX・ HTML ページ、さらに islands まで対応します — esbuild と Tailwind は zfb によって展開された ネイティブバイナリとして動作するため、クライアントサイドの ハイドレーションも CSS 処理も Node を一切介さずに動きます。npm を使うプロジェクトにとって 組み込みの Tailwind が何を意味するかについては、 Tailwind は zfb に組み込まれている を参照してください。

サポートされているプラットフォーム

インストール経路

Linux / macOS — curl

curl -fsSL https://raw.githubusercontent.com/Takazudo/zudo-front-builder/main/install.sh | sh

zfb は $HOME/.local/bin/zfb にインストールされます。このディレクトリがまだ PATH に含まれていない場合は追加してください：

export PATH="$HOME/.local/bin:$PATH"

環境変数：

macOS — Homebrew

brew install Takazudo/tap/zfb

tap は Takazudo/homebrew-tap でホストされています。formula は 安定版リリースごとに scripts/update-homebrew-formula.sh によって更新されます。

後から新しいバージョンへ更新するには：

brew upgrade zfb

Windows — PowerShell

irm https://raw.githubusercontent.com/Takazudo/zudo-front-builder/main/install.ps1 | iex

zfb.exe は %LOCALAPPDATA%\zfb\bin\zfb.exe にインストールされます。

環境変数：

バイナリを現在のセッションの PATH に追加するには：

$env:PATH = "$env:LOCALAPPDATA\zfb\bin;$env:PATH"

恒久的に追加する場合（実行後は新しいターミナルを開いてください）：

[System.Environment]::SetEnvironmentVariable(
  'PATH',
  "$env:LOCALAPPDATA\zfb\bin;" + [System.Environment]::GetEnvironmentVariable('PATH', 'User'),
  'User'
)

Windows — Scoop

インストールの確認

zfb --version

設定ファイル：zfb.config.json と zfb.config.ts

どちらの設定フォーマットも Node なしで動作します。zfb.config.ts は、デフォルトの zfb バイナリに同梱された組み込み V8 アイソレートによってインプロセスで評価されます — 実行時の Node 依存はありません。

zfb.config.ts はデータ設定です — node:* のインポート、process.env、その他 Node 専用 API は評価器内では利用できません。TypeScript の型・コメント・計算値が 欲しい場合は zfb.config.ts を、プレーンな JSON で済ませたい場合は zfb.config.json を使ってください。

// zfb.config.json — こちらも Node なしで動作します
{
  "framework": "preact",
  "outDir": "dist",
  "collections": [
    {
      "name": "blog",
      "path": "content/blog",
      "schema": { "type": "object", "properties": { "title": { "type": "string" } } }
    }
  ]
}

zfb.config.ts と zfb.config.json の両方が存在する場合は .ts ファイルが 優先されます。

Node が依然として必要なケース

以下の機能は PATH 上に Node が必要です：

それ以外 — ビルド、開発サーバー、islands、Tailwind、MDX、コンテンツコレクション、 zfb.config.ts の評価 — はすべて Node なしで動作します。

zfb のアップグレード

その場でアップグレードする zfb upgrade コマンドは将来のリリースで計画されています。 現時点では、最初に使ったインストールコマンドを再実行してください — 既存のバイナリを 最新バージョンで上書きします。