コンテンツへスキップ
supastack
ドキュメントを閲覧
WebNext.js

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/desktop/ship-in-5-minutes.md (or send Accept: text/markdown).

デスクトップアプリを5分で起動

Rust とオペレーティング システムのビルド ツールを準備し、到達可能な Web バックエンドを開始し、Tauri ウィンドウを起動して、トレイ、ショートカット、およびローカル タスクの動作を確認します。

このガイドについて質問
開くアプリ

1. 一般ツールとネイティブ ツールをインストールする

完了 開始する前に、デスクトップ リポジトリまたはすべてのプラットフォームのモノリポジトリのクローンを作成し、エディタで開きます。デスクトップは、同じ Web アプリのネイティブ ウィンドウです。アカウントやチャットの 2 番目の実装は含まれません。依存関係とネイティブ ツールがインストールされた後、5 分間の起動が始まります。初めてのインストールと Rust のコンパイルには時間がかかることがよくあります。

Windows では、以下の Tauri 前提条件リンクを使用して Microsoft C++ Build Tools をインストールします。インストーラーで [C++ によるデスクトップ開発] を選択し、Windows SDK を選択したままにして、インストールを完了します。 Microsoft Edge WebView2 ランタイムがインストールされていることを確認します。 rustup-init.exeを使用してrustup.rsからRustをインストールします。デフォルトの MSVC ツールチェーンを保持します。インストール後に端末を再度開きます。

macOS では、ターミナルで xcode-select --install を実行し、コマンドライン ツール ダイアログを完了します (インストールされていない場合)。 Rustup.rs の macOS コマンドを使用して Rust をインストールします。 Linux では、Tauri の前提条件ページに従って、実際のディストリビューションの WebKitGTK、コンパイラー、トレイ、システム ライブラリ パッケージを確認し、Rust をインストールします。 Linux パッケージ名はさまざまです。別のディストリビューションのコマンドを実行しないでください。

リポジトリ ルートでターミナルを開き、以下のバージョン チェックを実行します。 rustc と cargo の両方でバージョンを出力する必要があります。 cargo は Rust のビルド ツールです。いずれかが欠落している場合は、インストールを終了し、ターミナルを再度開いてから続行してください。

rustc --version
cargo --version
corepack pnpm install

2. Web バックエンドを開始または選択します

チェックアウトに apps/web が含まれている場合は、Web チュートリアルに従って apps/web/.env.local を作成し、以下のコマンドを使用して別の端末で Web サーバーを実行し、実行したままにしておきます。まずブラウザで http://localhost:3000 を確認してください。 /dashboard デモはデータベースなしで使用できます。 /auth での実際のサインインには、Postgres を移行する必要があります。

デスクトップのみのチェックアウトには apps/web. は含まれません。製品に提供されている個別に実行される Web バックエンドを使用し、ブラウザーでその URL を開いて動作を確認します。デスクトップ シェルはバックエンドを作成できません。そのフォルダーが存在しない場合は、以下の Web コマンドを試行しないでください。ステップ 3 では、提供されたバックエンド アドレスを選択する方法を示します。

# Only when this checkout contains apps/web:
corepack pnpm --filter @supastack/web dev

3. デスクトップウィンドウを起動します

バックエンドの実行中に、リポジトリ ルートで 2 番目のターミナルを開きます。 http://localhost:3000, のデフォルトのローカル バックエンドの場合は、以下の最初のコマンドを実行します。 Cargo はライブラリをダウンロードしてシェルをコンパイルする場合があります。 Supastack ウィンドウが開くまで待ちます。最初のビルド中にコンパイラ メッセージが表示されることが予想されます。

提供されたバックエンドの場合、以下の適切なオペレーティング システム ブロック内の https://app.example.com を実際の URL に置き換えます。プラットフォームのブロックのみを実行します。 SUPASTACK_APP_URL は端末環境設定であり、ネイティブ プロセスの開始時に読み取られます。 root .env にのみ置くとシェルは構成されません。バックエンド URL にはユーザー名やパスワードが埋め込まれないようにしてください。

「開始する前に」で説明されているように、すべてのプラットフォームのモノリポジトリでは、pnpm が PATH 上にあると、corepack pnpm dev:desktop で Web と Tauri を一緒に開始できます。以下のフィルターされたコマンドは、バックエンドが個別に実行されるデスクトップのみのチェックアウトでも機能します。

# Default local backend (all operating systems):
corepack pnpm --filter @supastack/desktop dev

# Custom backend — Windows PowerShell only:
$env:SUPASTACK_APP_URL = 'https://app.example.com'
corepack pnpm --filter @supastack/desktop dev

# Custom backend — macOS / Linux only:
SUPASTACK_APP_URL=https://app.example.com corepack pnpm --filter @supastack/desktop dev

4. ウィンドウ、トレイ、ショートカットを確認する

成功とは、ブラウザのバックエンドと同じホームページがウィンドウに表示されることを意味します。デスクトップ ウィンドウにはブラウザのアドレス バーがありません。認証情報を必要としないデモを開くには、トレイの終了アクションを使用してシェルを終了し、Web サーバーの実行中にデスクトップ ターミナルで以下のオペレーティング システムのブロックを実行します。これにより、/dashboard が直接ロードされます。そこにある Web チュートリアルのローカル タスクの手順に従います。リアル アカウントのサインインでは、ブラウザーの場合と同様に、バックエンドのデータベースを使用します。

