> ## 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 # Panoramica desktop Una shell webview Tauri attorno alla stessa web app — presenza, non un secondo prodotto. ## Procedura dettagliata per principianti Prerequisiti: leggi le due guide per principianti di seguito e completa la configurazione locale del desktop, inclusi i prerequisiti di Rust e del sistema operativo. Il blocco di codice avvia sia l'app Web che Tauri nel monorepo; in un checkout solo su desktop, utilizza il comando filtrato solo dopo aver avviato separatamente un backend Web raggiungibile. Tauri carica quel backend. Termini rapidi: uno spazio di lavoro è costituito da utenti, dati e impostazioni separati di un team. Il server è il backend affidabile; mantenere le chiavi del provider fuori dal browser e dal codice del telefono. Una migrazione è una modifica del database con versione che crea o aggiorna tabelle. Un modello AI è il motore che risponde; il catalogo dei modelli è l'elenco del server degli ID e dei prezzi dei modelli disponibili. Un fornitore è un servizio esterno come un servizio di intelligenza artificiale, posta elettronica o fatturazione. Un diritto è una concessione che consente a un'area di lavoro di utilizzare una funzionalità. Un webhook è un messaggio che un servizio invia allo URL di un altro servizio. 1. Segui la configurazione locale del desktop, quindi apri l'app nella finestra Tauri e accedi allo stesso account Web che utilizzi in un browser. 2. Visita una pagina dell'area di lavoro, nascondi/mostra la finestra dal vassoio e prova la scorciatoia di convocazione. 3. La schermata deve corrispondere all'app Web perché Tauri carica il backend configurato. Se è vuoto, verificare che `SUPASTACK_APP_URL` punti a un'app Web in esecuzione raggiungibile. Per il codice personalizzato, inizia con `prompts/README.md` in dotazione e copia il prompt più vicino: `prompts/new-app-screen.md` per la schermata di un'app o `prompts/new-landing-page.md` per una pagina pubblica. Per il lavoro su server, database o provider, assegna al tuo agente di codifica il compito di questa guida e chiedigli di leggere `AGENTS.md`, `.ai/PROJECT_CONTEXT.md` e i mirror `.ai/` corrispondenti; controllare gli esatti file sorgente nominati qui; elencare file e controlli prima della modifica; preservare la proprietà dello spazio di lavoro e i segreti solo del server; e mostrarti la differenza. Indicagli il comportamento desiderato, i campi di input e output, i ruoli consentiti, i successi e gli errori previsti e l'account, il fornitore o il dispositivo di prova. Utilizzare valori campione; non incollare mai un vero segreto. [Prima di iniziare](https://supastack.dev/it/docs/web/before-you-start.md) [Nozioni di base sui terminali](https://supastack.dev/it/docs/web/terminal-basics.md) [Configurazione locale del desktop](https://supastack.dev/it/docs/desktop/ship-in-5-minutes.md) [Messaggi dell'agente e memoria del progetto](https://supastack.dev/it/docs/web/agents.md) ``` # 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 ``` ## Un'interfaccia utente del prodotto, una shell nativa `apps/desktop` è una visualizzazione web Tauri sulla tua app web. Condivide l'interfaccia utente del prodotto, l'autenticazione e la chat con il web; il comportamento nativo della finestra/vassoio è presente in `src-tauri/src/lib.rs`. Richiede un backend web raggiungibile e non include un'interfaccia di prodotto indipendente. ## Utilizza le funzionalità native della shell La shell fornisce un menu nel vassoio, chiusura nel vassoio, focus a istanza singola, tasto di scelta rapida di evocazione globale, menu di navigazione/visualizzazione nativi, collegamenti esterni nel browser di sistema, evocazione di collegamento profondo `supastack://`, stato della finestra ricordato e un overlay di ripetizione offline. `SUPASTACK_APP_URL` sceglie il backend: valore runtime valido, poi valore di compilazione, infine localhost. `SUPASTACK_DESKTOP_HOTKEY` sostituisce `CmdOrCtrl+Shift+Space`. Le build di rilascio firmate iniettano `SUPASTACK_UPDATER_ENDPOINT` e `SUPASTACK_UPDATER_PUBKEY`; quando il percorso dell’endpoint contiene `{{channel}}`, il menu dell’app abilita **Beta Updates** (`stable` vs `beta`, sovrascrivibile a runtime con `SUPASTACK_UPDATE_CHANNEL`). ## Scegli il percorso del desktop Esegui insieme Web e desktop per il lavoro locale, quindi crea e verifica la destinazione nativa con i prerequisiti della piattaforma. La firma del negozio, gli installatori e il comportamento del desktop fisico richiedono un'accettazione separata. [Configura il desktop Tauri in 5 minuti](https://supastack.dev/it/docs/desktop/ship-in-5-minutes.md) [Comportamento della finestra, del vassoio e dei tasti di scelta rapida](https://supastack.dev/it/docs/desktop/run.md) [Build e distribuzione desktop](https://supastack.dev/it/docs/desktop/release.md) ## Una shell webview, non una seconda app apps/desktop è una shell Tauri 2.x. Il core Rust in src-tauri possiede finestra, tray di sistema e scorciatoia globale, mentre una webview carica la web app. Interfaccia, autenticazione, billing e AI arrivano dalla stessa codebase Next.js — la superficie desktop aggiunge presenza, non un prodotto parallelo. La shell include una pagina placeholder in apps/desktop/ui mostrata mentre la web app si carica, così un avvio a freddo non renderizza mai una finestra vuota. ## Puntare la shell a un deployment La destinazione della finestra si risolve in ordine: la variabile d'ambiente SUPASTACK_APP_URL a runtime, poi il valore di SUPASTACK_APP_URL fissato a compile-time, poi http://localhost:3000. Sono accettati solo URL http e https — valori vuoti o non web ricadono sul candidato successivo. Per lo sviluppo ciò significa che la shell si attacca a qualunque cosa serva corepack pnpm dev. Per la produzione, imposta la variabile in fase di compilazione per inserirla nell'app Web distribuita. ## Tenere i secret lato server La shell non porta credenziali dei provider. La webview parla con la stessa superficie API autenticata di un browser, quindi chiavi dei provider, secret di sessione e configurazione billing restano sul server. L'identificatore di bundle com.supastack.desktop e l'insieme di capability predefinito (core:default) mantengono la webview in sandbox; amplia i permessi in src-tauri/capabilities solo quando una funzionalità nativa lo richiede. Per continuare la configurazione, leggi [Esecuzione e configurazione della shell](https://supastack.dev/it/docs/desktop/run.md). ## Successivo [Avvia l’app desktop in 5 minuti](https://supastack.dev/it/docs/desktop/ship-in-5-minutes.md)