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

# デスクトップアプリを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 のビルド ツールです。いずれかが欠落している場合は、インストールを終了し、ターミナルを再度開いてから続行してください。

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

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

[Tauri のオペレーティング システム前提条件チェックリスト](https://tauri.app/start/prerequisites/)

[公式Rustインストーラー](https://rustup.rs/)

```
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 では、提供されたバックエンド アドレスを選択する方法を示します。

[ローカル Web バックエンドを実行する](https://supastack.dev/ja/docs/web/ship-in-5-minutes.md)

[Postgresでリアルアカウントを準備](https://supastack.dev/ja/docs/web/database.md)

```
# 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 の動作は検証されません。

[ネイティブ ウィンドウとショートカットの動作を構成する](https://supastack.dev/ja/docs/desktop/run.md)

[デスクトップ インストーラーの構築と検証](https://supastack.dev/ja/docs/desktop/release.md)

```
# 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ガイドで行います。


## 次へ

[shellの起動と設定](https://supastack.dev/ja/docs/desktop/run.md)