Aplicații Node.js, Next.js și Nuxt.
Cum sunt detectate și pornite proiectele Node.js: versiunea Node, managerul de pachete, Next.js și Nuxt (server sau static), SvelteKit, Astro, Express și altele, variabila PORT și migrările Prisma.
Un repository cu package.json este un proiect Node.js. Noi alegem frameworkul, managerul de pachete și versiunea Node, îl construim și îl pornim — tu doar faci push.
Versiunea Node și managerul de pachete
- Node.js — luată din
engines.nodedinpackage.jsonsau din.nvmrc: cea mai nouă dintre 24, 22, 20, 18 sau 16 care se potrivește. Fără niciuna dintre ele, Node.js 22. - Managerul de pachete — după fișierul lock:
pnpm-lock.yaml→ pnpm,yarn.lock→ yarn, altfel npm (npm cicând există unpackage-lock.json). - Build — scriptul
build, dacăpackage.jsonare unul.
Frameworkuri
| Framework | Cum rulează |
|---|---|
| Next.js | ca server (next start) — randarea pe server, rutele API și middleware-ul funcționează ca de obicei |
Next.js cu output: 'export' | ca site static din out |
| Nuxt | ca server (.output/server/index.mjs) |
Nuxt cu ssr: false și un script generate | ca site static din .output/public |
| SvelteKit | ca server cu adapter-node; cu adapter-static, ca site static |
| Astro | ca site static; cu @astrojs/node, ca server |
| NestJS | dist/main.js după build |
| Express, Fastify, Koa, Hono și alte servere | fișierul din scripts.start (node server.js), altfel main, altfel server.js, app.js, index.js sau main.js |
Proiectele doar de front-end — Vite, Create React App, Angular, Vue CLI și altele — sunt servite ca site-uri statice; vezi Site-uri statice.
Ascultă pe PORT
Un server trebuie să asculte pe portul din variabila PORT, pe toate interfețele:
const port = process.env.PORT || 3000
app.listen(port, '0.0.0.0')Next.js și Nuxt fac asta singure. Dacă aplicația ta ascultă pe un port fix, nu va primi vizitatori — publicarea se oprește atunci la verificarea de pornire, iar versiunea anterioară continuă să ruleze.
Valori din timpul build-ului
Variabilele din fila Variabile ajung în aplicația care rulează, nu în build. Valorile pe care build-ul le scrie în codul pentru client — cum ar fi NEXT_PUBLIC_… în Next.js sau VITE_… — sunt citite din repository-ul tău, de exemplu dintr-un fișier .env.production adăugat în commit. Codul de pe server citește fila Variabile ca de obicei.
Propria comandă de pornire
Dacă pornirea detectată nu e cea pe care o vrei, setează Setări → Setări de build → Comandă de pornire, de exemplu node dist/server.js sau npm run start:prod. Tot acolo poți schimba și comenzile de instalare și de build.
Baze de date și Prisma
Adaugă PostgreSQL sau MySQL în proiect și citește DATABASE_URL — este setată pentru tine. Cu Prisma printre dependențe, comanda de lansare recomandată este npx prisma migrate deploy: rulează la fiecare publicare, înainte ca noua versiune să primească vizitatori. Vezi Publicări.
Pentru cozi cu BullMQ, adaugă Valkey și folosește REDIS_URL. Rulează workerul de coadă ca worker de fundal — în fila Procese sau ca serviciu separat, cu resurse proprii. Vezi Serviciile unui proiect.
Fișiere care rămân după o publicare
Fiecare publicare pornește de la o copie nouă a repository-ului. Fișierele pe care aplicația le scrie în /data se păstrează între publicări și au backup zilnic; orice e scris în altă parte dispare la următoarea publicare. Pentru fișiere încărcate și media, stocarea de obiecte este de obicei alegerea mai bună.
Monorepo-uri
Pentru un repository cu mai multe proiecte, setează Folder proiect când creezi aplicația (de exemplu apps/web). Un alt folder din același repository poate rula ca serviciu web separat — vezi Serviciile unui proiect.