lyrihkaesa/filament-starter-kit

Filament Starter Kit for Laravel with best practices

v1.0.1-beta1 2025-09-09 17:48 UTC

This package is auto-updated.

Last update: 2025-09-14 04:20:39 UTC


README

Starter Kit untuk membangun aplikasi berbasis Laravel + Filament.
Tujuannya adalah menyediakan pondasi siap pakai untuk admin panel modern dengan praktik terbaik (Action Pattern, custom resource, dsb).

โœจ Fitur yang Tersedia

  • Filament panel dengan ID app (bukan default admin)
  • User Resource (CRUD user) with Action Pattern
  • Action Pattern (php artisan make:action)
  • User, Role & Permision Seeder (default admin user)
  • Custom Locale (APP_LOCALE id, APP_FAKER_LOCALE id_ID)
  • RBAC or ABAC (Role & Permission) using bezhansalleh/filament-shield
  • Impersonating User using stechstudio/filament-impersonate
  • API using laravel/sanctum

๐Ÿš€ Quick Start

Opsi 1: Install Baru dengan Laravel Installer

  1. Pastikan Laravel Installer, Jika Anda menggunakan Laravel Herd otomatis Anda sudah install Laravel Installer:

    Check Laravel Installer terpasang:

    laravel --version
    Panduan menginstal Laravel Installer Jika Anda sudah menginstal `PHP` dan `Composer`, Anda dapat menginstal `Laravel Installer` melalui Composer:
    composer global require laravel/installer
  2. Buat project baru langsung dari starter kit:

    laravel new my-app --using=lyrihkaesa/filament-starter-kit
    cd my-app
  3. Jalankan perintah dibawah ini jika ada script saat create project ada yang gagal dimuat:

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

    composer dev

    Jika menggunakan Laravel Herd langsung saja dibrowser http://filament-starter-kit.test

  5. Login default (automatis input jika APP_DEBUG=true):

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

Jika menggunakan Laravel Herd, atur APP_URL=http://filament-starter-kit.test.
Jika pakai composer dev, gunakan APP_URL=http://localhost:8000.

Opsi 2: Manual (Clone Repository)

  1. Clone repository:

    git clone https://github.com/username/filament-starter-kit.git
    cd filament-starter-kit
  2. Install dependencies:

    composer install
    npm install
    npm run build
  3. Salin file .env:

    cp .env.example .env
  4. Generate app key:

    php artisan key:generate
  5. Migrasi database & jalankan seeder:

    php artisan migrate --seed
  6. Jalankan server:

    composer dev
  7. Login default:

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

โš™๏ธ Development Tools

Keterangan Package Command
๐Ÿงช Testing Pest v4 php artisan test / ./vendor/bin/pest
๐ŸŽจ Code Style Laravel Pint composer lint / ./vendor/bin/pint
๐Ÿ›  Refactoring Rector + driftingly/rector-laravel composer test:refactor (dry-run) / composer refactor / ./vendor/bin/rector
๐Ÿ” Static Analysis Larastan composer test:types / ./vendor/bin/phpstan

๐Ÿค Kontribusi

[TODO]

๐Ÿ“œ Lisensi

MIT License