Setup lokal

Ikuti langkah setup lokal KilatKoding untuk Windows, macOS, atau Linux.

​

Prasyarat

Repo ini pernah diverifikasi dengan Node.js 24.4.1 dan npm 11.4.2. Pada praktiknya, versi Node modern yang kompatibel dengan Next.js 16 biasanya cukup, tetapi angka itu adalah snapshot yang dipakai repo ini per 19 Maret 2026.

Kamu juga perlu:

• Git
• editor kode seperti VS Code
• akses ke repo atau file ZIP project

​

Siapkan tools per sistem operasi

Windows

Gunakan PowerShell atau Terminal bawaan VS Code.

Cara cepat lewat winget:

winget install Git.Git
winget install OpenJS.NodeJS.LTS

Setelah selesai, tutup lalu buka ulang terminal kamu. Pastikan kedua command ini berhasil:

git --version
node --version
npm --version

macOS

Kalau kamu pakai Homebrew:

brew install git node

Lalu verifikasi:

git --version
node --version
npm --version

Linux

Contoh berikut memakai Ubuntu atau Debian. Kalau distro kamu berbeda, gunakan package manager setara.

sudo apt update
sudo apt install -y git nodejs npm

Lalu verifikasi:

git --version
node --version
npm --version

​

Jalankan project pertama kali

1. Ambil source code

   Kalau kamu menerima akses repo, clone repo tersebut. Kalau kamu menerima ZIP, ekstrak ke folder kerja kamu.

   git clone <url-repo>
   cd kilatkoding-src
   
2. Install dependencies

   Jalankan:

   npm install
   
3. Buat file environment lokal

   macOS atau Linux:

   cp .env.example .env.local
   

   Windows PowerShell:

   Copy-Item .env.example .env.local
   

   Untuk setup lokal, simpan secret dan override lokal di .env.local. Next.js membaca .env dan .env.local, tetapi .env.local adalah tempat yang paling aman untuk perubahan lokal kamu.

4. Isi `.env.local`

   Lihat Environment variables untuk arti setiap variabel. Jangan menebak nama env. Repo ini sudah punya pola yang jelas.

5. Cek readiness

   Jalankan:

   npm run env:check
   

   Command ini membaca .env dan .env.local, lalu memberi tahu fitur mana yang sudah siap, mana yang fallback, dan mana yang sengaja dimatikan.

6. Hidupkan aplikasi

   Jalankan:

   npm run dev
   

   Lalu buka http://localhost:3000.

   Kalau kamu mengubah file env setelah dev server hidup, restart npm run dev supaya nilai terbaru ikut terbaca.

​

Kalau kamu juga ingin menjalankan E2E test

Install browser Playwright sekali saja:

npx playwright install chromium

Lalu jalankan:

npm run e2e

​

Tanda setup lokal kamu berhasil

Yang dicek	Hasil yang diharapkan
npm run env:check	Tidak ada error fatal untuk fitur yang kamu aktifkan
npm run dev	Dev server hidup tanpa crash
http://localhost:3000	Landing page tampil
Login atau dashboard	Berjalan jika auth aktif dan Supabase sudah benar

​

Error paling umum saat setup lokal

• Node terlalu lama atau terlalu baru untuk dependency tertentu.
• .env.local belum dibuat.
• Supabase env belum diisi tetapi auth tetap dibiarkan aktif.
• Payment atau AI diaktifkan tanpa env yang dibutuhkan.
• Nilai env sudah diubah, tetapi dev server belum direstart.

Kalau salah satu hal di atas terjadi, buka Troubleshooting.