Inizia ora

Applicazioni Node.js, Next.js e Nuxt.

Come vengono riconosciuti e avviati i progetti Node.js: versione di Node, gestore di pacchetti, Next.js e Nuxt (server o statico), SvelteKit, Astro, Express e simili, la variabile PORT e le migrazioni Prisma.

3 MIN DI LETTURA

Un repository con un package.json è un progetto Node.js. Scegliamo noi il framework, il gestore di pacchetti e la versione di Node, facciamo la build e lo avviamo: a te basta fare push.

Versione di Node e gestore di pacchetti

  • Node.js: presa da engines.node in package.json o da .nvmrc, la più recente compatibile tra 24, 22, 20, 18 e 16. Senza nessuno dei due, Node.js 22.
  • Gestore di pacchetti: in base al lock file, pnpm-lock.yaml → pnpm, yarn.lock → yarn, altrimenti npm (npm ci se c'è un package-lock.json).
  • Build: lo script build, se package.json ne ha uno.

Framework

FrameworkCome viene eseguito
Next.jscome server (next start): rendering lato server, route API e middleware funzionano come sempre
Next.js con output: 'export'come sito statico da out
Nuxtcome server (.output/server/index.mjs)
Nuxt con ssr: false e uno script generatecome sito statico da .output/public
SvelteKitcome server con adapter-node; con adapter-static, come sito statico
Astrocome sito statico; con @astrojs/node, come server
NestJSdist/main.js dopo la build
Express, Fastify, Koa, Hono e altri serveril file in scripts.start (node server.js), altrimenti main, altrimenti server.js, app.js, index.js o main.js

I progetti solo front-end (Vite, Create React App, Angular, Vue CLI e altri) vengono serviti come siti statici; vedi Siti statici.

In ascolto su PORT

Un server deve restare in ascolto sulla porta indicata nella variabile PORT, su tutte le interfacce:

const port = process.env.PORT || 3000
app.listen(port, '0.0.0.0')

Next.js e Nuxt lo fanno da soli. Se la tua applicazione ascolta su una porta fissa, non riceverà visitatori: il deploy si ferma al controllo di avvio e la versione precedente resta in esecuzione.

Valori al momento della build

Le variabili della scheda Variabili arrivano all'applicazione in esecuzione, non alla build. I valori che la build scrive nel codice client, come NEXT_PUBLIC_… in Next.js o VITE_…, vengono letti dal tuo repository, ad esempio da un file .env.production incluso nel commit. Il codice lato server legge la scheda Variabili come sempre.

Il tuo comando di avvio

Se l'avvio rilevato non è quello che vuoi, imposta Impostazioni → Impostazioni di build → Comando di avvio, ad esempio node dist/server.js o npm run start:prod. Lì puoi cambiare anche i comandi di installazione e di build.

Database e Prisma

Aggiungi PostgreSQL o MySQL al progetto e leggi DATABASE_URL: viene impostata per te. Con Prisma tra le dipendenze, il comando di rilascio consigliato è npx prisma migrate deploy: viene eseguito a ogni deploy, prima che la nuova versione riceva visitatori. Vedi Deploy.

Per le code con BullMQ, aggiungi Valkey e usa REDIS_URL. Esegui il worker della coda come worker in background, nella scheda Processi oppure come servizio separato con risorse proprie. Vedi Servizi di un progetto.

File che sopravvivono a un deploy

Ogni deploy parte da una copia pulita del tuo repository. I file che la tua applicazione scrive in /data vengono mantenuti tra un deploy e l'altro e salvati ogni giorno nel backup; tutto ciò che viene scritto altrove sparisce al deploy successivo. Per upload e file multimediali di solito l'object storage è la scelta migliore.

Monorepo

Per un repository con più progetti, imposta la Cartella del progetto quando crei l'applicazione (ad esempio apps/web). Un'altra cartella dello stesso repository può girare come servizio web separato: vedi Servizi di un progetto.

Hai ancora dubbi?

Scrivici in chat: l'AI risponde subito e un tecnico si unisce quando serve, a qualsiasi ora.

Contatta l'assistenza