ログインから月額課金まで動く、日本向け SaaS の土台

向いている方

• 会員制サイト・SaaS の MVP を受託する制作会社・フリーランスの方。この上に作ったサービスを納品できます（複数人で使うときは制作会社用のライセンスを）
• 日本向けに、日本語の画面・税込の円の月額・特定商取引法に基づく表記で、個人開発のサービスを出したい方
• オーナー・管理者・メンバーの 3 つの役割を、画面・Server Actions・RLS で同じ 1 か所の定義から決めたい方
• Next.js（App Router）と TypeScript を読み書きでき、Supabase と Stripe のアカウントを作れる方

向いていない方

• プログラムを書かずに会員制サイトを作りたい方（コードを直して使うキットです）
• 英語の画面で足り、役割も 2 つで足りる方（下の比較の無料の Next.js SaaS Starter をおすすめします）
• Stripe 以外の決済（銀行振込・コンビニ払い）や従量課金が、最初から要る方（入っていません）
• メールアドレスを変える画面や、E2E の検査と CI の設定が、最初から要る方（次の版で入れます。パスワードの再設定・退会・監査ログ・インボイスの登録番号の欄は 1.1 で入りました）

見本モードで立ち上げるまで

API キーが無くても、Supabase にも Stripe にも通信しない見本モードで全部の画面を触れます。Node.js は 20.9 以上をお使いください。

1. zip を展開したフォルダで npm ci を実行します（npm install ではなく、同梱の package-lock.json のとおりに入れます）。
2. cp .env.example .env.local で設定のファイルを作ります。STARTER_FAKE=1 のままで見本モードです。
3. npm run dev を実行し、http://localhost:3020 を開きます。
4. 「ログイン」を押し、見本の方（オーナー・管理者・メンバー）から 1 人を選んで入ります。

Node.js のバージョンは node -v で確かめられます。20.9 より古いときは、nvm などで新しい版を入れてください。

Stripe でプランを変えられない・通知が届かないとき

テストモードで一周するときに、つまずきやすいところです。

1. Stripe の「設定 → 請求 → カスタマーポータル」で、画面を有効にします。
2. 同じ画面で「プランの切り替え」を許可し、商品カタログで作った月額の価格（Price）を 2 つとも登録します。
3. お手元では stripe listen を実行し、決済のたびに --> と <-- [200] の行が並ぶことを確かめます。並ばないときは --forward-to の付け忘れです。
4. stripe trigger でテーブルが変わらないのは正しい動きです（毎回、新しいお客さまを作るためです）。

確認メールのリンクを開くとログインの画面に戻る（error=wrong_browser）ときは、登録したときと同じブラウザでリンクを開き直してください。