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

Desktop in 5 Minuten starten

Bereiten Sie Rust und die Build-Tools Ihres Betriebssystems vor, starten Sie ein erreichbares Web-Backend, starten Sie das Tauri-Fenster und überprüfen Sie das Verhalten von Taskleiste, Verknüpfung und lokaler Aufgabe.

Zu dieser Anleitung fragen

1. Installieren Sie die allgemeinen und nativen Tools

Abgeschlossen Bevor Sie beginnen, klonen Sie Ihr Desktop-Repository oder All Platforms-Monorepo und öffnen Sie es im Editor. Desktop ist ein natives Fenster rund um dieselbe Web-App. Es beinhaltet keine zweite Implementierung von Konten oder Chat. Der fünfminütige Start beginnt, nachdem Abhängigkeiten und native Tools installiert wurden. Die Erstinstallation und die Rust-Kompilierung dauern oft länger.

Installieren Sie unter Windows Microsoft C++ Build Tools über den unten stehenden Link „Tauri-Voraussetzungen“. Wählen Sie im Installationsprogramm „Desktop-Entwicklung mit C++“ aus, lassen Sie Windows SDK ausgewählt und schließen Sie die Installation ab. Stellen Sie sicher, dass Microsoft Edge WebView2 Runtime installiert ist. Installieren Sie Rust von rustup.rs mit rustup-init.exe; Behalten Sie die Standard-Toolchain MSVC bei. Öffnen Sie Ihr Terminal nach der Installation erneut.

Führen Sie unter macOS xcode-select --install im Terminal aus und füllen Sie das Dialogfeld mit den Befehlszeilentools aus, wenn diese nicht installiert sind. Installieren Sie Rust mit dem macOS-Befehl von rustup.rs. Folgen Sie unter Linux der Tauri-Voraussetzungsseite für die WebKitGTK-, Compiler-, Tray- und Systembibliothekspakete Ihrer Distribution und installieren Sie dann Rust. Die Namen der Linux-Pakete variieren; Führen Sie nicht die Befehle einer anderen Distribution aus.

Öffnen Sie ein Terminal im Repository-Stammverzeichnis und führen Sie die folgenden Versionsprüfungen durch. Sowohl rustc als auch cargo müssen Versionen drucken; cargo ist das Build-Tool von Rust. Wenn eines davon fehlt, schließen Sie die Installation ab und öffnen Sie das Terminal erneut, bevor Sie fortfahren.

rustc --version
cargo --version
corepack pnpm install

2. Starten Sie das Web-Backend oder wählen Sie es aus

Wenn Ihr Checkout apps/web enthält, befolgen Sie das Web-Tutorial, erstellen Sie apps/web/.env.local, führen Sie den Webserver mit dem folgenden Befehl in einem separaten Terminal aus und lassen Sie ihn laufen. Überprüfen Sie zunächst http://localhost:3000 in Ihrem Browser. Sie können die /dashboard-Demonstration ohne Datenbank verwenden; Die echte Anmeldung unter /auth muss migriert werden Postgres.

Eine reine Desktop-Kaufabwicklung enthält kein apps/web.. Verwenden Sie das separat laufende Web-Backend, das für Ihr Produkt bereitgestellt wird, und öffnen Sie dessen URL in Ihrem Browser, um zu bestätigen, dass es funktioniert. Die Desktop-Shell kann das Backend nicht für Sie erstellen. Versuchen Sie nicht den Web-Befehl unten, wenn dieser Ordner nicht vorhanden ist. Schritt 3 zeigt, wie Sie eine bereitgestellte Backend-Adresse auswählen.

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

3. Starten Sie das Desktop-Fenster

Öffnen Sie ein zweites Terminal im Repository-Stammverzeichnis, während das Backend weiter ausgeführt wird. Führen Sie für das standardmäßige lokale Backend unter http://localhost:3000, den ersten Befehl unten aus. Cargo kann Bibliotheken herunterladen und die Shell kompilieren; Warten Sie, bis sich das Supastack-Fenster öffnet. Es werden Compilermeldungen während des ersten Builds erwartet.

