Kom igång

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.

3 MIN LÄSNING

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.node i package.json eller 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 ci när det finns en package-lock.json).
  • Bygge – skriptet build, när package.json har ett sådant.

Ramverk

RamverkHur det körs
Next.jssom server (next start) – serverrendering, API-routes och middleware fungerar som vanligt
Next.js med output: 'export'som statisk sajt från out
Nuxtsom server (.output/server/index.mjs)
Nuxt med ssr: false och ett generate-skriptsom statisk sajt från .output/public
SvelteKitsom server med adapter-node; med adapter-static som statisk sajt
Astrosom statisk sajt; med @astrojs/node som server
NestJSdist/main.js efter bygget
Express, Fastify, Koa, Hono och andra servrarfilen 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.

Fortfarande fast?

Chatta med oss — AI svarar direkt och en tekniker kopplas in vid behov, när som helst på dygnet.

Kontakta supporten