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

# Configura la shell desktop

Indirizza la finestra verso la tua app, imposta la scorciatoia di richiamo e le preferenze della finestra, e tieni le impostazioni native fuori dal bundle web.

## Installazione e configurazione

`SUPASTACK_APP_URL` sceglie l’app web caricata dalla shell. Un valore di runtime prevale su quello di build, quindi lo stesso installer può puntare a staging; le build di produzione devono compilare un’origine HTTPS. La finestra naviga solo all’interno di quell’origine — gli altri link si aprono nel browser predefinito.

Le tre preferenze della finestra esistono anche come caselle nel menu e persistono nella directory di configurazione dell’app. `SUPASTACK_DESKTOP_HOTKEY` imposta la scorciatoia globale di richiamo, e i booleani `SUPASTACK_DESKTOP_*` sovrascrivono la scelta salvata per una singola esecuzione. Avvio minimizzato si applica alla creazione della finestra; Chiudi nella tray viene riletto a ogni chiusura.

```
SUPASTACK_APP_URL=https://app.example.com
SUPASTACK_DESKTOP_HOTKEY=CommandOrControl+Shift+Space
```


## Flusso di implementazione

`tauri.conf.json` contiene nome del prodotto, versione, identificatore, schema dei deep link, sentinella dell’updater e destinazioni del bundle. `capabilities/default.json` limita la webview ai servizi core e all’apertura di URL. Non inserire mai segreti dei provider nella shell; carica la stessa app web e il server resta il confine di fiducia.


## Verifica e risoluzione dei problemi

Avvia con un `SUPASTACK_APP_URL` di runtime e conferma che la finestra carichi quell’origine. Attiva e disattiva ogni preferenza dal menu dell’app, riavvia e controlla che la scelta salvata sopravviva. Rimuovi poi le sovrascritture d’ambiente così lo stato del menu torna autorevole.


Per continuare la configurazione, leggi [Accesso e sessioni](https://supastack.dev/it/docs/desktop/session.md).


## Successivo

[Accesso e sessioni](https://supastack.dev/it/docs/desktop/session.md)