BigStarter

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:

LayerTeknologi
FrameworkNext.js 16 + React 19
BahasaTypeScript
StylingTailwind CSS v4 + shadcn/ui
DatabasePostgreSQL — multi-ORM Drizzle & Prisma (lihat Database)
AutentikasiSupabase Auth
APIHono + oRPC (type-safe end-to-end)
Background JobsTrigger.dev
BillingMulti-provider (Xendit, Midtrans, PayPal, Paddle)
EmailResend / MailerSend
i18nnext-intl
State ManagementZustand
AnimasiMotion (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 Supabase

Persyaratan Sistem

  • Node.js v20 atau lebih tinggi
  • PostgreSQL (atau Supabase)
  • npm / pnpm / yarn

Instalasi

1. Clone repository:

git clone <repository-url>
cd bigstarter

2. Install dependencies:

npm install
# atau
pnpm install
# atau
yarn install

3. 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 dev

5. Jalankan development server:

npm run dev

6. 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! 🚀