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