Checklist di deployment

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 la carica né la pubblica. Non confondere corepack pnpm --filter @supastack/web-tanstack start con il deploy: start esegue localmente la versione creata in precedenza. Eseguila 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-tanstack typecheck
corepack pnpm --filter @supastack/web-tanstack build

Prepara 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-tanstack typecheck
corepack pnpm --filter @supastack/web-tanstack test
corepack pnpm --filter @supastack/web-tanstack build

Verifica 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.