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/deployment.md (or send Accept: text/markdown).
Checklist di deployment
Prepara le dipendenze di produzione e verifica il flusso che intendi distribuire.
Preparare un'app pubblica in questo ordine
La distribuzione significa eseguire la tua app su un servizio di hosting in modo che altre persone possano visitarla. localhost è accessibile solo nel tuo ambiente di sviluppo. Per prima cosa completa l'accesso locale supportato dal database reale, scegli una guida di hosting di seguito, crea un database di test separato e configura le impostazioni dell'ambiente dell'host con l'effettiva app HTTPS pubblica URL. Mantieni le impostazioni dimostrative locali separate dall'app pubblica.
In un secondo terminale nella root del repository, esegui i controlli Web riportati di seguito. Una build riuscita crea una versione di produzione sul tuo computer; non lo carica né lo pubblica. Non confondere corepack pnpm --filter @supastack/web start con il deploy: start esegue localmente la versione creata in precedenza. Eseguitelo solo dopo aver arrestato il server di sviluppo sulla porta 3000.
Segui la guida dell'host scelto per i passaggi di migrazione, ambiente e avvio. Prova la registrazione, un codice e-mail, i dati dell'account salvati dopo il riavvio e una funzionalità a pagamento nella sandbox del fornitore prima dell'apertura delle vendite. Un client mobile o desktop deve puntare a questo backend HTTPS in esecuzione. Il rilascio di un'app nativa è un passaggio separato documentato nella guida alla distribuzione della relativa piattaforma.
- Distribuisci su Google Cloud
- Distribuisci su un server con Coolify
- Prepara l'accesso supportato dal database
corepack pnpm --filter @supastack/web typecheck
corepack pnpm --filter @supastack/web buildPrepara i servizi
Crea il database Postgres, applica le migrazioni del repository e inserisci la tua app pubblica URL e le impostazioni di autenticazione nella dashboard dell'hosting. Scegli un provider di fatturazione Web supportato e un provider di posta elettronica transazionale per le funzionalità che abiliti. Configura Trigger.dev quando il tuo prodotto utilizza i suoi flussi di lavoro in background; non sono necessarie tutte le integrazioni per pubblicare un'app di base.
Configura il catalogo immutabile di modelli/prezzi e la policy AI del workspace prima di accettare attività AI di produzione. Una policy di alias vuota deve lasciare quelle scelte non disponibili.
Builda e deploya l'app web
Esegui i comandi Web seguenti dalla root del repository e risolvi eventuali errori prima di continuare. typecheck controlla i tipi, test esegue i test Web e build crea file di produzione localmente. Segui la guida di hosting selezionata per caricarli ed eseguirli con le impostazioni dell'ambiente lato server. Questi comandi non distribuiscono l'app.
corepack pnpm --filter @supastack/web typecheck
corepack pnpm --filter @supastack/web test
corepack pnpm --filter @supastack/web buildVerifica le frontiere deployate
Verifica login e persistenza sul database deployato; testa l'isolamento dei workspace; conferma l'elaborazione dei webhook Stripe sandbox e i cambiamenti di permessi; ed esegui un'attività in background fino al risultato persistito e alla consegna transazionale.
Leggi docs/real-provider-smoke.md e docs/production-ai-runtime.md nel repo per il processo esplicito di accettazione dei provider. Un build riuscito o un test browser intercettato non stabilisce questi risultati esterni.