For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /it/docs/web/ship-in-5-minutes.md (or send Accept: text/markdown).
Pubblica in 5 minuti
Esegui la dimostrazione Web sul tuo computer con gli esatti comandi Windows e macOS, senza credenziali di provider a pagamento e un percorso chiaro verso account reali supportati da database.
1. Prepara il tuo computer e apri il progetto
Completa prima Prima di iniziare: accetta l'invito GitHub, installa Node.js 22 o più recente, Git, un editor e Corepack, poi clona il tuo repository Web o il monorepo All Platforms. Apri la cartella supastack nell'editor e seleziona Terminale → Nuovo terminale. Dovresti vedere package.json nell'elenco dei file di primo livello dell'editor. Tutti i comandi qui sotto vengono eseguiti da questa radice del repository.
Questo avvia la dimostrazione locale senza account presso provider di AI, fatturazione o email e senza Docker. Prevedi tempo extra per il primo download delle dipendenze. Nei passaggi seguenti segui solo il blocco Windows o solo il blocco macOS/Linux; non eseguirli entrambi.
2. Crea file di configurazione: macOS / Linux
Nel tuo terminale, esegui ciascuna riga seguente. La prima copia crea .env per i comandi di migrazione successivi. Il secondo crea apps/web/.env.local, che il server Web effettivamente legge. Entrambi contengono le impostazioni locali dell'esempio. Se uno dei file di destinazione esiste già, mantienilo e salta il comando di copia; non sovrascrivere le impostazioni salvate. Gli utenti Windows utilizzano invece la sezione successiva.
corepack pnpm install scarica le librerie necessarie all'app. Se Corepack chiede di scaricare pnpm, rispondi y. Attendere fino al termine e il prompt del terminale ritorna. Un messaggio Done finale senza errori indica che puoi continuare.
cp .env.example .env
cp .env.example apps/web/.env.local
corepack pnpm install2. Crea file di configurazione: Windows PowerShell
Utilizza questi comandi in PowerShell dalla cartella contenente package.json. Se .env o apps/web/.env.local esiste già, salta la riga di copia e mantieni le impostazioni. Attendere il completamento dell'installazione prima di avviare il server. Se l'esecuzione dello script è bloccata, utilizzare corepack.cmd anziché corepack come spiegato in Prima di iniziare.
Copy-Item .env.example .env
Copy-Item .env.example apps/web/.env.local
corepack pnpm install3. Avviare il server Web: lasciare aperto questo terminale
Esegui il comando seguente dalla root del repository. Avvia solo l'app Web, quindi funziona sia nel repository solo Web che nel monorepo Tutte le piattaforme. Attendi che il terminale mostri Local: http://localhost:3000 e Ready. La compilazione della prima pagina potrebbe richiedere un po' più di tempo. Il terminale dovrebbe continuare a funzionare; questo è previsto.
Nel monorepo All Platforms, corepack pnpm dev avvia insieme gli spazi di lavoro di sviluppo disponibili. Se apps/docs è presente, l'app Documenti separata utilizza http://localhost:3001.. Le guide pubbliche che stai leggendo fanno parte dell'app Web all'indirizzo http://localhost:3000/docs. Non è necessaria la porta 3001 per seguire questo tutorial.
corepack pnpm --filter @supastack/web dev4. Apri l'app e completa un'attività locale
Nella barra degli indirizzi del browser, apri http://localhost:3000 per visualizzare la home page. Quindi apri http://localhost:3000/dashboard. Mantieni il nome e l'e-mail precompilati oppure inserisci i tuoi valori di test e fai clic su Start local reference flow. Ciò crea un'area di lavoro dimostrativa in memoria; non crea un account persistente né invia un'e-mail reale.
Nella dimostrazione, apri AI task dalla barra laterale, inserisci una breve richiesta come Riepiloga i criteri di accettazione locali e fai clic su Queue local task. Quando il suo stato è in coda, fare clic su Run local task, quindi su View result. Dovresti vedere l'output completato e uno stato Email queued. La risposta dell'IA è deliberatamente falsa e ripetibile; l'e-mail in coda è locale. Il riavvio del server cancella questi dati dimostrativi.
Per utilizzare /auth per la registrazione reale, avvia prima Postgres e applica le migrazioni utilizzando la guida al database e alle migrazioni. Successivamente, i messaggi di registrazione o OTP da EMAIL_PROVIDER=local possono essere controllati su http://localhost:3000/mail-preview; e non raggiungono una casella di posta esterna. Anche l'accesso mobile utilizza questa autenticazione basata su database, anziché la sessione dimostrativa.
5. Arresta, riavvia e risolvi i problemi comuni di prima esecuzione
Il successo significa che la home page viene caricata, l'area di lavoro locale si apre e un'attività in coda viene completata. Al termine, fare clic sul terminale del server e premere Ctrl + C. Per riprendere in seguito, riaprire un terminale nella radice del repository e ripetere il comando del server dal passaggio 3; non reinstallare le dipendenze ogni volta.
Se localhost:3000 non si apre, controlla che il terminale del server sia ancora in esecuzione e mostri Ready. Se è in uso la porta 3000, arresta l'altro server di sviluppo con Ctrl + C e riprova. Se visualizzi un errore del database dopo aver aperto /auth, torna a /dashboard per la dimostrazione o completa la guida del database. Se manca la dimostrazione locale, controlla APP_ENV=local, AI_PROVIDER=fake, BILLING_PROVIDER=local, EMAIL_PROVIDER=local e JOB_PROVIDER=local in apps/web/.env.local, quindi riavvia.
Per personalizzare il nome e il testo commerciale, apri apps/web/src/marketing/site-config.ts nell'editor. Segui Branding per i campi esatti e i passaggi di verifica. Per le impostazioni dell'aspetto dell'account reale, completa prima la configurazione del database, quindi apri /settings/appearance. I comandi di accettazione automatizzata richiedono più tempo di questa procedura dettagliata di prima esecuzione; trovarli sotto Comandi dell'area di lavoro.
Per continuare la configurazione, leggi Configura il database.