Introduction
Selamat datang di pusat bantuan dan panduan pengembangan BigStarter.
Memulai dengan BigStarter
BigStarter adalah boilerplate SaaS modern yang dirancang untuk membantu Anda membangun, meluncurkan, dan mengembangkan produk SaaS dengan cepat — tanpa harus memulai dari nol. Dibangun di atas teknologi yang sudah teruji dan siap produksi, BigStarter menyediakan fondasi lengkap yang mencakup autentikasi, otorisasi, billing, notifikasi, dan masih banyak lagi.
Apa itu BigStarter?
BigStarter adalah Developer-Focused SaaS Boilerplate yang menggabungkan seluruh komponen penting yang dibutuhkan sebuah produk SaaS dalam satu codebase yang rapi dan terstruktur. Dengan BigStarter, Anda tidak perlu lagi menghabiskan waktu berminggu-minggu untuk menyiapkan infrastruktur dasar — cukup fokus pada logika bisnis dan fitur unik produk Anda.
Teknologi yang Digunakan
BigStarter dibangun dengan teknologi modern yang sudah teruji di industri:
| Layer | Teknologi |
|---|---|
| Framework | Next.js 16 + React 19 |
| Bahasa | TypeScript |
| Styling | Tailwind CSS v4 + shadcn/ui |
| Database | PostgreSQL — multi-ORM Drizzle & Prisma (lihat Database) |
| Autentikasi | Supabase Auth |
| API | Hono + oRPC (type-safe end-to-end) |
| Background Jobs | Trigger.dev |
| Billing | Multi-provider (Xendit, Midtrans, PayPal, Paddle) |
| Resend / MailerSend | |
| i18n | next-intl |
| State Management | Zustand |
| Animasi | Motion (Framer Motion) |
Fitur Unggulan
1. Autentikasi Lengkap
Login, registrasi, reset password, manajemen sesi, dan verifikasi email — semuanya sudah tersedia. Mendukung social login (Google, GitHub) dan passwordless OTP.
2. Otorisasi (RBAC)
Role-based access control dengan fine-grained permissions, isolasi data per-tenant, dan audit trail yang lengkap.
3. Multi-Tenancy
Isolasi aman untuk banyak organisasi dalam satu instance aplikasi. Undang anggota, tetapkan peran, dan berpindah workspace dengan mulus.
4. Pricing & Billing
Langganan, invoice, dan webhook terintegrasi penuh dengan Stripe. Mendukung dynamic pricing tiers dan batasan penggunaan.
5. Notifikasi
Sistem notifikasi terpadu: real-time in-app alerts, push notification, dan email digest yang dapat diterjemahkan.
6. Superadmin Panel
Dashboard administrasi khusus untuk mengontrol pengguna platform, tenant, paket, dan billing.
7. i18n (Multi-bahasa)
Internasionalisasi penuh dengan next-intl, dukungan RTL, dan routing berbasis locale.
8. Theme System
Beberapa preset desain, dark mode, radius, scale, dan font — semua dapat dikustomisasi melalui design tokens.
9. Background Jobs
Queue processing, cron schedules, dan async workflows yang didukung oleh Trigger.dev.
10. Hono + oRPC
API type-safe dengan shared contracts antara frontend dan backend, validasi Zod, dan developer experience yang luar biasa.
11. Database
PostgreSQL siap produksi dengan realtime subscriptions dan query database yang type-safe melalui Prisma.
12. Transactional Email
Pengiriman email transaksional yang andal dengan template yang dapat diterjemahkan ke berbagai bahasa.
13. File Storage
Penyimpanan file aman dengan signed uploads, bucket privat & publik, dan resumable uploads.
14. API Keys
Generate dan kelola API keys untuk akses programatik, dengan scoping dan revocation.
Struktur Proyek
BigStarter menggunakan arsitektur modular yang bersih dan mudah dinavigasi:
bigstarter/
├── app/ # Aplikasi Next.js (App Router)
│ ├── (auth)/ # Halaman autentikasi
│ ├── (guest)/ # Halaman publik
│ ├── (marketing)/ # Halaman marketing & docs
│ ├── api/ # API routes
│ └── actions/ # Server actions
├── config/ # Konfigurasi aplikasi
├── docs/ # Dokumentasi internal
├── i18n/ # Konfigurasi internasionalisasi
├── infrastructure/ # Infrastruktur (db, jobs, orpc, supabase)
├── jobs/ # Background jobs
├── messages/ # File terjemahan (en, id, ar)
├── modules/ # Modul fitur (auth, billing, rbac, dll)
├── prisma/ # Skema database
├── scripts/ # Script utilitas
├── shared/ # Komponen & utilitas bersama
└── supabase/ # Konfigurasi SupabasePersyaratan Sistem
- Node.js v20 atau lebih tinggi
- PostgreSQL (atau Supabase)
- npm / pnpm / yarn
Instalasi
1. Clone repository:
git clone <repository-url>
cd bigstarter2. Install dependencies:
npm install
# atau
pnpm install
# atau
yarn install3. Konfigurasi environment:
Salin file .env.example menjadi .env dan isi variabel yang diperlukan (database URL, Supabase keys, Stripe keys, dll).
4. Jalankan migrasi database:
npx prisma migrate dev5. Jalankan development server:
npm run dev6. Buka http://localhost:3000 di browser Anda.
Mulai Mengembangkan
Setelah berhasil menjalankan BigStarter, Anda dapat mulai mengembangkan dengan:
- Menambahkan modul baru — buat folder baru di dalam
modules/dengan struktur yang konsisten. - Menggunakan oRPC — definisikan procedure API di
infrastructure/orpc/untuk type-safety end-to-end. - Mengelola database — gunakan Prisma untuk schema dan migrasi.
- Menambahkan halaman — buat route baru di dalam
app/sesuai dengan App Router Next.js. - Mengirim email — gunakan modul
modules/mail/dengan template yang sudah tersedia. - Menjadwalkan background jobs — gunakan Trigger.dev di
jobs/trigger/.
Dukungan & Komunitas
BigStarter terus dikembangkan dan diperbarui. Jika Anda menemukan bug, memiliki pertanyaan, atau ingin berkontribusi, silakan buka issue atau pull request di repository resmi BigStarter.
Selamat membangun produk SaaS Anda dengan BigStarter! 🚀
