Langsung ke konten utama

Documentation Index

Fetch the complete documentation index at: https://belajarkoding.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Variabel dengan prefix NEXT_PUBLIC_ akan tersedia di browser. Jangan menaruh secret server-only dengan prefix itu.

​
Core app dan Supabase

VariableDipakai saatWajib?Keterangan
NEXT_PUBLIC_SUPABASE_URLAuth atau data app aktifYa, untuk auth/dataURL project Supabase
NEXT_PUBLIC_SUPABASE_PUBLISHABLE_KEYAuth atau data app aktifYa, untuk auth/dataPublishable atau anon key Supabase
SUPABASE_SERVICE_ROLE_KEYBilling, admin, avatar, webhook, audit, persistent rate limitYa, untuk fitur server-onlyJangan pernah expose ke client
NEXT_PUBLIC_APP_URLSelalu sebaiknya diisiSangat disarankanBase URL app untuk callback, order page, dan metadata
Untuk setup lokal, simpan secret di .env.local. npm run env:check sekarang membaca .env dan .env.local seperti Next.js, jadi hasil cek lebih dekat ke perilaku app yang sebenarnya.

​
Toggle fitur

Jika env toggle tidak diisi, repo menganggap fitur tersebut aktif. Isi false, 0, no, atau off untuk mematikannya.
VariableFungsi
NEXT_PUBLIC_ENABLE_AUTHMengontrol login, signup, dashboard, settings, dan auth-aware shell. Auth baru benar-benar dianggap aktif kalau public env Supabase juga terisi
NEXT_PUBLIC_ENABLE_WAITLISTMengontrol halaman dan API waitlist
NEXT_PUBLIC_ENABLE_CONTACTMengontrol form kontak
NEXT_PUBLIC_ENABLE_PAYMENTSMengontrol billing, checkout, dan payment-related UI
NEXT_PUBLIC_ENABLE_ADMINMengontrol admin dashboard
NEXT_PUBLIC_ENABLE_AIMengontrol AI routes dan UI terkait
Untuk auth, toggle true saja belum cukup. Kalau NEXT_PUBLIC_SUPABASE_URL atau NEXT_PUBLIC_SUPABASE_PUBLISHABLE_KEY kosong, halaman auth akan masuk ke mode notice atau fallback, bukan memaksa inisialisasi client yang gagal.

​
Payments

VariableWajib saatKeterangan
PAYMENT_PROVIDERPayments aktifNilai valid: midtrans atau doku
MIDTRANS_SERVER_KEYPAYMENT_PROVIDER=midtransSecret server-only untuk Midtrans
NEXT_PUBLIC_MIDTRANS_CLIENT_KEYPAYMENT_PROVIDER=midtransClient key untuk membuka Snap popup
DOKU_CLIENT_IDPAYMENT_PROVIDER=dokuClient ID merchant Doku
DOKU_SECRET_KEYPAYMENT_PROVIDER=dokuSecret key merchant Doku

​
Email dan contact

VariableWajib saatKeterangan
RESEND_API_KEYContact form atau email aktifAPI key Resend
EMAIL_FROMDisarankan saat email aktifSender email. Kalau kosong, repo memakai default KilatKoding
CONTACT_EMAILOpsionalEmail tujuan form kontak. Kalau kosong, fallback ke EMAIL_FROM

​
Admin dan access control

VariableWajib saatKeterangan
ADMIN_EMAILSOpsionalDaftar email bootstrap admin, dipisahkan koma
ADMIN_EMAILS bukan source of truth akhir. Setelah user masuk, repo akan mengelola role nyata lewat tabel user_roles.

​
AI

VariableWajib saatKeterangan
AI_DEFAULT_PROVIDERAI aktifNilai valid: openai atau anthropic
OPENAI_API_KEYAI_DEFAULT_PROVIDER=openaiSecret untuk route AI OpenAI
ANTHROPIC_API_KEYAI_DEFAULT_PROVIDER=anthropicSecret untuk route AI Anthropic

​
Env opsional untuk operasional

VariableDipakai olehKeterangan
VERCEL_URLMetadata base URL saat deployBiasanya diisi otomatis oleh Vercel
PLAYWRIGHT_BASE_URLPlaywrightMemungkinkan test E2E memakai server yang sudah hidup
CIGitHub Actions atau CI lainMengatur retry dan reporter tertentu di Playwright

