Mode

Struktur folder hasil generate sama di kedua mode. Yang berbeda hanya lapisan data.

Mode	Sumber data	Cocok untuk
frontend	Backend terpisah lewat src/server/api	Tim dengan backend Go, Laravel, Java, dan lain-lain
fullstack	Database lewat src/server/db	Aplikasi yang logika servernya ada di Next.js

npm create nextjs-kit@latest my-app -- --mode frontend

Perbedaannya tercatat di docs/data-layer.md pada proyek hasil generate, dan AGENTS.md menunjuk ke sana. Berkas itu berisi aturan akses data untuk mode yang Anda pilih, sehingga developer dan AI coding agent mengikuti aturan yang sama.

Frontend: Next.js sebagai BFF

Browser tidak pernah memanggil backend langsung. Semua permintaan lewat server Next.js (Server Component, Server Action, route handler), yang menambahkan token dan menormalisasi error. Token disimpan di cookie httpOnly, jadi tidak terjangkau JavaScript di browser.

Modul yang tersedia: api-client, bff-auth, openapi, dan msw.

Fullstack

Modul db (Drizzle, Postgres lewat Docker Compose, migrasi), dal (lapisan akses data), dan auth (Better Auth) sudah tersedia. Pasang semuanya dengan preset saas-fullstack:

npm create nextjs-kit@latest my-saas -- --preset saas-fullstack --yes

Integrasi dal-auth otomatis membuat todos per pengguna. Jalankan database dan migrasi sebelum dev server; langkah lengkap ada di halaman preset.