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

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

🧪 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:

🤝 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.

✨ Credits

Built with ❤️ by Muazzam Khan
Powered by Laravel + Filament