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.
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.nodedipackage.jsonatau 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 cijika adapackage-lock.json). - Build — script
build, jikapackage.jsonmemilikinya.
Framework
| Framework | Cara berjalan |
|---|---|
| Next.js | sebagai server (next start) — server rendering, API route, dan middleware berfungsi seperti biasa |
Next.js dengan output: 'export' | sebagai website statis dari out |
| Nuxt | sebagai server (.output/server/index.mjs) |
Nuxt dengan ssr: false dan script generate | sebagai website statis dari .output/public |
| SvelteKit | sebagai server dengan adapter-node; dengan adapter-static, sebagai website statis |
| Astro | sebagai website statis; dengan @astrojs/node, sebagai server |
| NestJS | dist/main.js setelah build |
| Express, Fastify, Koa, Hono dan server lainnya | file 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.