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

# 始める前に

Node.js、Git、エディターをインストールし、リポジトリへの招待を受け入れ、キットをダウンロードして、コンピューターが最初の実行の準備ができていることを確認します。

## 1. 実行したいものを選択します

インターネット接続のある Windows、macOS、または Linux コンピューターを使用します。ブラウザは Web アプリを実行します。携帯電話はモバイル アプリを実行します。デスクトップ アプリが独自のウィンドウで開きます。電話機だけでは、以下のインストール手順を実行できません。

リポジトリは、GitHub を通じて受信したファイルのフォルダーです。 Web、モバイル、デスクトップの購入には、それぞれ対応するキット リポジトリが提供されます。 All Platforms バンドルは、3 つのアプリすべてを含むフォルダーである monorepo を提供します。購入したリポジトリへの招待を受け入れます。モバイルまたはデスクトップのチェックアウトには、アクセス可能な Web バックエンド、つまりアカウントとデータを処理するサーバーが必要です。これらのクライアント リポジトリには Web サーバーは含まれません。

これらの道具を一度用意しておきましょう。ツールと最初のネイティブ コンパイルのダウンロードには、5 分よりもはるかに長い時間がかかる場合があります。これらの準備の後、5 分間のガイドが始まります。ローカルで実行すると、アプリはインターネットに公開されません。


## 2.Node.jsをインストールする

以下の公式 Node.js ダウンロード ページを開きます。 LTS バージョン 22 以降を選択し、コンピューターのインストーラー (Windows の場合は .msi、macOS の場合は .pkg) を選択します。ダウンロードしたインストーラーを開き、デフォルトのままにしてインストールを完了します。 Node.js を使用すると、コンピューターでアプリの JavaScript を実行できます。 npm も一緒にインストールされます。

インストール後に端末を閉じて再度開きます。 Windows では、「スタート」を開き、「PowerShell」と入力して開きます。 macOS では、Command + Space キーを押し、「ターミナル」と入力して Enter キーを押します。 Linux では、アプリケーション メニューからターミナルを開きます。以下のコマンドを貼り付けて、Enter キーを押します。 v22.x.x や v24.x.x などの結果は、ノードが使用可能であることを確認します。 「コマンドが見つからない」または「認識されない」と表示された場合は、ターミナルを再度開くか、PATH オプションを有効にしてノードを再インストールします。

