Mulai sekarang

Aplikasi Node.js, Next.js, dan Nuxt.

Cara proyek Node.js dikenali dan dijalankan: versi Node, package manager, Next.js dan Nuxt (server atau statis), SvelteKit, Astro, Express dan sejenisnya, variabel PORT, dan migrasi Prisma.

3 MENIT BACA

Repository dengan package.json adalah proyek Node.js. Kami memilih framework, package manager, dan versi Node, lalu melakukan build dan menjalankannya — Anda cukup melakukan push.

Versi Node dan package manager

  • Node.js — diambil dari engines.node di package.json atau dari .nvmrc: versi terbaru dari 24, 22, 20, 18, atau 16 yang sesuai. Tanpa keduanya, Node.js 22.
  • Package manager — berdasarkan lock file: pnpm-lock.yaml → pnpm, yarn.lock → yarn, selain itu npm (npm ci jika ada package-lock.json).
  • Build — script build, jika package.json memilikinya.

Framework

FrameworkCara berjalan
Next.jssebagai server (next start) — server rendering, API route, dan middleware berfungsi seperti biasa
Next.js dengan output: 'export'sebagai website statis dari out
Nuxtsebagai server (.output/server/index.mjs)
Nuxt dengan ssr: false dan script generatesebagai website statis dari .output/public
SvelteKitsebagai server dengan adapter-node; dengan adapter-static, sebagai website statis
Astrosebagai website statis; dengan @astrojs/node, sebagai server
NestJSdist/main.js setelah build
Express, Fastify, Koa, Hono dan server lainnyafile di scripts.start (node server.js), jika tidak ada main, jika tidak ada server.js, app.js, index.js, atau main.js

Proyek yang hanya front-end — Vite, Create React App, Angular, Vue CLI, dan lainnya — dijalankan sebagai website statis; lihat Website statis.

Listen di PORT

Server harus listen di port pada variabel PORT, di semua interface:

const port = process.env.PORT || 3000
app.listen(port, '0.0.0.0')

Next.js dan Nuxt melakukannya sendiri. Jika aplikasi Anda listen di port tetap, aplikasi tidak akan menerima pengunjung — deploy akan berhenti pada pemeriksaan start dan versi sebelumnya tetap berjalan.

Nilai saat build

Variabel dari tab Variabel sampai ke aplikasi yang berjalan, bukan ke proses build. Nilai yang ditulis build ke kode client — seperti NEXT_PUBLIC_… di Next.js atau VITE_… — dibaca dari repository Anda, misalnya dari file .env.production yang di-commit. Kode sisi server membaca tab Variabel seperti biasa.

Start command Anda sendiri

Jika cara start yang terdeteksi tidak sesuai keinginan Anda, atur Pengaturan → Pengaturan build → Start command, misalnya node dist/server.js atau npm run start:prod. Perintah install dan build juga bisa diubah di sana.

Database dan Prisma

Tambahkan PostgreSQL atau MySQL ke proyek dan baca DATABASE_URL — variabel ini sudah diatur untuk Anda. Jika Prisma ada di dependensi Anda, release command yang disarankan adalah npx prisma migrate deploy: perintah ini berjalan di setiap deploy sebelum versi baru menerima pengunjung. Lihat Deploy.

Untuk antrean dengan BullMQ, tambahkan Valkey dan gunakan REDIS_URL. Jalankan queue worker sebagai background worker — di tab Proses, atau sebagai service terpisah dengan resource sendiri. Lihat Service dalam proyek.

File yang bertahan setelah deploy

Setiap deploy dimulai dari salinan baru repository Anda. File yang ditulis aplikasi Anda ke /data disimpan di antara deploy dan di-backup setiap hari; apa pun yang ditulis di tempat lain akan hilang setelah deploy berikutnya. Untuk upload dan media, object storage biasanya pilihan yang lebih baik.

Monorepo

Untuk repository dengan beberapa proyek, atur Folder proyek saat membuat aplikasi (misalnya apps/web). Folder lain dari repository yang sama dapat berjalan sebagai web service terpisah — lihat Service dalam proyek.

Masih ada kendala?

Chat dengan kami — AI langsung menjawab dan engineer bergabung bila diperlukan, kapan saja.

Hubungi dukungan