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.
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.nodeupackage.jsonili 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 cikada postojipackage-lock.json). - Gradnja — skripta
build, ako jepackage.jsonima.
Frameworci
| Framework | Kako radi |
|---|---|
| Next.js | kao 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 |
| Nuxt | kao server (.output/server/index.mjs) |
Nuxt sa ssr: false i skriptom generate | kao statički sajt iz .output/public |
| SvelteKit | kao server sa adapter-node; sa adapter-static, kao statički sajt |
| Astro | kao statički sajt; sa @astrojs/node, kao server |
| NestJS | dist/main.js posle gradnje |
| Express, Fastify, Koa, Hono i drugi serveri | fajl 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.