Ersetzen Sie für ein bereitgestelltes Backend https://app.example.com im entsprechenden Betriebssystemblock unten durch das tatsächliche URL. Führen Sie nur den Block Ihrer Plattform aus. SUPASTACK_APP_URL ist eine Terminalumgebungseinstellung, die gelesen wird, wenn der native Prozess startet. Wenn Sie es nur in root .env ablegen, wird die Shell nicht konfiguriert. Halten Sie das Backend URL frei von eingebetteten Benutzernamen oder Passwörtern.

Im Monorepo „Alle Plattformen“ kann corepack pnpm dev:desktop Web und Tauri gemeinsam starten, sobald pnpm auf PATH ist, wie unter „Vor dem Start“ erläutert. Der folgende gefilterte Befehl funktioniert auch bei reinen Desktop-Checkouts, wobei das Backend separat ausgeführt wird.

# 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. Überprüfen Sie das Fenster, die Taskleiste und die Verknüpfung

Erfolg bedeutet, dass das Fenster dieselbe Startseite wie Ihr Backend im Browser anzeigt. Das Desktop-Fenster verfügt über keine Browser-Adressleiste. Um die Demonstration ohne Anmeldeinformationen zu öffnen, beenden Sie die Shell mit der Aktion „Beenden“ in der Taskleiste und führen Sie dann den Block Ihres Betriebssystems unten im Desktop-Terminal aus, während der Webserver weiter ausgeführt wird. Dadurch wird /dashboard direkt geladen; Befolgen Sie dort die lokalen Aufgabenschritte des Web-Tutorials. Bei der Anmeldung mit einem echten Konto wird wie im Browser die Datenbank des Backends verwendet.

Schließen Sie das Fenster mit der Schließen-Schaltfläche: Die App sollte in der Taskleiste ausgeblendet und nicht beendet werden. Klicken Sie auf das Supastack-Tray-Symbol oder drücken Sie Strg + Umschalt + Leertaste unter Windows/Linux oder Befehl + Umschalt + Leertaste unter macOS, um es erneut anzuzeigen. Verwenden Sie zum Beenden die Beenden-Aktion des Fachs. Um die Entwicklung vollständig zu beenden, drücken Sie außerdem Strg + C im Desktop-Terminal und stoppen Sie dann das Backend-Terminal.

Wenn das Fenster leer ist oder ein Verbindungsproblem anzeigt, öffnen Sie zunächst das konfigurierte URL in einem Browser. Starten Sie das Backend oder korrigieren Sie URL und starten Sie dann Tauri neu. Wenn Rust meldet, dass linker.exe nicht gefunden wurde, installieren Sie den Windows C++-Workload und öffnen Sie das Terminal erneut. Wenn Linux eine fehlende Systembibliothek meldet, befolgen Sie die verteilungsspezifischen Voraussetzungen. Wenn der Hotkey bereits belegt ist, verwenden Sie die Taskleiste und folgen Sie dem nativen Verhalten, um ihn zu ändern.

Dadurch wird ein lokales Entwicklungsfenster geöffnet. Es wird kein signiertes Installationsprogramm erstellt und keine App veröffentlicht. Befolgen Sie die Desktop-Verteilung für Installer-Builds, Plattformsignaturen und Tests auf einem anderen Computer. Bei der Windows-Kompilierung wird das Verhalten von macOS oder Linux nicht überprüft.

# 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

Die lokale App-Adresse verwenden

Ohne Überschreibung lädt Tauri http://localhost:3000. Setze SUPASTACK_APP_URL nur, wenn deine lokale Next.js-App eine andere erreichbare HTTP(S)-Adresse verwendet. Adressen mit Zugangsdaten oder ohne Web-Protokoll werden abgelehnt.

Die Entwicklungs-Bundle-ID und die Release-Konfiguration sind noch keine produktionsreifen Einstellungen. Das Release-Preflight und die Plattformsignierung gehören in die separate Release-Anleitung.