Započnite

Node.js, Next.js i Nuxt aplikacije.

Kako se Node.js projekti prepoznaju i pokreću: verzija Node-a, menadžer paketa, Next.js i Nuxt (server ili statički), SvelteKit, Astro, Express i slični, promenljiva PORT i Prisma migracije.

3 MIN ČITANJA

Repozitorijum sa package.json je Node.js projekat. Mi biramo framework, menadžer paketa i verziju Node-a, gradimo ga i pokrećemo — vi samo uradite push.

Verzija Node-a i menadžer paketa

  • Node.js — uzima se iz engines.node u package.json ili iz .nvmrc: najnovija od verzija 24, 22, 20, 18 ili 16 koja odgovara. Bez oba, Node.js 22.
  • Menadžer paketa — prema lock fajlu: pnpm-lock.yaml → pnpm, yarn.lock → yarn, inače npm (npm ci kada postoji package-lock.json).
  • Gradnja — skripta build, ako je package.json ima.

Frameworci

FrameworkKako radi
Next.jskao server (next start) — renderovanje na serveru, API rute i middleware rade kao i obično
Next.js sa output: 'export'kao statički sajt iz out
Nuxtkao server (.output/server/index.mjs)
Nuxt sa ssr: false i skriptom generatekao statički sajt iz .output/public
SvelteKitkao server sa adapter-node; sa adapter-static, kao statički sajt
Astrokao statički sajt; sa @astrojs/node, kao server
NestJSdist/main.js posle gradnje
Express, Fastify, Koa, Hono i drugi serverifajl iz scripts.start (node server.js), inače main, inače server.js, app.js, index.js ili main.js

Projekti koji imaju samo front-end — Vite, Create React App, Angular, Vue CLI i drugi — služe se kao statički sajtovi; pogledajte Statički sajtovi.

Slušajte na PORT

Server mora da sluša na portu iz promenljive PORT, na svim interfejsima:

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 posetioce — deploy se tada zaustavlja na proveri pokretanja i prethodna verzija nastavlja da radi.

Vrednosti u vreme gradnje

Promenljive sa kartice Promenljive stižu do pokrenute aplikacije, a ne do gradnje. Vrednosti koje gradnja upisuje u klijentski kod — kao NEXT_PUBLIC_… u Next.js ili VITE_… — čitaju se iz vašeg repozitorijuma, na primer iz commitovanog fajla .env.production. Kod na serveru čita karticu Promenljive kao i obično.

Vaša komanda za pokretanje

Ako prepoznato pokretanje nije ono što želite, podesite Podešavanja → Podešavanja gradnje → Komanda za pokretanje, npr. node dist/server.js ili npm run start:prod. Tu se mogu promeniti i komande za instalaciju i gradnju.

Baze podataka i Prisma

Dodajte PostgreSQL ili MySQL projektu i čitajte DATABASE_URL — podešavamo je za vas. Ako je Prisma među zavisnostima, preporučena komanda izdanja je npx prisma migrate deploy: izvršava se pri svakom deployu, pre nego što nova verzija počne da prima posetioce. Pogledajte Deployi.

Za redove sa BullMQ dodajte Valkey i koristite REDIS_URL. Pokrenite queue worker kao pozadinski proces — na kartici Procesi ili kao zaseban servis sa sopstvenim resursima. Pogledajte Servisi projekta.

Fajlovi koji ostaju posle deploya

Svaki deploy počinje od sveže kopije vašeg repozitorijuma. Fajlovi koje aplikacija upisuje u /data čuvaju se između deploya i svakodnevno se kopiraju u rezervne kopije; sve upisano drugde nestaje posle sledećeg deploya. Za otpremljene fajlove i medije objektno skladište je obično bolji izbor.

Monorepozitorijumi

Za repozitorijum sa više projekata podesite Folder projekta pri pravljenju aplikacije (npr. apps/web). Drugi folder istog repozitorijuma može da radi kao zaseban veb servis — pogledajte Servisi projekta.

I dalje vam treba pomoć?

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

Kontaktirajte podršku