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.md (or send Accept: text/markdown).

はじめに

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

このガイドについて質問

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

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

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

共有基盤から構築する

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

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

supastack へようこそ

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

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

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

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

Node.js 22 以上が必要です。リポジトリはパッケージマネージャーを固定しています（packageManager: [email protected]）——グローバルインストールなしで、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 分で公開をご覧ください。