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

# Flusso di onboarding

Il percorso con gate dal sign-up a un workspace e piano attivi.

## Prima di iniziare

Apri il progetto supastack scaricato in Visual Studio Code utilizzando File → Apri cartella, quindi scegli Terminale → Nuovo terminale. La radice del repository è la cartella contenente package.json, app e pacchetti. Esegui il comando qui sotto e lascia il suo terminale aperto. Se un comando non viene riconosciuto, completare la guida all'installazione dello strumento prima di continuare.

Leggi prima il tutorial sulla piattaforma. Un server è il processo dell'app che risponde alle richieste del browser o del telefono. Il Web legge apps/web/.env.local, Expo legge apps/mobile/.env.local e i comandi di migrazione del database leggono root .env. La dimostrazione senza database/dashboard è separata dagli account reali/auth, che necessitano della migrazione Postgres. Un pagamento solo telefonico o desktop richiede un backend Web eseguito separatamente.

[Installa gli strumenti e ottieni il codice](https://supastack.dev/it/docs/web/before-you-start.md)

[Impara comandi, file e configurazione](https://supastack.dev/it/docs/web/terminal-basics.md)

[Completa il tutorial di prima esecuzione sul Web](https://supastack.dev/it/docs/web/ship-in-5-minutes.md)

```
corepack pnpm --filter @supastack/web dev
```


## Installazione e configurazione

Dopo il sign-up, i gate di onboarding guidano l'utente nella configurazione del workspace prima del lavoro di prodotto: /onboarding, /new-organization, /select-organization e /choose-plan. Il modulo di onboarding dell'organizzazione decide quale passo si applica in base allo stato attuale del membro.

Il flusso è riprendibile — ogni gate ricalcola il passo corretto lato server, quindi un utente che esce a metà atterra sulla schermata giusta al ritorno.

```
/onboarding            entry gate
/new-organization     create a team workspace
/select-organization  pick an existing one
/choose-plan          plan selection before billing
/invite/[token]       invited members join here
```


## Flusso di implementazione

Tratta ogni passo come un gate, non una pagina di wizard — il server valuta lo stato e reindirizza al passo successivo richiesto. I membri invitati saltano la creazione e atterrano su accept-invite.

Quando aggiungi un gate di prodotto — un campo profilo obbligatorio, un'accettazione dei termini — estendi la valutazione di onboarding invece di spargere redirect nei layout.


## Verifica e risoluzione dei problemi

Testa un account nuovo in ogni passo, un utente che ritorna a metà flusso, un membro invitato e un membro di più organizzazioni. Verifica che nessun passo renderizzi la shell dell'app prima che il suo gate passi.


## Successivo

[Pagamenti e abbonamenti](https://supastack.dev/it/docs/web/billing.md)