Node.js-, Next.js- en Nuxt-applicaties.
Hoe Node.js-projecten worden herkend en gestart: Node-versie, pakketbeheerder, Next.js en Nuxt (als server of statisch), SvelteKit, Astro, Express en vergelijkbare frameworks, de variabele PORT en Prisma-migraties.
Een repository met een package.json is een Node.js-project. Wij kiezen het framework, de pakketbeheerder en de Node-versie, bouwen het project en starten het — jij hoeft alleen te pushen.
Node-versie en pakketbeheerder
- Node.js — gelezen uit
engines.nodeinpackage.jsonof uit.nvmrc: de nieuwste van 24, 22, 20, 18 of 16 die past. Staat geen van beide er, dan Node.js 22. - Pakketbeheerder — op basis van het lockbestand:
pnpm-lock.yaml→ pnpm,yarn.lock→ yarn, anders npm (npm cials er eenpackage-lock.jsonis). - Build — het script
build, alspackage.jsoner een heeft.
Frameworks
| Framework | Hoe het draait |
|---|---|
| Next.js | als server (next start) — server-side rendering, API-routes en middleware werken zoals gewoonlijk |
Next.js met output: 'export' | als statische site vanuit out |
| Nuxt | als server (.output/server/index.mjs) |
Nuxt met ssr: false en een script generate | als statische site vanuit .output/public |
| SvelteKit | als server met adapter-node; met adapter-static als statische site |
| Astro | als statische site; met @astrojs/node als server |
| NestJS | dist/main.js na de build |
| Express, Fastify, Koa, Hono en andere servers | het bestand uit scripts.start (node server.js), anders main, anders server.js, app.js, index.js of main.js |
Projecten met alleen een frontend — Vite, Create React App, Angular, Vue CLI en andere — worden als statische site geserveerd; zie Statische sites.
Luisteren op PORT
Een server moet luisteren op de poort uit de variabele PORT, op alle interfaces:
const port = process.env.PORT || 3000
app.listen(port, '0.0.0.0')Next.js en Nuxt doen dit zelf. Luistert je applicatie op een vaste poort, dan komen er geen bezoekers binnen — de deploy stopt dan bij de startcontrole en de vorige versie blijft draaien.
Waarden tijdens de build
Variabelen van het tabblad Variabelen komen bij de draaiende applicatie aan, niet bij de build. Waarden die de build in de clientcode schrijft — zoals NEXT_PUBLIC_… in Next.js of VITE_… — worden uit je repository gelezen, bijvoorbeeld uit een gecommit bestand .env.production. Code aan de serverkant leest het tabblad Variabelen gewoon.
Je eigen startopdracht
Is de herkende start niet wat je wilt, stel dan Instellingen → Build-instellingen → Startopdracht in, bijvoorbeeld node dist/server.js of npm run start:prod. Ook de installatie- en buildopdrachten kun je daar wijzigen.
Databases en Prisma
Voeg PostgreSQL of MySQL aan het project toe en lees DATABASE_URL — die wordt voor je ingesteld. Staat Prisma in je dependencies, dan is de aanbevolen releaseopdracht npx prisma migrate deploy: die draait bij elke deploy voordat de nieuwe versie bezoekers krijgt. Zie Deploys.
Voor wachtrijen met BullMQ voeg je Valkey toe en gebruik je REDIS_URL. Draai de queue-worker als achtergrondworker — op het tabblad Processen, of als aparte dienst met eigen resources. Zie Diensten van een project.
Bestanden die een deploy overleven
Elke deploy begint met een verse kopie van je repository. Bestanden die je applicatie naar /data schrijft, blijven tussen deploys bewaard en worden dagelijks geback-upt; alles wat ergens anders wordt weggeschreven, is na de volgende deploy weg. Voor uploads en media is objectopslag meestal de betere keuze.
Monorepo's
Bij een repository met meerdere projecten stel je bij het aanmaken van de applicatie de Projectmap in (bijvoorbeeld apps/web). Een andere map uit dezelfde repository kan als aparte webdienst draaien — zie Diensten van een project.