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/before-you-start.md (or send Accept: text/markdown).
始める前に
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 --version
npm --version3. Git とテキストエディタをインストールする
以下の Git ダウンロード ページを開き、オペレーティング システムを選択して、そのインストーラーに従います。 Git はプライベート リポジトリをダウンロードし、ファイルの変更を記録します。 macOS では、以下のコマンドを実行すると、Apple のコマンドライン ツールのインストールが提供される場合があります。それを受け入れ、終了後にコマンドを再実行します。 Linux では、Git ページでディストリビューション用に示されているインストール コマンドを使用します。
公式ダウンロードページから Visual Studio Code をインストールします。これは、プロジェクトを開いて設定ファイルを保存するためのテキスト エディタです。それを開き、「ファイル」→「フォルダーを開く」(macOS の場合は「ファイル」→「開く」) を選択し、後でダウンロードした supastack フォルダーを選択します。最初のローカル デモンストレーションを完了するためにコードを記述する必要はありません。
新しく開いたターミナルで、以下のコマンドを実行します。結果が git version で始まる場合は、Git の準備ができていることを意味します。コマンドが見つからない場合は、インストーラーを終了し、ターミナルを再度開きます。
git --version4. 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 が宛先が既に存在すると言ったら、別の空のフォルダーを使用するか、既存のクローンを開きます。作品を削除しないでください。次のステップのためにこのターミナルを開いたままにしておきます。
git clone YOUR_COPIED_HTTPS_ADDRESS supastack
cd supastack6. 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 を実行します。権限エラーが報告される場合は、代わりにフィルターされた初回実行コマンドを使用してください。
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 とネイティブビルドツールも必要で、そのチュートリアルが起動コマンドの前に説明します。