Node.js-, Next.js- och Nuxt-applikationer.
Hur Node.js-projekt identifieras och startas: Node-version, pakethanterare, Next.js och Nuxt (server eller statiskt), SvelteKit, Astro, Express med flera, variabeln PORT och Prisma-migreringar.
Ett repo med en package.json är ett Node.js-projekt. Vi väljer ramverk, pakethanterare och Node-version, bygger och startar det – du gör bara push.
Node-version och pakethanterare
- Node.js – hämtas från
engines.nodeipackage.jsoneller från.nvmrc: den nyaste av 24, 22, 20, 18 eller 16 som passar. Utan någon av dem används Node.js 22. - Pakethanterare – efter låsfilen:
pnpm-lock.yaml→ pnpm,yarn.lock→ yarn, annars npm (npm cinär det finns enpackage-lock.json). - Bygge – skriptet
build, närpackage.jsonhar ett sådant.
Ramverk
| Ramverk | Hur det körs |
|---|---|
| Next.js | som server (next start) – serverrendering, API-routes och middleware fungerar som vanligt |
Next.js med output: 'export' | som statisk sajt från out |
| Nuxt | som server (.output/server/index.mjs) |
Nuxt med ssr: false och ett generate-skript | som statisk sajt från .output/public |
| SvelteKit | som server med adapter-node; med adapter-static som statisk sajt |
| Astro | som statisk sajt; med @astrojs/node som server |
| NestJS | dist/main.js efter bygget |
| Express, Fastify, Koa, Hono och andra servrar | filen i scripts.start (node server.js), annars main, annars server.js, app.js, index.js eller main.js |
Projekt med bara frontend – Vite, Create React App, Angular, Vue CLI med flera – serveras som statiska sajter; se Statiska sajter.
Lyssna på PORT
En server måste lyssna på porten i variabeln PORT, på alla gränssnitt:
const port = process.env.PORT || 3000
app.listen(port, '0.0.0.0')Next.js och Nuxt gör detta själva. Om din applikation lyssnar på en fast port får den inga besökare – driftsättningen stoppar då vid startkontrollen och den föregående versionen fortsätter att köras.
Värden vid byggtiden
Variabler från fliken Variabler når den körande applikationen, inte bygget. Värden som bygget skriver in i klientkoden – som NEXT_PUBLIC_… i Next.js eller VITE_… – läses från ditt repo, till exempel från en incheckad .env.production-fil. Kod på serversidan läser fliken Variabler som vanligt.
Ditt eget startkommando
Om den identifierade starten inte är vad du vill ha anger du Inställningar → Bygginställningar → Startkommando, t.ex. node dist/server.js eller npm run start:prod. Installations- och byggkommandon kan också ändras där.
Databaser och Prisma
Lägg till PostgreSQL eller MySQL i projektet och läs DATABASE_URL – den sätts åt dig. Med Prisma bland dina beroenden är det rekommenderade release-kommandot npx prisma migrate deploy: det körs vid varje driftsättning innan den nya versionen tar emot besökare. Se Driftsättningar.
För köer med BullMQ lägger du till Valkey och använder REDIS_URL. Kör köprocessen som en bakgrundsprocess – på fliken Processer, eller som en separat tjänst med egna resurser. Se Tjänster i ett projekt.
Filer som överlever en driftsättning
Varje driftsättning startar från en ny kopia av ditt repo. Filer som din applikation skriver till /data sparas mellan driftsättningar och säkerhetskopieras dagligen; allt som skrivs någon annanstans försvinner vid nästa driftsättning. För uppladdningar och media är objektlagring oftast ett bättre val.
Monorepon
För ett repo med flera projekt anger du Projektmapp när du skapar applikationen (t.ex. apps/web). En annan mapp i samma repo kan köras som en separat webbtjänst – se Tjänster i ett projekt.