Feature toggle matrix

Lihat dampak setiap NEXT_PUBLIC_ENABLE_* toggle pada UI, route, API, env, dan fallback behavior KilatKoding.

Kalau sebuah toggle tidak diisi, repo menganggap fitur itu aktif. Nilai false, 0, no, atau off diperlakukan sebagai kondisi nonaktif.

​

Matrix cepat

Toggle	Area utama yang terpengaruh	Jika dimatikan	Hal yang tetap perlu kamu cek
NEXT_PUBLIC_ENABLE_AUTH	Flow login, callback auth, route login-aware, upload avatar	Auth dianggap sengaja tidak dipakai	Hapus CTA ke login/dashboard dan sesuaikan narasi landing page
NEXT_PUBLIC_ENABLE_WAITLIST	/waitlist, POST /api/waitlist	Page dan API waitlist masuk mode disabled/fallback	Hapus link waitlist dari navigasi dan CTA
NEXT_PUBLIC_ENABLE_CONTACT	/contact, POST /api/contact	Form kontak masuk mode disabled/fallback	Pastikan ada jalur support lain kalau form dimatikan
NEXT_PUBLIC_ENABLE_PAYMENTS	Billing, checkout, POST /api/payments, POST /api/subscription	Flow billing dan payment dianggap sengaja mati	Hapus CTA upgrade, pricing checkout, dan janji subscription
NEXT_PUBLIC_ENABLE_ADMIN	/admin, POST /api/admin/users/role	Panel admin dianggap sengaja tidak dipakai	Pastikan tim internal punya cara lain untuk operasi jika admin off
NEXT_PUBLIC_ENABLE_AI	Readiness AI dan UI AI yang kamu expose	AI dianggap tidak dipakai	Sembunyikan entry point AI dan sesuaikan copy plan

​

Detail per toggle

NEXT_PUBLIC_ENABLE_AUTH

Dampak yang paling terasa:

• /auth/confirm akan mengarahkan ke error kalau auth dianggap tidak aktif,
• POST /api/profile/avatar juga memeriksa availability auth,
• area dashboard dan route yang butuh session tetap harus diperlakukan sebagai area nonaktif secara produk.

Artinya secara operasional:

• jangan arahkan user ke login atau dashboard kalau auth memang dimatikan,
• kalau produkmu hanya waitlist atau marketing site, auth off adalah setup yang wajar.

NEXT_PUBLIC_ENABLE_WAITLIST

Dampak yang paling terasa:

• halaman /waitlist akan menampilkan notice disabled atau not configured,
• POST /api/waitlist akan mengembalikan 503 kalau fiturnya tidak aktif,
• health check akan menganggap waitlist sengaja mati atau belum siap.

Cocok dimatikan kalau:

• kamu sudah launch penuh,
• kamu tidak ingin mengumpulkan lead di luar flow signup.

NEXT_PUBLIC_ENABLE_CONTACT

Dampak yang paling terasa:

• halaman /contact tetap ada, tetapi form akan masuk mode notice jika fitur belum siap,
• POST /api/contact akan mengembalikan 503 kalau fitur tidak aktif,
• rate limit form kontak tidak relevan lagi kalau fitur dimatikan.

Cocok dimatikan kalau:

• support dipindahkan ke email langsung, Discord, WhatsApp, atau helpdesk eksternal.

NEXT_PUBLIC_ENABLE_PAYMENTS

Dampak yang paling terasa:

• /dashboard/billing akan menampilkan state disabled atau fallback,
• tombol payment di billing tidak lagi usable,
• POST /api/payments dan POST /api/subscription dianggap tidak aktif,
• health check akan menandai billing dan payments sebagai fitur yang tidak dipakai.

Cocok dimatikan kalau:

• produk belum dijual publik,
• akses diberikan manual,
• kamu masih fase waitlist atau pilot private.

NEXT_PUBLIC_ENABLE_ADMIN

Dampak yang paling terasa:

• /admin menampilkan feature notice,
• POST /api/admin/users/role dianggap tidak tersedia untuk operasional harian,
• tim kehilangan panel visual untuk payment, webhook, dan audit trail.

Cocok dimatikan kalau:

• kamu belum butuh panel internal,
• semua operasi masih dilakukan manual dari dashboard provider dan database.

NEXT_PUBLIC_ENABLE_AI

Dampak yang paling penting untuk dipahami:

• toggle ini dipakai untuk readiness planning dan seharusnya juga mengendalikan surface AI yang kamu tampilkan ke user,
• route AI saat ini tetap sangat bergantung pada auth user, provider key, usage limit, dan rate limit,
• kalau kamu membangun UI AI sendiri, kamu tetap perlu menyembunyikannya saat toggle ini dimatikan.

Praktiknya:

• gunakan toggle ini sebagai keputusan produk,
• gunakan provider env dan auth check sebagai keputusan runtime.

​

Gate yang bukan toggle, tetapi sama pentingnya

Capability	Apa yang mengaktifkan	Dampaknya kalau belum siap
Auth readiness	NEXT_PUBLIC_SUPABASE_URL + NEXT_PUBLIC_SUPABASE_PUBLISHABLE_KEY	login, signup, waitlist berbasis Supabase, dan banyak route auth-aware akan fallback
Billing server writes	SUPABASE_SERVICE_ROLE_KEY	cancel, resume, admin reporting, audit, avatar signed URL, dan payment write tidak siap
Contact form send	RESEND_API_KEY	form kontak terlihat aktif, tetapi tidak bisa benar-benar kirim email
Payment provider	credential Midtrans atau Doku sesuai PAYMENT_PROVIDER	checkout end-to-end tidak bisa jalan
AI runtime	provider key + auth + usage limit	route AI mengembalikan 401, 429, atau 503 sesuai masalahnya

​

Cara mengubah toggle dengan aman

1. Ubah toggle di .env.local atau env production.
2. Jalankan npm run env:check.
3. Cek GET /api/health.
4. Buka halaman yang paling terpengaruh.
5. Pastikan navigasi dan CTA ikut disesuaikan.

Kalau kamu sedang memilih kombinasi toggle yang realistis, baca Mulai dengan benar dan Checklist launch per use case.