> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# 5 分で公開

正確な Windows および macOS コマンドを使用して、有料のプロバイダー資格情報を使用せず、実際のデータベースにバックアップされたアカウントへの明確なパスを使用して、コンピューター上で Web デモを実行します。

## 1. コンピュータを準備し、プロジェクトを開きます

まず「始める前に」を完了してください：GitHub の招待を承認し、Node.js 22 以降、Git、エディター、Corepack をインストールしてから、Web リポジトリまたは All Platforms モノレポをクローンします。エディターで supastack フォルダーを開き、「ターミナル」→「新しいターミナル」を選択します。エディターの最上位ファイルリストに package.json が表示されるはずです。以下のすべてのコマンドは、このリポジトリルートから実行します。

これにより、AI・課金・メールのプロバイダーのアカウントや Docker なしでローカルデモが開始されます。初回の依存関係ダウンロードには余分な時間を見込んでください。次の手順では Windows ブロックのみ、または macOS/Linux ブロックのみに従ってください。両方を実行しないでください。

[ツールをインストールしてコードを取得する](https://supastack.dev/ja/docs/web/before-you-start.md)

[コマンドの実行方法とファイルの編集方法を学ぶ](https://supastack.dev/ja/docs/web/terminal-basics.md)

[またはエージェントにセットアップを実行させる](https://supastack.dev/ja/docs/web/agent-setup.md)


## 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 install
```


## 2. 構成ファイルの作成 — 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 install
```


## 3. 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 dev
```


## 4. アプリを開き、ローカル タスクを 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; で検査できます。モバイル サインインでも、デモンストレーション セッションではなく、このデータベースに基づく認証が使用されます。

[Postgres と永続アカウントを追加](https://supastack.dev/ja/docs/web/database.md)


## 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 を開きます。自動受け入れコマンドは、この初回実行のウォークスルーよりも時間がかかります。これらはワークスペース コマンドの下にあります。

[初回実行時のエラーを修正](https://supastack.dev/ja/docs/web/troubleshooting.md)

[製品名を変更してコピー](https://supastack.dev/ja/docs/web/marketing-site.md)


設定を続けるには、[データベースのセットアップ](https://supastack.dev/ja/docs/web/setup-database.md)をご覧ください。


## 次へ

[技術スタック](https://supastack.dev/ja/docs/web/tech-stack.md)