README

Starter kit Laravel 12 + React (Inertia v2, Tailwind v4, Shadcn UI) buat bikin project kecil–menengah dengan cepat. Sekali generate, langsung dapet Model + CRUD API + React View — tinggal atur field dan form aja.

Fitur Utama

• Auto Generate CRUD Model, Migration, Controller, Request, dan React View otomatis.
• Role Based Access Control (RBAC) Menggunakan spatie/laravel-permission
• Media Handling Support spatie/laravel-medialibrary
• Database Management Built-in laravel-adminer
• Modern Frontend Stack Tailwind CSS v4, Shadcn, React, dan Inertia v2 sudah siap pakai.

Instalasi

1. Buat Project Baru

composer create-project iqbalfarhan/templatestarter-v2 nama_project
cd nama_project

Ganti nama_project sesuai nama project kamu.

2. Setup Awal

# Install dependencies
composer install
pnpm install

# Copy env & generate key
cp .env.example .env
php artisan key:generate

# Setup database & seed data
php artisan migrate
php artisan db:seed

# Build assets & jalankan dev server
composer dev

Akses aplikasi di: http://127.0.0.1:8000

Konfigurasi

File konfigurasi utama ada di: config/template-starter.php

Pastikan default-role ada di daftar default-roles.

Kalau ada perubahan konfigurasi di tengah development:

php artisan migrate:fresh --seed

Panduan Development

1. Generate Model

php artisan generate:amodel NamaModel

Akan membuat otomatis:

• Model (fillable ready)
• Factory dan Seeder
• StoreRequest dan UpdateRequest
• Controller API full CRUD
• Route::apiResource di web.php

Gunakan PascalCase untuk nama model (contoh: Project, UserProfile).

2. Generate React View

php artisan generate:rview nama_fitur
# contoh
php artisan generate:rview project

Yang dibuat:

• Index (tabel)
• Detail page
• Dialog delete
• Sheet create/edit
• Sheet filter
• Item component
• Type definition (TypeScript)

Tambahkan route di web.php dan menu di app-sidebar.tsx:

Route::apiResource('project', ProjectController::class);

3. Generate Model + View Sekaligus

php artisan generate:rmodel NamaFitur

CLI akan menanyakan:

• SoftDelete?
• Media?

Lalu masukkan field model seperti berikut:

name:string
content:text
published:boolean
published_at:datetime
category_id:fk

Jangan tekan enter kosong di akhir input.

4. Generate Permission

php artisan generate:permission user

Atau generate semua sekaligus:

php artisan generate:permission --all --softDelete

Perintah ini otomatis membuat permission untuk semua model di app/Models, termasuk yang menggunakan SoftDeletes.

5. Login dengan Socialite (Google)

Sudah mendukung login via Google menggunakan Laravel Socialite. Cara mengaktifkan:

1. Ubah enable_socialite menjadi true di config/template-starter.php

2. Tambahkan di .env:

   GOOGLE_CLIENT_ID=
   GOOGLE_CLIENT_SECRET=

3. Rebuild project, lalu buka halaman login. Tombol “Sign in with Google” akan muncul.

Untuk menambahkan platform lain, sesuaikan di config/services.php dan SocialiteController.php.

Roadmap

• Auto generate model, view, rmodel
• RBAC dengan Spatie
• Login via Socialite
• Auto generate menu sidebar
• API Pagination + Search

Tips

• Kalau ubah konfigurasi role → jalankan php artisan migrate:fresh --seed
• Untuk development cepat → tambahkan menu langsung di app-sidebar.tsx setelah generate

Lisensi

MIT License © Iqbal Farhan

Dukung Pengembangan

Kalau template ini bermanfaat buat kamu, dukung pengembangannya dengan donasi seikhlasnya. Setiap dukungan sangat berarti agar project ini bisa terus dikembangkan.