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

# はじめに

supastack とは何か、何が手に入るか、動くアプリまでの道筋。

## ここから始めましょう: あなたが受け取ったもの

このキットは、カスタマイズできる開始アプリです。 Web はブラウザ インターフェイスとサーバー API です。モバイルは電話インターフェースです。デスクトップは、Web アプリを表示するネイティブ ウィンドウです。 API は、クライアントがサインインまたはデータの読み取りのために呼び出すサーバー アドレスです。共有パッケージは、これらのアプリで使用される再利用可能な部分です。

以下の Web ローカル チュートリアルから始めてください。ライブラリをダウンロードし、サーバーを起動し、偽の AI task を実行する方法を正確に説明します。次に、保存されたアカウントのデータベースを追加し、製品に必要なプロバイダーのみを選択し、ブランドをカスタマイズしてホスティングを準備します。技術的な説明は後で読むことができます。これらは、最初のデモを開くための前提条件ではありません。

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

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

[完全な Web 初回実行チュートリアルに従ってください](https://supastack.dev/ja/docs/web/ship-in-5-minutes.md)


## 共有基盤から構築する

supastack は、Web、モバイル、デスクトップ上の AI SaaS のモジュール式基盤です。 Next.js は Web UI を搭載し、API、Expo はネイティブ参照フローを提供し、Tauri デスクトップ シェルは同じ Web アプリを読み込みます。共有パッケージは、ID、ワークスペース、請求、AI、ジョブ、電子メール、ストレージ、可観測性を処理します。

ローカル参照フローから始めて、モジュールがどのように組み合わされるかを理解します。運用プロバイダーは、そのフローが環境で機能した後にのみ構成してください。


## あなたの方法を見つけてください

アプリケーションは共有パッケージを構成します。製品固有の機能は、再利用可能なコアではなく、使用する製品のコードベースに属します。

```
apps/
  web/       Next.js interface and API routes
  mobile/    Expo application
packages/
  auth/      Identity and sessions
  db/        Schema and workspace persistence
  billing/   Billing and entitlements
  ai/        Providers, routing, and usage
  jobs/      Background job contract
  email/     Transactional delivery
```


## 出発点を選択してください

5 分間のローカルセットアップから始めます。次に、各ガイドの下部にある「セットアップを続行」リンクに従い、デプロイの準備前にデータベース、認証、プラン、プロバイダーを構成します。完全なドキュメントインデックスを使って、すべての機能、プロバイダー、コンポーネント、リファレンスを見つけます。

ローカルのゴールデンパスはプロジェクトの開発環境で通過しています。時間を計測したクリーンクローンのセットアップ、実プロバイダーのスモーク、デプロイ、物理デバイスの受け入れは、別の検証手順のままです。

[5 分でローカルにセットアップ](https://supastack.dev/ja/docs/web/ship-in-5-minutes.md)

[すべてのドキュメントを参照](https://supastack.dev/ja/docs/web/project-structure.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/using-the-docs.md)


## supastack へようこそ

supastack は AI SaaS プロダクトのためのモジュラーキットです：Next.js の Web アプリ、Expo のモバイルアプリ、Tauri のデスクトップシェル。すべてが認証、課金、AI、ジョブ、メール、ストレージ、オブザーバビリティのための共有 TypeScript パッケージの上に構築されています。

購入後、キットのリポジトリ——Web、モバイル、デスクトップ——への GitHub 招待が届きます（All Platforms バンドルではモノレポ全体が配信されます）。出荷するサーフェスをクローンして、自分のものにしてください。

このドキュメントはリファレンスの羅列ではなく、ステップバイステップの道筋です：まずアプリをローカルで動かし、次にプロバイダーのセットアップページを順に進めます。各ページの最後に次のページが示されています。


## ローカルサーバーを起動する

Node.js 22 以上が必要です。リポジトリはパッケージマネージャーを固定しています（packageManager: pnpm@11.19.0）——グローバルインストールなしで、Corepack 経由で pnpm を実行してください。

1. 環境ファイルをコピーしてローカル設定を作成します。

2. ワークスペースの依存関係をインストールします。

3. 必要に応じてローカルの Postgres コンテナを起動して実際の永続化を行います——デフォルトはこれなしでも動作します。

4. 開発サーバーを起動し、http://localhost:3000 を開きます。

```
cp .env.example .env
corepack pnpm install
docker compose up -d postgres   # optional local database
corepack pnpm dev

# → http://localhost:3000
```


## .env ファイル

環境設定では、キットで使用されるローカル サービスまたはホストされたサービスを選択します。 .env.example を移行の場合は root .env にコピーし、Web サーバーの場合は apps/web/.env.local にコピーします。 Expo は apps/mobile/.env.local. を使用します。 root .env のみをコピーしても、すべてのアプリが構成されるわけではありません。

デフォルトの偽/ローカルプロバイダーには、有料の API 資格情報は必要ありません。これにより、メモリ内 /dashboard のデモンストレーションを完了できます。 /auth での実際のサインインには、依然として PostgreSQL と移行が必要です。実際のプロバイダーの場合は、Web 構成ファイル内の名前付き設定のみを変更して保存し、サーバーを停止して再起動します。 NEXT_PUBLIC_ または EXPO_PUBLIC_ 値を通じてシークレットを公開しないでください。


## 道筋を選ぶ

ここが初めてですか？「5 分で公開」が、デフォルトだけでクローンから動くアプリまでを案内します。

スマートフォンやデスクトップ向けに構築しますか？モバイルタブとデスクトップタブが Expo と Tauri のサーフェスをカバーします。アプリが起動したら、「プロバイダーのセットアップ」グループが各統合をドキュメント順に案内します。


設定を続けるには、[5 分で公開](https://supastack.dev/ja/docs/web/ship-in-5-minutes.md)をご覧ください。


## 次へ

[5 分で公開](https://supastack.dev/ja/docs/web/ship-in-5-minutes.md)