For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /ja/docs/web/ship-in-5-minutes.md (or send Accept: text/markdown).
5 分で公開
正確な Windows および macOS コマンドを使用して、有料のプロバイダー資格情報を使用せず、実際のデータベースにバックアップされたアカウントへの明確なパスを使用して、コンピューター上で Web デモを実行します。
1. コンピュータを準備し、プロジェクトを開きます
まず「始める前に」を完了してください：GitHub の招待を承認し、Node.js 22 以降、Git、エディター、Corepack をインストールしてから、Web リポジトリまたは All Platforms モノレポをクローンします。エディターで supastack フォルダーを開き、「ターミナル」→「新しいターミナル」を選択します。エディターの最上位ファイルリストに package.json が表示されるはずです。以下のすべてのコマンドは、このリポジトリルートから実行します。
これにより、AI・課金・メールのプロバイダーのアカウントや Docker なしでローカルデモが開始されます。初回の依存関係ダウンロードには余分な時間を見込んでください。次の手順では Windows ブロックのみ、または macOS/Linux ブロックのみに従ってください。両方を実行しないでください。
2. 設定ファイルの作成 — macOS / Linux
ターミナルで、以下の各行を実行します。最初のコピーでは、後の移行コマンド用に .env が作成されます。 2 つ目は、Web サーバーが実際に読み取る apps/web/.env.local を作成します。どちらにもサンプルのローカル設定が含まれています。いずれかの宛先ファイルがすでに存在する場合は、それを保持し、そのコピー コマンドをスキップします。保存された設定を上書きしないでください。 Windows ユーザーは代わりに次のセクションを使用します。
corepack pnpm install は、アプリに必要なライブラリをダウンロードします。 Corepack が pnpm をダウンロードするように要求した場合は、「y」と答えます。完了してターミナル プロンプトが戻るまで待ちます。エラーのない最後の Done メッセージは、続行できることを意味します。
cp .env.example .env
cp .env.example apps/web/.env.local
corepack pnpm install2. 構成ファイルの作成 — Windows PowerShell
package.json を含むフォルダーから PowerShell でこれらのコマンドを使用します。 .env または apps/web/.env.local がすでに存在する場合は、そのコピー行をスキップして設定を保持します。インストールが完了するまで待ってからサーバーを起動します。スクリプトの実行がブロックされている場合は、「始める前に」で説明されているように、corepack の代わりに corepack.cmd を使用します。
Copy-Item .env.example .env
Copy-Item .env.example apps/web/.env.local
corepack pnpm install3. Web サーバーを起動します — このターミナルを開いたままにしておきます
リポジトリのルートから以下のコマンドを実行します。これは Web アプリのみを起動するため、Web 専用リポジトリとすべてのプラットフォームのモノリポジトリの両方で機能します。端末に Local: http://localhost:3000 と Ready が表示されるまで待ちます。最初のページのコンパイルには少し時間がかかる場合があります。ターミナルは実行し続ける必要があります。それは予想されています。
すべてのプラットフォームのモノリポジトリでは、corepack pnpm dev が利用可能な開発ワークスペースを一緒に開始します。 apps/docs が存在する場合、その別のドキュメント アプリは http://localhost:3001. を使用します。 あなたが読んでいる公開ガイドは、http://localhost:3000/docs. にある Web アプリの一部です。 このチュートリアルに従うのにポート 3001 は必要ありません。
corepack pnpm --filter @supastack/web dev4. アプリを開き、ローカル タスクを 1 つ完了します
ブラウザのアドレス バーで http://localhost:3000 を開いてホームページを表示します。次に、http://localhost:3000/dashboard. を開きます。事前に入力された名前と電子メールをそのまま使用するか、独自のテスト値を入力して、Start local reference flow をクリックします。これにより、メモリ内にデモンストレーション ワークスペースが作成されます。永続的なアカウントを作成したり、実際の電子メールを送信したりすることはありません。
デモでは、サイドバーから AI task を開き、「ローカル受け入れ基準の要約」などの短いリクエストを入力して、「Queue local task」をクリックします。ステータスがキューに登録されている場合は、「Run local task」をクリックし、次に「View result」をクリックします。完了した出力と Email queued 状態が表示されるはずです。 AI の応答は意図的に偽物であり、再現可能です。キューに入れられた電子メールはローカルです。サーバーを再起動すると、このデモンストレーション データは消去されます。
実際のサインアップに /auth を使用するには、まず Postgres を起動し、データベースと移行ガイドを使用して移行を適用します。その後、EMAIL_PROVIDER=local からのサインアップまたは OTP メッセージは、外部の受信トレイに届かない http://localhost:3000/mail-preview; で検査できます。モバイル サインインでも、デモンストレーション セッションではなく、このデータベースに基づく認証が使用されます。
5. 停止、再起動、および初回実行時の一般的な問題の修正
成功とは、ホームページがロードされ、ローカル ワークスペースが開き、キューに入れられたタスクが完了することを意味します。終了したら、サーバーターミナルをクリックして Ctrl + C を押します。後で再開するには、リポジトリルートでターミナルを再度開き、手順 3 からのサーバーコマンドを繰り返します。依存関係を毎回再インストールする必要はありません。
localhost:3000 が開かない場合は、サーバー端末がまだ実行中であり、Ready が表示されていることを確認してください。ポート 3000 が使用中の場合は、Ctrl + C を使用して他の開発サーバーを停止し、再試行してください。 /auth を開いた後にデータベース エラーが表示された場合は、/dashboard に戻ってデモを行うか、データベース ガイドを完了してください。ローカルデモが表示されない場合は、apps/web/.env.local の APP_ENV=local、AI_PROVIDER=fake、BILLING_PROVIDER=local、EMAIL_PROVIDER=local、JOB_PROVIDER=local を確認して再起動してください。
名前とマーケティング テキストをカスタマイズするには、エディターで apps/web/src/marketing/site-config.ts を開きます。正確なフィールドと検証手順については、「ブランディング」に従ってください。実際のアカウントの外観設定については、まずデータベースのセットアップを完了してから、/settings/Appearance を開きます。自動受け入れコマンドは、この初回実行のウォークスルーよりも時間がかかります。これらはワークスペース コマンドの下にあります。
設定を続けるには、データベースのセットアップをご覧ください。