Mulai
Pilih fondasi yang sesuai, jalankan proyek, lalu mulai dari fitur contoh todos.
Prasyarat
Section titled “Prasyarat”- Node.js 22.12 atau lebih baru untuk toolchain aplikasi hasil generate
- npm, pnpm, yarn, atau bun
- Docker yang sedang berjalan jika memilih preset fullstack
Buat proyek
Section titled “Buat proyek”Pilih mode dan package manager. Perintah instalasi serta langkah menjalankannya mengikuti pilihan Anda.
1. Buat proyek
npm create nextjs-kit@latest my-app -- --preset saas-fullstack --yes2. Jalankan di mesin lokal
cd my-app
cp .env.example .env.local
npm run db:up
npm run db:migrate
npm run devSetelah dibuat, CLI menginisialisasi git, meng-install dependency, merapikan kode dengan Prettier,
lalu membuat commit awal. Gunakan --no-git atau --no-install bila diperlukan. Untuk memilih
modul satu per satu, jalankan npm create nextjs-kit@latest my-app tanpa preset.
Jalankan
Section titled “Jalankan”Ikuti langkah Jalankan di mesin lokal pada pilihan di atas. Buka localhost:3000 setelah dev server siap.
- Fullstack: buka
/register, buat akun, lalu coba/todos. Data tersimpan di Postgres dan hanya terlihat oleh pengguna yang membuatnya. - Frontend: isi
API_BASE_URLdi.env.localdengan alamat backend Anda sebelum memakai login. Contoh/todosmasih memakai penyimpanan sementara di memori.
Perintah di proyek hasil generate
Section titled “Perintah di proyek hasil generate”| Perintah | Fungsi |
|---|---|
npm run dev |
Dev server |
npm run check |
Typecheck, lint, format check, dan unit test |
npm run test |
Vitest + Testing Library |
npm run test:e2e |
Playwright |
npm run build |
Build production |
Jalankan npm run check sebelum menyatakan pekerjaan selesai.
Langkah berikutnya
Section titled “Langkah berikutnya”- Pahami arsitektur dan aturan lapisannya.
- Pilih mode yang sesuai.
- Lihat preset untuk kumpulan modul siap pakai.