前提条件

概要

CastMatrix を本番運用するために必要なアカウント・ツール・スキルです。

ライセンスキー（Gumroad）

Gumroad での購入後に発行されるライセンスキーは、Cloudflare 上での初回セットアップ時に必要です。
ローカル開発では不要です。

環境	ライセンスキー
ローカル（localhost）	不要
Cloudflare 上（*.pages.dev・カスタムドメイン）	必須

購入完了メールまたは gumroad.com/library からキーを確認し、手元に控えておいてください。
一度認証するとデータベースに保存され、以降の再入力は不要です。

必要なアカウント

項目	必須	備考
Gumroad ライセンスキー	Cloudflare デプロイ時	購入完了メールまたは gumroad.com/library で確認
Cloudflare アカウント	はい	Pages, Workers, D1, R2 を利用
独自ドメイン	推奨	Pages のカスタムドメイン設定用
Google Analytics（GA4）	任意	サイト設定から埋め込み
公式 LINE アカウント	任意	追従バナー・予約リンク用

必要なローカル環境

ツール	用途
Node.js（LTS 推奨）	フロント・管理画面のビルド
pnpm	パッケージ管理（monorepo）
Wrangler CLI	Workers / D1 のデプロイ・マイグレーション
Git	ソース管理・GitHub 連携（後述）

GitHub プライベートリポジトリの利用（強く推奨）

購入した ZIP を展開したディレクトリは、GitHub のプライベートリポジトリで管理することを強くお勧めします。

• カスタマイズ履歴を Git で管理でき、変更前の状態にいつでも戻せます
• Cloudflare Pages が GitHub と自動連携し、git push だけでフロントエンドが自動デプロイされます
• docs/ はすべて Markdown で書かれており、GitHub 上でそのまま綺麗に読めます。このマニュアル自体も GitHub リポジトリ上で参照するのが最も使いやすい形式です

詳しい手順は 00-roadmap.md — 0-4. GitHub プライベートリポジトリへの登録（購入後 ZIP 同梱） を参照してください。

想定スキル

• HTML / CSS の読み書き
• ターミナルでの基本コマンド実行
• 環境変数・シークレットの概念

完全な開発未経験者向けではありません。初期構築でつまずく場合は 03-support-policy.md を参照してください。

バージョン要件

ツール	最小バージョン	推奨
Node.js	20.x LTS	22.x LTS
pnpm	9.x	package.json の packageManager に合わせる（Corepack 推奨）
Wrangler CLI	3.85.0	最新

インストール確認コマンド:

node -v             # v20.0.0 以上
corepack enable     # 初回のみ（Node.js 同梱の Corepack で pnpm を有効化）
pnpm -v             # 9.x
wrangler --version  # 3.x.x