README

A professional Laravel + Filament starter kit preconfigured with authentication, roles, permissions, and modern developer tooling — so you can start building admin panels in minutes instead of hours.

🚀 Quick Start

composer create-project muazzam/filament-pro-starter myapp
cd myapp
php artisan key:generate
php artisan migrate
npm install && npm run dev
php artisan serve

Visit your new app at 👉 http://localhost:8000

⚙️ Preconfigured Packages

Package	Description
filament/filament	Core Filament admin panel
bezhansalleh/filament-shield	Roles & permissions made simple
stechstudio/filament-impersonate	Login as any user
joaopaulolndev/filament-edit-profile	Editable user profile in Filament
stephenjude/filament-two-factor-authentication	Secure 2FA integration
spatie/laravel-passkeys	WebAuthn passkey authentication

All configured and ready to go out of the box 🧙‍♂️

🧠 Key Features

✅ Laravel 12 + Filament 4.1
✅ Role & Permission System (Shield)
✅ Two-Factor Authentication (2FA)
✅ Passkey Authentication Support
✅ User Impersonation
✅ Edit Profile Page
✅ Preconfigured Build System (Vite + Tailwind)
✅ Dev Script for Instant Startup

🧰 Available Commands

Command	Purpose
`composer setup`	Runs install, migrations, and npm build automatically
`composer dev`	Starts Laravel, Vite, and queue listener concurrently
`composer test`	Runs all tests
`php artisan migrate`	Migrates database
`php artisan serve`	Starts the local server

🧪 Development Workflow

You can use the included concurrent dev script for a full local environment:

composer dev

This will run:

🟢 Laravel server (php artisan serve)
🟡 Queue listener
🔵 Vite build (hot reload)

Perfect for rapid Filament development.

🧩 Project Structure

.
├── app/
│   ├── Filament/        # Your Filament Resources
│   ├── Http/
│   └── Models/
├── database/
│   ├── migrations/
│   └── seeders/
├── public/
├── resources/
│   ├── views/
│   ├── css/
│   └── js/
├── routes/
│   ├── web.php
│   └── api.php
└── composer.json

🛠️ Requirements

PHP ≥ 8.2
Composer ≥ 2.6
Node.js ≥ 18
MySQL or SQLite

📦 Deployment Ready

This starter includes:

🧾 Optimized autoloading
⚙️ Production build scripts
🔑 Security best practices
🐳 Laravel Sail support (Docker ready)

🪄 Example Setup Script

🪄 Example Setup Script (with Filament Shield)

After running your migrations, simply execute:

Run this to generate permissions and policies

php artisan shield:generate --all

Then generate a super user

php artisan shield:super-admin

You’ll be guided through a short setup:

Enter the name, email, and password for your super admin.

Shield will automatically:

Create the Super Admin role

Assign all permissions

Link the new user to that role

When done, you can log in at /admin using those credentials 🎉

Then visit /admin and log in 🎉

🧰 Optional Tools

If you’d like to extend this starter:

Package	Adds
`spatie/laravel-activitylog`	User activity tracking
`filament/forms` + `filament/tables`	Advanced Filament components
`livewire/livewire`	Reactive UI support

🤝 Contributing

Pull requests are welcome!
If you plan major changes, please open an issue first to discuss what you’d like to add.

📄 License

This project is open-sourced software licensed under the MIT license.

muazzam / filament-pro-starter

Maintainers

Details