De shell starten en configureren

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. Open apps/desktop/src-tauri/src/lib.rs; vraag uw agent om alleen het benoemde venster/lade/sneltoetsgedrag te wijzigen en de product-UI in de web-app te behouden.

2. Voer de shell uit en test close-to-tray, Quit en CmdOrCtrl+Shift+Space; test supastack:///settings/appearance?preview=1#main.

3. Het moet het bestaande venster focusseren en pad/query/fragment behouden. Als de verkeerde pagina wordt geopend, vergelijk dan de geconfigureerde oorsprong en de exacte route.

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

Houd het shell-gedrag in Rust

src-tauri/src/lib.rs creëert het hoofdwebweergavevenster van 1200×800. Sluiten verbergt het in de lade; Sluit uitgangen. Native menu's bieden Home/Terug/Vooruit/Herladen, zoom/volledig scherm en vensteracties. Bij restauratie van de raamstatus blijven de grootte/positie behouden.

Behandel links en oproep

De shell accepteert supastack://-routes en lost deze op tegen de exact geconfigureerde oorsprong van de HTTP(S)-app. supastack:///settings/appearance?preview=1#main wordt bijvoorbeeld /workspace/settings?tab=billing#plans; supastack:///auth/callback?code=... wordt toegewezen aan /auth/callback?code=.... Queryreeksen en fragmenten blijven behouden.

Opstartlinks worden toegepast voordat het eerste venster wordt weergegeven. macOS runtime-koppelingen gebruiken Tauri's on_open_url; Windows- en Linux-argumenten voor tweede exemplaren gebruiken de callback voor één exemplaar met de deep-link-functie ingeschakeld. Geldige links richten zich op en navigeren door het bestaande venster.

Alleen HTTP(S)-koppelingen zonder referenties met het exact geconfigureerde schema, de host en de effectieve poort blijven in de shell. Links zonder referenties HTTP(S), mailto: en tel: kunnen extern worden geopend; verkeerd opgemaakte links, inloggegevens, niet-ondersteunde schema's, poorten op aangepaste links en traversal-pogingen worden afgewezen. De geconfigureerde backend URL wijst ook inloggegevens af en valt terug naar de volgende geldige/standaardoorsprong.

SUPASTACK_APP_URL=https://your-app.example
SUPASTACK_DESKTOP_HOTKEY=CmdOrCtrl+Shift+Space

supastack:///settings/appearance?preview=1#main
# Opens https://your-app.example/workspace/settings?tab=billing#plans

Platformspecifiek gedrag verifiëren

De geïnjecteerde offline overlay biedt Opnieuw proberen, verbergt online en laadt de webapp opnieuw. Test focus, snelkoppelingen, menuzoom, lade en deep-link-aanroep op elk doelbesturingssysteem; eenheid URL-controles alleen bewijzen deze inheemse interacties niet.

• Desktopacceptatie

Setup en configuratie

Installeer de afhankelijkheden van de werkruimte en de Rust-toolchain plus de vereisten per besturingssysteem van Tauri (WebView2 wordt geleverd met Windows; macOS en Linux hebben hun gedocumenteerde pakketten nodig). corepack pnpm --filter @supastack/desktop dev voert tauri dev uit: het bouwt de Rust-kern, toont de tijdelijke gebruikersinterface en laadt de opgeloste app URL.

SUPASTACK_APP_URL wordt eerst tijdens runtime gelezen en valt daarna terug op de buildwaarde. Alleen HTTP(S)-URL’s zonder inloggegevens zijn geldig; anders wordt de volgende kandidaat geprobeerd. SUPASTACK_DESKTOP_HOTKEY vervangt CmdOrCtrl+Shift+Space; een ongeldige waarde valt terug op de standaard en blokkeert het starten niet.

corepack pnpm --filter @supastack/desktop dev
corepack pnpm --filter @supastack/desktop typecheck

SUPASTACK_APP_URL=https://app.example.com \
SUPASTACK_DESKTOP_HOTKEY=CmdOrCtrl+Shift+Space \
corepack pnpm --filter @supastack/desktop dev

Implementatieworkflow

Het hoofdvenster navigeert alleen binnen de exacte ingestelde origin, inclusief schema en poort. HTTP(S)-links zonder inloggegevens, mailto en tel kunnen in de systeem browser openen; andere schema’s worden geannuleerd.

Geregistreerde supastack://-links zetten pad, query en fragment om naar de ingestelde app-origin. Opstart, platformevent open-url en callback van een tweede instantie gebruiken dezelfde controle; deep links kunnen de shell niet naar een andere host sturen.

De tray en globale sneltoets tonen en focussen het enige hoofdvenster. Wordt de sneltoets niet geregistreerd, probeer dan een andere SUPASTACK_DESKTOP_HOTKEY.

Verificatie en probleemoplossing

Voer na wijzigingen in src-tauri cargo check en cargo test via de packagescripts uit. Controleer exacte-origin-navigatie, toegestane externe URL’s, supastack://-routes op de ingestelde origin, tray, sneltoets en behoud van aanmelden na herstart.