Desktop-overzicht

Walkthrough voor beginners

Vereisten: Lees de twee onderstaande beginnershandleidingen en voltooi de lokale installatie van het bureaublad, inclusief de vereisten voor Rust en het besturingssysteem. Het codeblok start zowel de webapp als Tauri in de monorepo; bij een kassa die alleen op een desktop werkt, gebruikt u de gefilterde opdracht alleen nadat u afzonderlijk een bereikbare webbackend hebt gestart. Tauri laadt die backend.

Korte termen: een werkruimte bestaat uit de afzonderlijke gebruikers, gegevens en instellingen van één team. De server is de vertrouwde backend; houd providersleutels uit de browser- en telefooncode. Een migratie is een versiebeheer van de database, waarbij tabellen worden gemaakt of bijgewerkt. Een AI-model is de motor die antwoord geeft; de modelcatalogus is de serverlijst met beschikbare model-ID's en prijzen. Een provider is een externe service, zoals een AI-, e-mail- of factureringsservice. Een recht is een subsidie ​​waarmee een werkruimte een functie kan gebruiken. Een webhook is een bericht dat de ene service naar de URL van een andere service verzendt.

1. Volg de lokale desktopinstallatie, open vervolgens de app in het Tauri-venster en log in op hetzelfde webaccount dat u in een browser gebruikt.

2. Bezoek een werkruimtepagina, verberg/toon het venster vanuit de lade en probeer de summon-snelkoppeling.

3. Het scherm moet overeenkomen met de webapp omdat Tauri de geconfigureerde backend laadt. Als dit leeg is, bevestig dan dat SUPASTACK_APP_URL verwijst naar een bereikbare actieve web-app.

Voor aangepaste code begint u met de meegeleverde prompts/README.md en kopieert u de dichtstbijzijnde prompt: prompts/new-app-screen.md voor een app-scherm of prompts/new-landing-page.md voor een openbare pagina. Voor server-, database- of providerwerk geeft u uw codeeragent de taak van deze handleiding en vraagt ​​u hem om AGENTS.md, .ai/PROJECT_CONTEXT.md en overeenkomende .ai/-mirrors te lezen; inspecteer de exacte bronbestanden die hier worden genoemd; maak een lijst van bestanden en controleer deze voordat u deze bewerkt; behoud van het eigendom van de werkruimte en geheimen voor de server; en laat je het verschil zien. Vertel het gewenste gedrag, invoer- en uitvoervelden, toegestane rollen, verwacht succes en fouten, en het testaccount, de provider of het apparaat. Gebruik voorbeeldwaarden; plak nooit een echt geheim.

• Voordat u begint
• Basisbeginselen van de terminal
• Lokale installatie op het bureaublad
• Agentprompts en projectgeheugen

# Monorepo: start the web app and desktop shell together
corepack pnpm dev:desktop

# Desktop-only checkout: start Tauri after a web backend is already reachable
corepack pnpm --filter @supastack/desktop dev

Eén product-UI, een native shell

apps/desktop is een Tauri-webweergave via uw webapp. Het deelt de product-UI, authenticatie en chat met internet; native venster-/ladegedrag leeft in src-tauri/src/lib.rs. Het heeft een bereikbare webbackend nodig en bundelt geen onafhankelijke productinterface.

Gebruik de native shell-functies

De shell wordt geleverd met een traymenu, close-to-tray, single-instance focus, global summon-sneltoets, native navigatie-/weergavemenu's, externe links in de systeembrowser, supastack:// deep-link summon, onthouden vensterstatus en een offline Retry-overlay.

SUPASTACK_APP_URL kiest de backend: geldige runtime-waarde, daarna compile-time-waarde, daarna localhost. SUPASTACK_DESKTOP_HOTKEY overschrijft CmdOrCtrl+Shift+Space. Ondertekende release-builds injecteren SUPASTACK_UPDATER_ENDPOINT en SUPASTACK_UPDATER_PUBKEY; wanneer het endpoint-pad {{channel}} bevat, schakelt het app-menu Beta Updates in (stable vs. beta, tijdens runtime te overschrijven met SUPASTACK_UPDATE_CHANNEL).

Kies uw bureaubladpad

Voer web en desktop samen uit voor lokaal werk en bouw en verifieer vervolgens het oorspronkelijke doel met de platformvereisten. Winkelondertekening, installatieprogramma's en fysiek desktopgedrag vereisen afzonderlijke acceptatie.

• Tauri-bureaublad in 5 minuten instellen
• Venster-, lade- en sneltoetsgedrag
• Desktopbuilds en distributie

Een webviewshell, geen tweede app

apps/desktop is een Tauri 2.x-shell. De Rust-kern in src-tauri bezit het venster, de systeemtray en de globale sneltoets, terwijl een webview de webapp laadt. Interface, authenticatie, billing en AI komen uit dezelfde Next.js-codebase — het desktopoppervlak voegt aanwezigheid toe, geen parallel product.

De shell bevat een placeholderpagina in apps/desktop/ui die wordt getoond terwijl de webapp laadt, zodat een koude start nooit een leeg venster toont.

Richt de shell op een deployment

Het vensterdoel wordt in volgorde opgelost: een SUPASTACK_APP_URL op runtime, daarna SUPASTACK_APP_URL op compile-time, daarna http://localhost:3000. Alleen http- en https-URL's worden geaccepteerd — lege of niet-webwaarden vallen terug op de volgende kandidaat.

Voor ontwikkeling betekent dit dat de shell zich hecht aan welk corepack pnpm dev ook bedient. Voor productie stelt u de variabele tijdens het bouwen in op bake in uw geïmplementeerde web-app.

Secrets blijven server-side

De shell draagt geen provider-credentials. De webview praat met hetzelfde geauthenticeerde API-oppervlak als een browser — providersleutels, sessiesecrets en billingconfiguratie blijven op de server.

De bundelidentifier com.supastack.desktop en de standaard capability-set (core:default) houden de webview gesandboxt; verruim permissies in src-tauri/capabilities alleen als een native feature ze nodig heeft.