README

Filament Starter Kit

Starter kit modern untuk membangun admin panel tangguh menggunakan Laravel 12 dan Filament v5.

Fokus utama kit ini adalah Developer Experience (DX) dengan struktur yang sangat rapi, strict typing, dan pola kode yang maintainable untuk project jangka panjang. Cocok untuk developer yang menginginkan standar kualitas tinggi seperti ekosistem TypeScript di dalam Laravel.

✨ Highlight Fitur

Modern Stack: Laravel 12, Filament v5, Livewire 4, dan Tailwind CSS v4.
Architectural Excellence: Menggunakan Action Pattern (handle()) untuk memisahkan business logic dari Controller/Page.
Strict Typing: Codebase yang bersahabat dengan strict types untuk keamanan kode yang lebih baik.
API Ready: Integrasi Laravel Sanctum yang siap digunakan untuk aplikasi mobile atau frontend terpisah.
Security & RBAC: Manajemen akses canggih menggunakan Filament Shield.
Privacy Focused: Sistem Anonymization otomatis untuk user yang dihapus (GDPR-friendly).
UUID First: Standar penggunaan UUID untuk tabel baru guna skalabilitas dan keamanan.
Quality Assurance: Terintegrasi penuh dengan Pest 4 (100% Test Coverage), Pint, Larastan, dan Rector.
Storage & Database: Support PostgreSQL untuk production dan SQLite in-memory untuk testing cepat. Dilengkapi native support local dan s3 storage adapter yang siap pakai.
AI-Friendly: Terdesain efisien untuk AI Agents. Penggunaan komponen dioptimalkan melalui package PAO untuk mengurangi konsumsi token (context length) drastis.

🚀 Quick Start

Install via Laravel Installer

laravel new my-app --using=lyrihkaesa/filament-starter-kit
cd my-app
composer install
npm install
cp .env.example .env
php artisan key:generate
php artisan migrate --seed
npm run build
composer dev

Akun Admin Default

Email: superadmin@example.com
Password: password

🛠️ Tech Stack & Tools

Kategori	Teknologi
Framework	Laravel 12, Filament 5, Livewire 4
Auth	Session (WEB), Sanctum (API), Shield (RBAC)
Styling	Tailwind CSS 4
Testing	Pest 4
Code Quality	Pint (Linting), Larastan (Static Analysis), Rector (Refactoring)
Utilities	Laravel Boost, Matomo Device Detector, PAO

🤖 AI-Friendly Architecture (Hemat Token)

Salah satu keunggulan utama dari Starter kit ini adalah desainnya yang sangat AI-Friendly. Mengingat penggunaan AI Agent seperti GitHub Copilot, Cursor, atau Gemini dalam development modern, starter kit ini dirancang agar Context Window/Length tetap ramping. Kami menggunakan package PAO (Pattern Action Object atau sejenisnya/Spatie) sehingga boilerplate logic tidak memenuhi token space Anda. Manfaatnya:

Biaya AI lebih murah karena sedikit token yang terpakai untuk setiap context.
Respon AI lebih cepat dan akurat karena tidak perlu menganalisis ratusan baris kode noisy.
Konsep Clear/Strict memudahkan AI merekomendasikan kode (Action Pattern, Strict Types).

🗄️ Database & Storage Support

Aplikasi ini siap tempur dengan multi-database dan multi-storage:

Database: Mendukung penuh PostgreSQL untuk production grade, namun Anda tetap dapat memanfaatkan SQLite untuk keperluan fast testing atau local dev.
Storage: Mendukung langsung system Local Filesystem untuk kesederhanaan, serta S3-Compatible Object Storage (AWS, MinIO, R2, dll) out-of-the-box guna mendukung skalabilitas aplikasi atau integrasi API mobile yang seamless.

📖 Prinsip Pengembangan

Action Pattern: Logic bisnis harus berada di kelas Action, bukan di Controller atau Filament Page.
API Versioning: Endpoint API terstruktur di bawah /api/v1 dengan Eloquent Resources.
Soft Deletes & Anonymize: User yang dihapus akan di-anonymize datanya sebelum benar-benar dihapus permanen.
No N+1 Queries: Selalu memprioritaskan eager loading untuk performa database.
100% Code Coverage: Code base ini wajib lulus strict Architecture Test dan 100% Test Coverage menggunakan Pest sebelum deployment.

📚 Dokumentasi Lengkap

Dokumentasi detail dapat ditemukan di folder docs atau melalui:

👉 Dokumentasi Online Filament Starter Kit

🚦 Mulai dari Sini

00 - Intro & Filosofi — Tujuan starter kit, pilihan database, storage, dan AI support
32 - Architecture Overview — Baca ini dulu sebelum membuat fitur baru

🏛️ Arsitektur & Pattern

02 - Action Pattern — Mutations (Create/Update/Delete) via Action class
23 - Query Builders — Scopes vs Custom Eloquent Builders
09 - Kenapa Tidak Repository Pattern — Penjelasan lengkap alasannya
16 - Policy & Action Integration — Cara authorization bekerja bersama Action

🔐 Auth & Security

🌐 API

🗂️ File & Media

🧪 Testing & QA

25 - Database Testing Options — SQLite vs PostgreSQL untuk testing
03 - Test Coverage Setup (Xdebug)
22 - Architecture Tests
28 - Coverage Ignores Analysis

🛠️ Tools & Filament

✅ Quality Control

Jalankan perintah berikut untuk menjaga kualitas codebase:

Semua Tes: composer test-full
Unit & Feature Test: php artisan test
API Testing: bru run api-tests/bruno --env local
Auto Format: composer lint
Static Analysis: composer test:types
Auto Refactor: composer refactor

📄 Lisensi

Proyek ini menggunakan lisensi MIT.

lyrihkaesa / filament-starter-kit

Maintainers

Package info

Fund package maintenance!

Statistics

Security