Započnite

Node.js, Next.js i Nuxt aplikacije.

Kako se Node.js projekti prepoznaju i pokreću: verzija Nodea, upravitelj paketa, Next.js i Nuxt (server ili statično), SvelteKit, Astro, Express i slični, varijabla PORT i Prisma migracije.

3 MIN ČITANJA

Repozitorij s package.json je Node.js projekt. Mi biramo framework, upravitelj paketa i verziju Nodea, gradimo ga i pokrećemo — vi samo napravite push.

Verzija Nodea i upravitelj paketa

  • Node.js — preuzima se iz engines.node u package.json ili iz .nvmrc: najnovija od verzija 24, 22, 20, 18 ili 16 koja odgovara. Bez ijednog od njih, Node.js 22.
  • Upravitelj paketa — prema lock datoteci: pnpm-lock.yaml → pnpm, yarn.lock → yarn, inače npm (npm ci kada postoji package-lock.json).
  • Izgradnja — skripta build, ako je package.json ima.

Frameworki

FrameworkKako se pokreće
Next.jskao server (next start) — renderiranje na serveru, API rute i middleware rade kao i obično
Next.js s output: 'export'kao statična stranica iz out
Nuxtkao server (.output/server/index.mjs)
Nuxt s ssr: false i skriptom generatekao statična stranica iz .output/public
SvelteKitkao server s adapter-node; s adapter-static kao statična stranica
Astrokao statična stranica; s @astrojs/node kao server
NestJSdist/main.js nakon izgradnje
Express, Fastify, Koa, Hono i drugi serveridatoteka iz scripts.start (node server.js), inače main, inače server.js, app.js, index.js ili main.js

Projekti samo s front-endom — Vite, Create React App, Angular, Vue CLI i drugi — poslužuju se kao statične stranice; pogledajte Statične stranice.

Slušanje na PORT

Server mora slušati na portu iz varijable PORT, na svim sučeljima:

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

Next.js i Nuxt to rade sami. Ako vaša aplikacija sluša na fiksnom portu, neće primati posjetitelje — deploy se tada zaustavlja na provjeri pokretanja, a prethodna verzija nastavlja raditi.

Vrijednosti u vrijeme izgradnje

Varijable s kartice Varijable dolaze do pokrenute aplikacije, a ne do izgradnje. Vrijednosti koje izgradnja upisuje u klijentski kod — poput NEXT_PUBLIC_… u Next.js-u ili VITE_… — čitaju se iz vašeg repozitorija, na primjer iz commitane datoteke .env.production. Kod na serverskoj strani čita karticu Varijable kao i obično.

Vlastita naredba pokretanja

Ako prepoznato pokretanje nije ono što želite, postavite Postavke → Postavke izgradnje → Naredba pokretanja, npr. node dist/server.js ili npm run start:prod. Ondje možete promijeniti i naredbe instalacije i izgradnje.

Baze podataka i Prisma

Dodajte PostgreSQL ili MySQL projektu i čitajte DATABASE_URL — postavljamo je za vas. S Prismom među ovisnostima preporučena naredba izdanja je npx prisma migrate deploy: izvršava se pri svakom deployu prije nego što nova verzija počne primati posjetitelje. Pogledajte Deployevi.

Za redove s BullMQ dodajte Valkey i koristite REDIS_URL. Pozadinski proces za red pokrenite kao pozadinski proces — na kartici Procesi ili kao zaseban servis s vlastitim resursima. Pogledajte Servisi projekta.

Datoteke koje ostaju nakon deploya

Svaki deploy počinje od svježe kopije vašeg repozitorija. Datoteke koje vaša aplikacija zapisuje u /data čuvaju se između deployeva i svakodnevno se sigurnosno kopiraju; sve zapisano drugdje nestaje nakon sljedećeg deploya. Za prenesene datoteke i medije objektna pohrana obično je bolji izbor.

Monorepozitoriji

Za repozitorij s više projekata postavite Mapu projekta pri izradi aplikacije (npr. apps/web). Druga mapa istog repozitorija može raditi kao zaseban web servis — pogledajte Servisi projekta.

Još uvijek zapelo?

Pišite nam u chat — AI odgovara odmah, a inženjer se uključuje kad je potrebno, u bilo koje doba dana.

Kontaktirajte podršku