Start de desktopapp in 5 minuten

1. Installeer de algemene en native tools

Voltooien Voordat u begint, kloont u uw Desktop-repository of de monorepo van All Platforms en opent u deze in de editor. Desktop is een eigen venster rond dezelfde webapp. Het omvat geen tweede implementatie van accounts of chat. De lancering van vijf minuten begint nadat afhankelijkheden en native tools zijn geïnstalleerd; De eerste installatie en Rust-compilatie duren vaak langer.

Installeer op Windows Microsoft C++ Build Tools met behulp van de onderstaande Tauri-link met vereisten. Selecteer in het installatieprogramma Desktopontwikkeling met C++, laat Windows SDK geselecteerd en voltooi de installatie. Zorg ervoor dat Microsoft Edge WebView2 Runtime is geïnstalleerd. Installeer Rust vanaf rustup.rs met behulp van rustup-init.exe; behoud de standaard MSVC-toolchain. Open uw terminal opnieuw na de installatie.

Op macOS voert u xcode-select --install uit in Terminal en voltooit u het dialoogvenster met opdrachtregelhulpmiddelen als deze nog niet zijn geïnstalleerd. Installeer Rust met behulp van de macOS-opdracht van rustup.rs. Op Linux volgt u de Tauri-vereistepagina voor de WebKitGTK-, compiler-, tray- en systeembibliotheekpakketten van uw exacte distributie en installeert u vervolgens Rust. Linux-pakketnamen variëren; voer geen opdrachten van een andere distributie uit.

Open een terminal in de root van de repository en voer de onderstaande versiecontroles uit. Zowel rustc als cargo moeten versies afdrukken; cargo is de bouwtool van Rust. Als een van beide ontbreekt, voltooi dan de installatie en open de terminal opnieuw voordat u verdergaat.

• Installeer de tools en ontvang de code
• Leer hoe u een opdracht uitvoert en een bestand bewerkt
• Tauri's checklist met vereisten voor het besturingssysteem
• Officieel roest-installatieprogramma

rustc --version
cargo --version
corepack pnpm install

2. Start of kies de webbackend

Als uw kassa apps/web bevat, volgt u de webtutorial, maakt u apps/web/.env.local, voert u de webserver uit in een aparte terminal met behulp van de onderstaande opdracht en laat u deze actief. Controleer eerst http://localhost:3000 in uw browser. U kunt de /dashboard-demonstratie gebruiken zonder database; voor echte aanmelding bij /auth moet Postgres worden gemigreerd.

Een desktop-only checkout bevat geen apps/web.. Gebruik de afzonderlijk werkende webbackend die bij uw product is geleverd en open de URL in uw browser om te controleren of deze werkt. De desktopshell kan de backend niet voor u maken. Probeer de onderstaande webopdracht niet als die map ontbreekt. Stap 3 laat zien hoe u een opgegeven backend-adres kiest.

• Voer een lokale webbackend uit
• Echte accounts voorbereiden met Postgres

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

3. Start het bureaubladvenster

Open een tweede terminal in de root van de repository terwijl de backend actief blijft. Voor de standaard lokale backend op http://localhost:3000, voert u de eerste opdracht hieronder uit. Cargo kan bibliotheken downloaden en de shell compileren; wacht tot het Supastack-venster wordt geopend. Compilerberichten tijdens de eerste build worden verwacht.

Voor een meegeleverde backend vervangt u https://app.example.com in het juiste besturingssysteemblok hieronder door de daadwerkelijke URL. Voer alleen het blok van uw platform uit. SUPASTACK_APP_URL is een terminalomgevingsinstelling, die wordt gelezen wanneer het native proces start. Als u het alleen in root .env plaatst, wordt de shell niet geconfigureerd. Houd de backend URL vrij van ingebedde gebruikersnamen of wachtwoorden.

In de monorepo All Platforms kan corepack pnpm dev:desktop Web en Tauri samen starten zodra pnpm op PATH staat, zoals uitgelegd in Voordat u begint. De onderstaande gefilterde opdracht werkt ook bij kassa's die alleen op de desktop werken, waarbij de backend afzonderlijk wordt uitgevoerd.

# 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. Controleer het venster, de lade en de snelkoppeling

Succes betekent dat het venster dezelfde startpagina weergeeft als uw backend in de browser. Het bureaubladvenster heeft geen browseradresbalk. Om de demonstratie zonder referenties te openen, sluit u de shell met behulp van de actie Quit in de lade en voert u vervolgens het blok van uw besturingssysteem hieronder uit in de desktopterminal terwijl de webserver actief blijft. Dit laadt /dashboard direct; volg daar de lokale taakstappen van de webtutorial. Echte accountaanmelding maakt gebruik van de database van de backend, net als in de browser.

Sluit het venster met de sluitknop: de app zou zich in de lade moeten verbergen in plaats van afsluiten. Klik op het Supastack-pictogram in het systeemvak of druk op Ctrl + Shift + Spatiebalk op Windows/Linux, of Command + Shift + Spatiebalk op macOS, om het opnieuw weer te geven. Gebruik de actie Quit van de lade om af te sluiten. Om de ontwikkeling volledig te beëindigen, drukt u ook op Ctrl + C in de desktopterminal en stopt u vervolgens de backendterminal.

Als het venster leeg is of een verbindingsprobleem vertoont, open dan eerst de geconfigureerde URL in een browser. Start de backend of corrigeer de URL en start vervolgens Tauri opnieuw op. Als Rust meldt dat linker.exe niet is gevonden, installeert u de Windows C++-werklast en opent u de terminal opnieuw. Als Linux een ontbrekende systeembibliotheek rapporteert, volg dan de distributiespecifieke vereisten. Als de sneltoets al in gebruik is, gebruikt u de lade en volgt u Native-gedrag om deze te wijzigen.

Hiermee wordt een venster voor lokale ontwikkeling gelanceerd; het levert geen ondertekend installatieprogramma op en publiceert geen app. Volg Desktopdistributie voor het bouwen van installers, platformondertekening en testen op een andere machine. Windows-compilatie verifieert het macOS- of Linux-gedrag niet.

• Configureer het gedrag van het eigen venster en snelkoppelingen
• Bureaubladinstallatieprogramma's bouwen en verifiëren

# 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

Gebruik de lokale app-URL

Zonder override laadt Tauri http://localhost:3000. Stel SUPASTACK_APP_URL alleen in als je lokale Next.js-app een andere bereikbare HTTP(S)-origin gebruikt. URL’s met inloggegevens of zonder webprotocol worden geweigerd.

De ontwikkel-bundle-id en releaseconfiguratie zijn niet productieklaar. Gebruik de aparte releasehandleiding voor de preflight en platformondertekening.