README

Filament Starter Kit

Starter kit untuk membangun admin panel dengan Laravel 12, Filament 5, dan Livewire 4.

Fokus utamanya adalah struktur code yang rapi, maintainable, dan nyaman untuk development jangka panjang.

Kenapa Pakai Starter Kit Ini

• Arsitektur jelas: mutation lewat Action Pattern (handle()), query lewat scope/custom builder.
• API siap pakai dengan Sanctum dan struktur endpoint api/v1.
• Role & permission sudah siap via Filament Shield.
• UUID-first untuk tabel baru.
• Tooling kualitas code sudah terpasang: Pest, Pint, Larastan, Rector.
• Cocok untuk workflow AI-assisted coding karena aturan project dan docs sudah terstruktur.

Quick Start

1) Buat project

laravel new my-app --using=lyrihkaesa/filament-starter-kit
cd my-app

2) Install dependency dan setup awal

composer install
npm install
cp .env.example .env
php artisan key:generate
php artisan migrate --seed
npm run build

3) Jalankan development server

composer run dev

Akun default

• Email: superadmin@example.com
• Password: password

Command Harian

Development

composer run dev
php artisan serve
npm run dev

Testing & Quality

composer test
composer test-full
composer test:types
composer test:lint
composer test:refactor

Prinsip Arsitektur

• Mutations (create/update/delete): wajib di app/Actions.
• Queries (read):
  • mulai dari local scope #[Scope] di Model,
  • pindah ke app/Models/Builders/*Builder.php jika scope sudah banyak atau query kompleks.
• External integrations: di app/Services.
• UI layer (Filament/Livewire/Controller): tipis, hanya orkestrasi.

Dokumentasi

Dokumentasi lengkap ada di folder docs dan versi online:

• Dokumentasi Online

Mulai dari sini

• 00 - Intro
• 01 - Architecture Overview
• 02 - Action Pattern
• 03 - Query Pattern
• 04 - Policy and Action Integration

Referensi per topik

• 05 - User Resource
• 06 - UUID Primary Keys
• 07 - Make Starter Resource
• 08 - Guards and Sanctum Flow
• 09 - Roles Permissions Shield
• 10 - User Deletion and Anonymization
• 11 - File Upload Strategy
• 12 - Filament Curator
• 13 - Curator Privacy and Tracking
• 14 - API
• 15 - Mobile File Upload API
• 16 - Notifications
• 17 - Code Quality Toolchain
• 18 - App Service Provider
• 19 - Testing Setup
• 20 - Test Pest Coverage
• 21 - Coverage Ignores Analysis
• 22 - Laravel Debugbar
• 23 - Laravel Backup
• 24 - Laravel Boost AI Coding Guidelines
• 25 - Creating New Module
• 26 - Production Deployment

License

Project ini menggunakan lisensi MIT.