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/terminal-basics.md (or send Accept: text/markdown).
コマンド、ファイル、および設定
コマンドを貼り付ける場所、正しいプロジェクト フォルダーを開く方法、.env ファイルを編集する方法、サーバーを停止する方法、シークレットを共有せずにセットアップ エラーを報告する方法を学びます。
ターミナルにコマンドが入力されます
ターミナルは、コンピュータの指示を入力するウィンドウです。 Visual Studio Code で、まず [ファイル] → [フォルダーを開く] を使用して supastack フォルダーを開き、次に [ターミナル] → [新しいターミナル] を選択します。新しいターミナルはそのフォルダーで起動します。 Windows では、端末の + ボタンの横にあるメニューを使用して、PowerShell を選択します。 macOS または Linux ターミナルで macOS/Linux ブロックを使用します。
コマンド ブロックの内容のみを一度に 1 つずつ貼り付けて、Enter キーを押します。周囲の Markdown バッククォート、PS C:\... などのプロンプト、または出力例を貼り付けないでください。 # で始まる行は説明です。彼らは何も実行しません。各インストール コマンドが完了するまで待ってから、次のコマンドを入力します。サーバー コマンドは実行を継続し、停止するまで新しいプロンプトを返しません。
端末がどのフォルダを使用しているかを確認する
リポジトリ ルートとは、package.json、pnpm-workspace.yaml、アプリおよびパッケージを含む最上位の supastack フォルダーを意味します。ステップに特に記載がない限り、そこでコマンドを実行します。以下のコマンドは、現在のフォルダーを出力します。ファイルのリストには package.json が表示されるはずです。 Windows PowerShell では、pwd と ls も機能します。
リストに apps/web または apps/mobile の内容のみが表示されている場合は、「cd ../..」と入力し、Enter キーを押してルートに戻ります。ホーム フォルダーが表示されている場合は、「cd」と入力し、続いてスペースとクローンへの完全パスを入力します (スペースが含まれる場合は引用符で囲みます)。通常、エディターでプロジェクト フォルダーを開いて新しいターミナルを作成する方が簡単です。
pwd
ls設定は端末ではなくファイルに保存されます
AI_PROVIDER=fake のようなブロックは設定テキストです。エディターで名前付きの .env ファイルを開き、AI_PROVIDER= で始まる行を見つけ、その値を置き換えて、Ctrl + S (macOS では Command + S) で保存します。各設定は、KEY=value 形式で 1 行を占めます。 Markdown バッククォートは追加しないでください。 1 つのファイル内で同じキーの重複コピーを避けてください。
データベース移行コマンドには root .env、Next.js Web サーバーには apps/web/.env.local、Expo には apps/mobile/.env.local を使用します。 Next と Expo は独自のアプリ フォルダー内で実行され、root .env は自動的にロードされません。データベース接続が変更された場合は、root .env と apps/web/.env.local の両方で DATABASE_URL を更新し、移行とサーバーが同じデータベースを使用できるようにします。今後の参照のために、サンプル ファイルを変更しないでください。
名前がドットで始まるファイルは、ファイル マネージャーで非表示になっている可能性があります。エディターのエクスプローラーに表示されます。ファイル名が .env.local.txt ではなく、正確に .env.local であることを確認してください。これらのローカル ファイルにはパスワードが含まれる可能性があり、Git から除外されます。これらをアップロードしたり、その内容をサポート メッセージに貼り付けたりしないでください。
サーバーを実行し続けます。コマンドには別の端末を使用する
開発サーバーは、作業中にアプリを提供します。チュートリアルで「localhost:3000 を開いてください」と表示されたら、ターミナルを開いたままにしておきます。 localhost はこのコンピュータを意味します。 :3000 は、アプリで使用される番号付きのドアのようなポートです。 URL を端末ではなくブラウザのアドレス バーに入力します。
サーバーがアクティブなときに別のコマンドを実行するには、エディターで [ターミナル] → [新しいターミナル] を選択します。新しいターミナルは、同じプロジェクトへの別のウィンドウです。サーバーを停止するには、そのターミナルを選択し、Ctrl + C を 1 回押します。 Windows では、バッチ ジョブを終了するように求められたら、「Y」と入力して Enter キーを押します。再度開始する前に、通常のプロンプトが表示されるまで待ちます。
Web環境の設定を編集した後、以下のコマンドでWebサーバーを停止し、再起動してください。通常、ソース ファイルを保存するとページが自動的に更新されますが、環境が変更された場合は再起動が必要になります。 Expo 設定を編集した後、Expo を停止し、corepack pnpm --filter @supastack/mobile start --clear を実行して再起動し、キャッシュされたバンドルをクリアします。
corepack pnpm --filter @supastack/web dev失敗を読んで役立つ助けを求める
インストール中に赤色のエラー テキストが返された場合は、そのステップで停止してください。アプリの起動を続行するのではなく、最初のエラーを読んでください。コマンドが見つからないということは、通常、ツールが見つからないことを意味します。 package.json がない場合は、通常、間違ったフォルダーを意味します。 ECONNREFUSED は通常、必要なサーバーまたはデータベースが実行されていないことを意味します。 EADDRINUSE は、別のプロセスがすでにポートを使用していることを意味します。
ヘルプを求める場合は、オペレーティング システム、ガイド URL とステップ番号、入力した正確なコマンド、および最初のエラー メッセージを含めてください。パスワード、API キー、トークン、およびデータベース URL のパスワード部分を削除します。 .env ファイルは送信しないでください。エラーのスクリーンショットは役に立ちますが、コピー可能なテキストの方が診断が簡単です。