Setup Lokal

Prasyarat

• Node.js dan pnpm (lewat Corepack).
• Akses ke sebuah project Supabase (disarankan project development/ staging milik tim, bukan project produksi) untuk diisi ke environment lokal.

Langkah setup

1. Clone repo aplikasi, lalu install dependency:

   pnpm install

2. Salin berkas environment contoh dan isi nilainya:

   cp .env.example .env.local

   Isi .env.local dengan URL dan anon key dari project Supabase yang dipakai untuk pengembangan — gunakan placeholder berikut sebagai gambaran format, bukan nilai asli:

   VITE_SUPABASE_URL=https://<supabase-project-ref>.supabase.co
   VITE_SUPABASE_ANON_KEY=<anon-key-dari-project-anda>
   VITE_BACKEND_PROVIDER=supabase

3. Jalankan server pengembangan:

   pnpm dev

Quality gate lokal

Sebelum membuat pull request, jalankan gate yang sama seperti CI (lihat CI/CD):

pnpm run check
pnpm run build

Hal yang perlu diperhatikan

• Jangan pernah memasukkan SUPABASE_SERVICE_ROLE_KEY atau SUPABASE_DB_URL ke variabel berprefiks VITE_ — semua variabel VITE_* ikut ter-bundle ke kode yang dikirim ke browser.
• Jalur kompatibilitas Convex (CONVEX_DEPLOYMENT, VITE_CONVEX_URL) hanya diperlukan untuk skenario rollback — tidak wajib diisi untuk pengembangan fitur normal di atas Supabase.
• Gunakan branch feature/* dari develop; pull request ke develop harus lulus pnpm run check (lihat CI/CD).

---

Sumber: README.md, .env.example (nama variabel saja — repo aplikasi, bukan nilai), src/lib/backend-provider.ts.