​
Profil toggle yang umum

Bagian ini berguna kalau kamu ingin memulai dari kombinasi fitur yang realistis, bukan dari semua fitur aktif sekaligus.
Cocok kalau kamu masih validasi ide.
NEXT_PUBLIC_ENABLE_AUTH=false
NEXT_PUBLIC_ENABLE_WAITLIST=true
NEXT_PUBLIC_ENABLE_CONTACT=true
NEXT_PUBLIC_ENABLE_PAYMENTS=false
NEXT_PUBLIC_ENABLE_ADMIN=false
NEXT_PUBLIC_ENABLE_AI=false
Tetap siapkan NEXT_PUBLIC_SUPABASE_URL dan NEXT_PUBLIC_SUPABASE_PUBLISHABLE_KEY karena waitlist memakai Supabase. Kalau contact form aktif, siapkan juga RESEND_API_KEY.
Cocok untuk mayoritas produk SaaS klasik.
NEXT_PUBLIC_ENABLE_AUTH=true
NEXT_PUBLIC_ENABLE_WAITLIST=false
NEXT_PUBLIC_ENABLE_CONTACT=true
NEXT_PUBLIC_ENABLE_PAYMENTS=true
NEXT_PUBLIC_ENABLE_ADMIN=true
NEXT_PUBLIC_ENABLE_AI=false

PAYMENT_PROVIDER=doku
Pastikan Supabase public env, SUPABASE_SERVICE_ROLE_KEY, dan credential payment provider sudah diisi.
Cocok kalau fitur utamanya memang AI.
NEXT_PUBLIC_ENABLE_AUTH=true
NEXT_PUBLIC_ENABLE_WAITLIST=false
NEXT_PUBLIC_ENABLE_CONTACT=false
NEXT_PUBLIC_ENABLE_PAYMENTS=true
NEXT_PUBLIC_ENABLE_ADMIN=true
NEXT_PUBLIC_ENABLE_AI=true

PAYMENT_PROVIDER=midtrans
AI_DEFAULT_PROVIDER=openai
Selain env payment, kamu juga perlu OPENAI_API_KEY atau ANTHROPIC_API_KEY sesuai provider default yang dipilih.
Cocok untuk area login tertutup, dashboard internal, atau workspace client.
NEXT_PUBLIC_ENABLE_AUTH=true
NEXT_PUBLIC_ENABLE_WAITLIST=false
NEXT_PUBLIC_ENABLE_CONTACT=false
NEXT_PUBLIC_ENABLE_PAYMENTS=false
NEXT_PUBLIC_ENABLE_ADMIN=false
NEXT_PUBLIC_ENABLE_AI=false
Setup minimalnya cukup Supabase. Admin bisa dinyalakan belakangan kalau kamu butuh panel operasional internal.

​
Contoh minimal .env.local

Gunakan contoh ini kalau kamu hanya ingin auth, dashboard, dan satu payment provider: 
NEXT_PUBLIC_SUPABASE_URL=
NEXT_PUBLIC_SUPABASE_PUBLISHABLE_KEY=
SUPABASE_SERVICE_ROLE_KEY=
NEXT_PUBLIC_APP_URL=http://localhost:3000

NEXT_PUBLIC_ENABLE_AUTH=true
NEXT_PUBLIC_ENABLE_WAITLIST=false
NEXT_PUBLIC_ENABLE_CONTACT=false
NEXT_PUBLIC_ENABLE_PAYMENTS=true
NEXT_PUBLIC_ENABLE_ADMIN=true
NEXT_PUBLIC_ENABLE_AI=false

PAYMENT_PROVIDER=doku
DOKU_CLIENT_ID=
DOKU_SECRET_KEY=

ADMIN_EMAILS=you@example.com

​
Cara mengecek env dengan cepat

  1. Pastikan nilai terbaru ada di .env.local atau .env.
  2. Jalankan npm run env:check.
  3. Baca status ready, fallback mode, atau disabled by ....
  4. Setelah app hidup, buka GET /api/health untuk melihat readiness yang lebih detail.
  5. Kalau kamu baru mengubah env, restart npm run dev lalu cek ulang.
Kalau sebuah fitur memang belum kamu pakai, lebih baik matikan lewat toggle daripada membiarkannya aktif tanpa konfigurasi.