Flusso di onboarding

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-tanstack/.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 checkout solo telefono o desktop richiede un backend Web eseguito separatamente.

• Installa gli strumenti e ottieni il codice
• Impara comandi, file e configurazione
• Completa il tutorial di prima esecuzione sul Web

corepack pnpm --filter @supastack/web-tanstack 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.