Mulai di lokal

Sebelum mulai

Gunakan versi Bun yang tercatat pada package.json, yaitu bun@1.3.14. Deployment memakai Node.js 24 dan Next.js 16.2.11.

Lingkungan lokal

Salin .env.example ke .env. Git mengabaikan file ini, jadi jangan isi dengan kredensial production. Prisma CLI membaca LOCAL_DATABASE_URL; aplikasi membaca DATABASE_URL. Keduanya harus menunjuk ke file:./dev.db untuk setup lokal. Database file tidak memerlukan token remote.

bun install --frozen-lockfile
bun run db:setup
bun run dev

db:setup menerapkan migrasi, membuat Prisma Client, lalu mengisi data contoh. Jalankan hanya pada database lokal atau demo yang disiapkan untuk itu. Sebelum membuka Next.js, dev mengompilasi pesan Paraglide.

Upload memerlukan Vercel Blob privat. Jika Blob belum dikonfigurasi, server menolak penyimpanan. Lihat penyimpanan file.

Periksa dan jalankan build lokal

bun run typecheck
bun run lint
bun run test:unit
bun run test:database
bun run build
bun run start

build membuat Prisma Client, mengompilasi Paraglide, lalu menyusun aplikasi untuk production. start menjalankan hasilnya. Pengujian database memakai tmp/test.db; pastikan target database benar sebelum menjalankan seed manual.

Untuk pengujian browser, selesaikan build lalu jalankan bun run test:e2e. Konfigurasi menjalankan server production pada port 3100, kecuali PLAYWRIGHT_BASE_URL menunjuk ke server lain. Lihat pengujian untuk detail Chromium dan isolasi data.

Preview dan production memakai Vercel.