[Node.js公式インストーラー](https://nodejs.org/en/download)

```
node --version
npm --version
```


## 3. Git とテキストエディタをインストールする

以下の Git ダウンロード ページを開き、オペレーティング システムを選択して、そのインストーラーに従います。 Git はプライベート リポジトリをダウンロードし、ファイルの変更を記録します。 macOS では、以下のコマンドを実行すると、Apple のコマンドライン ツールのインストールが提供される場合があります。それを受け入れ、終了後にコマンドを再実行します。 Linux では、Git ページでディストリビューション用に示されているインストール コマンドを使用します。

公式ダウンロードページから Visual Studio Code をインストールします。これは、プロジェクトを開いて設定ファイルを保存するためのテキスト エディタです。それを開き、「ファイル」→「フォルダーを開く」(macOS の場合は「ファイル」→「開く」) を選択し、後でダウンロードした supastack フォルダーを選択します。最初のローカル デモンストレーションを完了するためにコードを記述する必要はありません。

新しく開いたターミナルで、以下のコマンドを実行します。結果が git version で始まる場合は、Git の準備ができていることを意味します。コマンドが見つからない場合は、インストーラーを終了し、ターミナルを再度開きます。

[公式 Git インストーラー](https://git-scm.com/downloads/)

[Visual Studio Code ダウンロード](https://code.visualstudio.com/download)

```
git --version
```


## 4. GitHub の招待を承諾します

購入時に指定したアカウントを使用して、ブラウザで GitHub にサインインします。 GitHub の招待メールを開き、[招待を表示してアクセスを受け入れる] を選択します。次に、招待されたリポジトリを開きます。ファイルと緑色の「コード」ボタンが表示されるはずです。 404 は通常、招待が受け入れられなかったか、別の GitHub アカウントにサインインしていることを意味します。

コード → ローカル → HTTPS を選択し、表示されたアドレスをコピーします。次のステップでその正確なアドレスを使用してください。山括弧を含むアドレスの例はテンプレートです。山括弧を貼り付けるのではなく、山括弧を置き換えます。組織名を推測したり、プライベート リポジトリを公開したりする必要はありません。


## 5. プロジェクトをコンピュータにダウンロードします。

プロジェクト用のフォルダー (Documents など) を選択します。ファイル エクスプローラーまたは Finder でそのフォルダーを開きます。 Windows では、空の領域を右クリックして [ターミナルで開く] を選択し、必要に応じて [PowerShell] を選択します。 macOS ではターミナルを開き、「cd」と入力してからスペースを入力し、フォルダーをターミナルにドラッグして Enter キーを押します。ターミナルはそのフォルダー内で動作するようになりました。

以下の最初のコマンドで、YOUR_COPIED_HTTPS_ADDRESS をコピーした HTTPS アドレスに置き換えます。一度に 1 行ずつ実行します。最初の行では、supastack という名前の新しいフォルダーを作成します。 2行目がそれに入ります。 Git でサインインを求められた場合は、ブラウザーのサインインを完了します。 GitHub アカウントのパスワードを Git パスワードとして使用しないでください。ブラウザーのサインインが利用できない場合は、以下にリンクされている GitHub の HTTPS 認証ガイドに従ってください。

成功: supastack フォルダーには、package.json、pnpm-workspace.yaml、アプリ、およびパッケージが含まれています。これはリポジトリのルートです。 Git が宛先が既に存在すると言ったら、別の空のフォルダーを使用するか、既存のクローンを開きます。作品を削除しないでください。次のステップのためにこのターミナルを開いたままにしておきます。

[GitHub HTTPS 認証ヘルプ](https://docs.github.com/en/get-started/git-basics/about-remote-repositories)

```
git clone YOUR_COPIED_HTTPS_ADDRESS supastack
cd supastack
```


## 6. Corepack と固定されたパッケージ マネージャーを確認します。

以下の最初のコマンドを実行します。 Corepack は、package.json に記録されている pnpm バージョンを選択します。 pnpm は、プロジェクトが使用するライブラリをダウンロードします。 Corepack がそのバージョンをダウンロードする許可を求めてきた場合は、「y」と入力して Enter キーを押します。このチェックアウトは pnpm 11.19.0 をピン留めします。別のパッケージマネージャーを選択するのではなく、ピンを保持してください。

コアパックが見つからない場合は、npm install --global corepack を実行し、ターミナルを再度開き、再試行してください。 PowerShell で、npm.ps1 または corepack.ps1 スクリプトが実行できないと表示された場合は、そのコマンドに corepack.cmd pnpm install を含む npm.cmd または corepack.cmd を使用してください。コンピュータの実行ポリシーを変更する必要はありません。

フィルタリングされた初回実行コマンドは、Corepack を直接呼び出します。 corepack pnpm dev などの Turbo コマンドを使用する場合、Turbo には PATH の pnpm コマンドも必要です。以下の Windows セットアップでは、そのコマンドがユーザー書き込み可能なフォルダーに作成されます。 PATH の変更は、現在の端末にのみ適用されます。 pnpm がない場合は、新しいターミナルを開いた後、このブロックを再度実行します。 macOS/Linux では、corepack enable を実行します。権限エラーが報告される場合は、代わりにフィルターされた初回実行コマンドを使用してください。

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

```
corepack --version
corepack pnpm --version

# Windows PowerShell only, for Turbo commands:
$kitShimDir = Join-Path $env:LOCALAPPDATA 'supastack/corepack-shims'
New-Item -ItemType Directory -Path $kitShimDir -Force | Out-Null
corepack enable --install-directory $kitShimDir
$env:PATH = "$kitShimDir;$env:PATH"
```


## 7. プラットフォームで続行する

Node と Git がバージョンを表示し、Corepack が固定された pnpm を選択でき、ターミナルが package.json を含むフォルダーにあれば準備完了です。以下のチュートリアルを 1 つ選んでください。Docker は Web デモでは任意です。実際のアカウントには後でデータベースが必要になります。デスクトップには Rust とネイティブビルドツールも必要で、そのチュートリアルが起動コマンドの前に説明します。

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

[Web アプリを実行する](https://supastack.dev/ja/docs/web/ship-in-5-minutes.md)

[モバイルアプリを実行する](https://supastack.dev/ja/docs/mobile/ship-in-5-minutes.md)

[デスクトップアプリを実行する](https://supastack.dev/ja/docs/desktop/ship-in-5-minutes.md)


## 次へ

[コマンド、ファイル、および設定](https://supastack.dev/ja/docs/web/terminal-basics.md)