Dal prompt alla produzione: fare il deploy di un'app Next.js generata dall'IA

Il link di anteprima è il posto dove la maggior parte delle app costruite con l'IA va a morire. L'app funziona, condividi l'URL di anteprima con due amici, e tre settimane dopo il progetto è abbandonato — perché un'anteprima non è mai stata il prodotto. La produzione lo è: un URL tuo, utenti reali e un'infrastruttura che non dipende dal fatto che tu tenga aperta una scheda del browser.

La buona notizia: se il tuo builder ha generato un progetto Next.js standard, la strada verso la produzione è breve e ben asfaltata. Questa guida usa il flusso di Massvai, ma la forma vale per qualsiasi builder che ti dia codice vero.

Prima del deploy: un audit di 10 minuti

Resisti alla tentazione di fare il deploy nell'istante in cui l'anteprima sembra a posto. Controlla prima quattro cose:

1. Clicca ogni percorso che uno sconosciuto percorrerebbe. Non il percorso felice che hai testato trenta volte — quelli strani. Invia moduli vuoti. Visita una pagina di dettaglio di qualcosa che non esiste. Se l'app ha l'autenticazione, prova una pagina da disconnesso. Riferisci all'agente qualsiasi cosa si rompa; correggere prima del lancio costa un'iterazione, correggere dopo il lancio costa utenti.

2. Fai l'inventario dei tuoi segreti. Elenca ogni servizio esterno con cui l'app parla — database, provider di autenticazione, processore di pagamenti, email. Ognuno ha delle chiavi, e quelle chiavi devono vivere in variabili d'ambiente, mai nel codice. Massvai gestisce le variabili d'ambiente di progetto in modo esplicito e le inietta nei deployment; qualunque piattaforma tu usi, conferma che il codice generato legga da process.env invece di avere valori scritti in chiaro.

3. Separa i dati di test dai dati reali. Se hai costruito su un database di test o con chiavi Stripe di test, la produzione ha bisogno di valori propri. È il bug più comune del giorno del lancio: l'app funziona perfettamente con credenziali di test che non devono servire utenti reali.

4. Crea un checkpoint. Fotografa la versione esatta che stai per rilasciare. Quando continuerai a iterare la settimana prossima, vorrai uno stato notoriamente funzionante con cui confrontarti — o a cui tornare.

Passo 1: porta il codice sul tuo GitHub

Anche se il tuo builder può fare il deploy direttamente, sincronizza prima il repository sul tuo account GitHub. Conta per tre motivi: è il tuo backup, è il tuo percorso di consegna quando arriverà uno sviluppatore, ed è ciò che si collega alla pipeline di deploy basata su git di Vercel — ogni push futuro va in deploy automaticamente.

In Massvai è un flusso integrato: collega il tuo account GitHub, scegli un nome per il repo, fai il push. Verifica il risultato aprendo il repo e controllando di vedere un normale progetto Next.js — la directory app/, package.json, file TypeScript. Quello è il tuo asset.

Passo 2: fai il deploy su Vercel

Vercel è la risposta di default per l'hosting Next.js per una ragione noiosa e pratica: supporto a configurazione zero per ogni funzionalità di Next.js (server components, route API, ottimizzazione delle immagini), una CDN globale e HTTPS automatico. Il piano Hobby gratuito fa girare comodamente piccole app in produzione.

Il flusso guidato in Massvai collega il tuo account Vercel, crea il progetto, trasferisce le tue variabili d'ambiente e avvia la build. Farlo a mano è appena più difficile: importa il repo GitHub nella dashboard di Vercel, incolla le variabili d'ambiente e clicca deploy.

In entrambi i casi, la prima build è il momento della verità. Un progetto generato che compila pulito in anteprima quasi sempre compila pulito su Vercel — ma se fallisce, leggi il log: l'errore di solito è una variabile d'ambiente mancante, e il log ne farà il nome.

Passo 3: collega un dominio personalizzato

your-app.vercel.app funziona, ma un dominio vero cambia il modo in cui le persone trattano il prodotto — ed è la parte su cui i non sviluppatori si bloccano più spesso, quindi eccola per intero:

1. Compra il dominio presso qualsiasi registrar (circa 10–15 dollari all'anno per un .com).
2. Aggiungilo al tuo progetto (nelle impostazioni domini di Massvai o nella dashboard di Vercel).
3. La piattaforma ti mostra uno o due record DNS da aggiungere — tipicamente un record A o un CNAME. Incollali nel pannello DNS del tuo registrar.
4. Aspetta la propagazione — da minuti a qualche ora. I certificati HTTPS vengono emessi automaticamente una volta che i record risolvono.

Tutto qui. In nessun momento è coinvolta l'amministrazione di un server.

Passo 4: la prima settimana in produzione

Il lancio è una linea di partenza. Tre abitudini per la prima settimana:

• Osserva il comportamento reale. Aggiungi uno strumento di analytics leggero e guarda dove vanno davvero le persone — non è mai dove ti aspettavi. Diventa la tua roadmap di iterazione.
• Continua a rilasciare in piccolo. Con GitHub collegato a Vercel, ogni modifica sincronizzata va in deploy automaticamente. Il tempo tra "un utente lo ha segnalato" e "è corretto in produzione" può essere sotto l'ora, e quella velocità è il tuo più grande vantaggio sui concorrenti affermati.
• Fai rollback senza vergogna. Deploy sbagliato? Vercel tiene ogni deployment precedente a un clic di distanza, e i checkpoint del tuo builder ti danno la stessa rete di sicurezza a livello di codice. Il costo di un errore sono minuti, quindi osa.

La parte che conta davvero

Nessuno di questi passi richiede più competenze ingegneristiche — è questo il cambiamento portato dagli AI app builder. Quello che non possono fare è mettere la cosa davanti alle persone al posto tuo. L'app nella tua scheda di anteprima vale esattamente zero finché qualcun altro non la usa. Falle il deploy questa settimana.