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.
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.nodeupackage.jsonili 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 cikada postojipackage-lock.json). - Izgradnja — skripta
build, ako jepackage.jsonima.
Frameworki
| Framework | Kako se pokreće |
|---|---|
| Next.js | kao 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 |
| Nuxt | kao server (.output/server/index.mjs) |
Nuxt s ssr: false i skriptom generate | kao statična stranica iz .output/public |
| SvelteKit | kao server s adapter-node; s adapter-static kao statična stranica |
| Astro | kao statična stranica; s @astrojs/node kao server |
| NestJS | dist/main.js nakon izgradnje |
| Express, Fastify, Koa, Hono i drugi serveri | datoteka 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.