Aan de slag

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.

3 MIN LEESTIJD

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.node in package.json of 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 ci als er een package-lock.json is).
  • Build — het script build, als package.json er een heeft.

Frameworks

FrameworkHoe het draait
Next.jsals server (next start) — server-side rendering, API-routes en middleware werken zoals gewoonlijk
Next.js met output: 'export'als statische site vanuit out
Nuxtals server (.output/server/index.mjs)
Nuxt met ssr: false en een script generateals statische site vanuit .output/public
SvelteKitals server met adapter-node; met adapter-static als statische site
Astroals statische site; met @astrojs/node als server
NestJSdist/main.js na de build
Express, Fastify, Koa, Hono en andere servershet 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.

Kom je er niet uit?

Chat met ons — de AI antwoordt meteen en een technicus komt erbij als dat nodig is, op elk moment van de dag.

Contact met support