閉じるボタンを使用してウィンドウを閉じます。アプリは終了するのではなく、トレイに隠れます。 Supastack トレイ アイコンをクリックするか、Windows/Linux では Ctrl + Shift + Space を押すか、macOS では Command + Shift + Space を押して再度表示します。終了するには、トレイの Quit アクションを使用します。開発を完全に終了するには、デスクトップ端末で Ctrl + C を押してから、バックエンド端末を停止します。

ウィンドウが空白の場合、または接続の問題が表示される場合は、まずブラウザーで構成済みの URL を開きます。バックエンドを開始するか、URL を修正してから、Tauri を再起動します。 Rust が linker.exe が見つからないと報告した場合は、Windows C++ ワークロードをインストールし、ターミナルを再度開きます。 Linux がシステム ライブラリの不足を報告した場合は、ディストリビューション固有の前提条件に従ってください。ホットキーがすでに使用されている場合は、トレイを使用し、ネイティブの動作に従ってホットキーを変更します。

これにより、ローカル開発ウィンドウが起動します。署名付きインストーラーの生成やアプリの公開は行いません。インストーラーのビルド、プラットフォームの署名、別のマシンでのテストについては、デスクトップ配布に従ってください。 Windows のコンパイルでは、macOS または Linux の動作は検証されません。

# Open the local demo — Windows PowerShell only:
$env:SUPASTACK_APP_URL = 'http://localhost:3000/dashboard'
corepack pnpm --filter @supastack/desktop dev

# Open the local demo — macOS / Linux only:
SUPASTACK_APP_URL=http://localhost:3000/dashboard corepack pnpm --filter @supastack/desktop dev

ローカルアプリURLを使う

上書きがなければTauriはhttp://localhost:3000を読み込みます。ローカルNext.jsアプリが別の到達可能なHTTP(S) originを使う場合だけSUPASTACK_APP_URLを設定します。資格情報付きやWeb以外のURLは拒否されます。

開発用bundle identifierとrelease設定は製品向けではありません。release preflightと各OSの署名は別のreleaseガイドで行います。

よくある質問

14 件の質問

supastack とは何ですか？

supastack は AI SaaS 製品を構築するためのモジュラー基盤です。共通インフラをまとめて提供するので、製品固有の機能に集中できます。

Web とモバイルに対応していますか？

はい。supastack には Web とモバイル体験の出発点として Next.js アプリと Expo アプリが含まれています。

どの認証が含まれていますか？

Better Auth がメール/パスワード、OTP、ソーシャルログインをカバーします。個人ワークスペースはアカウントと一緒にプロビジョニングされ、初日からレコードが境界内に収まります。

AI はどうサポートされていますか？

supastack には設定可能なマルチプロバイダー AI、使用量追跡、予算、暗号化された自前キー（BYOK）サポートが含まれています。

サブスクリプションはどう管理されますか？

このキット上に構築された製品では、Stripe 課金・サブスクリプション・権限が有料アクセスの基盤になります。プロバイダーの秘密はサーバー側に留まります。

製品固有のコードはどこに置きますか？

製品固有の機能は別のコードベースに置き、製品側が supastack の基本モジュールを設定・統合します。

supastack の価格は？

キットは生涯アップデート付きの一回払いです：単一フレームワーク 249 ドル（期間限定のローンチ価格 — 通常価格 349 ドルから 100 ドル割引）、または全フレームワーク（Next.js・iOS・Android）499 ドル（期間限定のローンチ価格 — 通常価格 599 ドルから 100 ドル割引）、追加開発者シート 1 席 75 ドル。キットのサブスクリプションはありません。このサイトのチェックアウトはライセンスキーをメールで配信し、GitHub 招待でリポジトリアクセスを提供します。

ワークスペースはどうデータを囲いますか？

ユーザーレコードは workspaceId でスコープされます。認証、権限、AI 使用量、課金イベント、監査エントリは個人ワークスペースの境界内に留まります。

バックグラウンドジョブはどう機能しますか？

Trigger.dev が明示的なジョブランタイムです。JobRunner コントラクトは enqueue・status・cancel のみを約束し、ワークフロー意味論は Trigger.dev 固有で明示的です。

メールとアウトリーチの違いは？

トランザクションメールはタスク完了通知などの製品ワークフローをカバーします。コールドアウトリーチやキャンペーンは製品自身に属し、このキットのメールモジュールの外です。

モバイルの購入はどのように機能しますか？

モバイルでは RevenueCat によるネイティブ購入と復元に対応し、アクセス権をサーバーで検証します。公開前にストアアカウントを設定し、実機テストを完了してください。Web 課金は別に管理します。

AI プロバイダーのキーはどこにありますか？

BYOK 認証情報は暗号化され、サーバー側に留まります。キーはログでサニタイズされ、使用量と予算はワークスペースレベルで可視です。

チェックアウトで使える支払い方法は？

Stripe ホストのチェックアウトはカードを受け付け、Stripe アカウントでウォレットを有効にすれば Alipay と WeChat Pay も提供できます——中国の購入者に便利です。ウォレット認可は非同期で確定するため、決済完了と同時にライセンスページが更新されます。

返金を受けることはできますか？

リポジトリへのアクセス権を取得した後は、supastack は永久にあなたのものとなるため、返金はできません。ですがご安心ください。生涯アップデートを含む完全なソースコードを入手し、ご自身やクライアントのために無制限にプロダクトを構築・公開できます。コードの転売や、リポジトリをスターターキットやテンプレートとして再配布することのみ禁止されています。

JA
テーマ