> ## 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

# Esecuzione e configurazione della shell

Avvia la shell Tauri e collegala all’app Web.

## 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. Aprire `apps/desktop/src-tauri/src/lib.rs`; chiedi al tuo agente di modificare solo il comportamento della finestra/vassoio/tasto di scelta rapida denominato e di mantenere l'interfaccia utente del prodotto nell'app Web.

2. Eseguire la shell e testare close-to-tray, Quit e `CmdOrCtrl+Shift+Space`; provare `supastack:///settings/appearance?preview=1#main`.

3. Dovrebbe focalizzare la finestra esistente e preservare il percorso/query/frammento. Se apre la pagina sbagliata, confronta l'origine configurata e il percorso esatto.

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
```


## Mantieni il comportamento della shell in Rust

`src-tauri/src/lib.rs` crea la finestra di visualizzazione web principale 1200×800. La chiusura lo nasconde al vassoio; Esci esce. I menu nativi forniscono azioni Home/Indietro/Avanti/Ricarica, zoom/schermo intero e finestra. Il ripristino dello stato della finestra preserva la dimensione/posizione.


## Gestire i collegamenti e l'evocazione

La shell accetta le rotte `supastack://` e le risolve rispetto all'esatta origine dell'app HTTP(S) configurata. Ad esempio, `supastack:///settings/appearance?preview=1#main` diventa `/workspace/settings?tab=billing#plans`; `supastack:///auth/callback?code=...` è mappato su `/auth/callback?code=...`. Le stringhe e i frammenti di query vengono conservati.

I collegamenti di avvio vengono applicati prima che venga visualizzata la prima finestra. I collegamenti runtime macOS utilizzano Tauri di `on_open_url`; Gli argomenti di seconda istanza di Windows e Linux utilizzano il callback a istanza singola con la funzionalità `deep-link` abilitata. I collegamenti validi si concentrano e navigano nella finestra esistente.

Nella shell rimangono solo i collegamenti HTTP(S) senza credenziali con lo schema, l'host e la porta effettiva configurati esattamente. I collegamenti HTTP(S), `mailto:` e `tel:` senza credenziali possono aprirsi esternamente; collegamenti non validi, credenziali, schemi non supportati, porte su collegamenti personalizzati e tentativi di attraversamento vengono rifiutati. Anche il backend configurato URL rifiuta le credenziali e torna alla successiva origine valida/predefinita.

```
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
```


## Verificare il comportamento specifico della piattaforma

L'overlay offline inserito offre Riprova, si nasconde online e ricarica l'app Web. Testare focus, scorciatoie, zoom del menu, vassoio e invocazione di deep-link su ogni sistema operativo di destinazione; i controlli dell'unità URL da soli non dimostrano tali interazioni native.

[Accettazione desktop](https://supastack.dev/it/docs/desktop/release.md)


## Installazione e configurazione

Installa le dipendenze dell'area di lavoro e la toolchain Rust oltre ai prerequisiti per sistema operativo di Tauri (WebView2 viene fornito con Windows; macOS e Linux necessitano dei relativi pacchetti documentati). corepack pnpm --filter @supastack/desktop dev esegue tauri dev: crea il core Rust, mostra l'interfaccia utente segnaposto e carica l'app risolta URL.

SUPASTACK_APP_URL viene letto prima a runtime, poi dalla build; sono accettati solo URL HTTP(S) senza credenziali, altrimenti si prova il valore successivo. SUPASTACK_DESKTOP_HOTKEY sostituisce CmdOrCtrl+Shift+Space; un valore non valido ripristina quello predefinito senza bloccare l’avvio.

```
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
```


## Flusso di implementazione

La finestra principale naviga solo nell’origin configurato esatto, schema e porta inclusi. Link HTTP(S) senza credenziali, mailto e tel possono aprirsi nel browser di sistema; gli altri schemi vengono annullati.

I link registrati supastack:// mappano percorso, query e fragment sull’origin configurato. Avvio, evento open-url della piattaforma e callback della seconda istanza applicano la stessa convalida: un deep link non può cambiare host.

Tray e scorciatoia globale mostrano e mettono a fuoco la finestra unica. Se la scorciatoia non viene registrata, prova un altro valore SUPASTACK_DESKTOP_HOTKEY.


## Verifica e risoluzione dei problemi

Dopo modifiche a src-tauri, esegui cargo check e cargo test tramite gli script del package. Verifica origin esatto, apertura dei link esterni consentiti, deep link supastack:// sul dominio configurato, tray, scorciatoia e persistenza dell’accesso dopo il riavvio.


Per continuare la configurazione, leggi [Crea gli account di rilascio desktop](https://supastack.dev/it/docs/desktop/external-accounts.md).


## Successivo

[Crea gli account di rilascio desktop](https://supastack.dev/it/docs/desktop/external-accounts.md)