🎨 Filament Fun - Modern Laravel Admin Panel

A comprehensive learning project exploring Filament PHP's capabilities - featuring multi-tenancy, role management, Stripe payments, and real-time notifications in a beautifully crafted admin interface.

📸 Screenshots

Click to expand/collapse screenshots

📊 Dashboard & Analytics

Dashboard Overview
Main dashboard with key metrics and charts

👥 Employee Management

Employee List
Employee listing with filters and bulk actions

Employee Create
Employee creation form with department selection

Employee Details
Detailed employee profile with relationship tabs

📦 Product Management

Product List
Product catalog with search and categories

Product Create
Product creation with inventory management

🌍 Location Management

Countries, States & Cities
Country, state, and city management

💳 Stripe Integration

Payment Dashboard
Stripe payment overview and management

Payment Processing
Stripe payment processing interface

🛡️ Roles & Permissions

Roles List
Role management with Shield integration

Permission Matrix
Permission assignment interface

User Roles
User role assignment

✨ Key Features

🎯 Core Functionality

Modern Admin Panel - Built with Filament 3.2 for exceptional UX
Multi-Tenancy - Team-based data isolation and management
Advanced RBAC - Role & permission system with Filament Shield
Employee Management - Complete HR module with departments and locations
Product Catalog - Full-featured product and inventory management

💳 Integrations & Tools

Stripe Payments - Secure payment processing
Real-time Notifications - Powered by Laravel Reverb WebSockets
Blog System - Content management with Firefly Blog
Automated Backups - Scheduled backups with Spatie Laravel Backup
Activity Logging - Complete audit trail of system actions
Excel Export - Data export capabilities

🎨 User Experience

Dashboard Analytics - Beautiful charts with Apex Charts
Spotlight Search - Quick navigation (⌘K / Ctrl+K)
Multi-language - Full translation support
Dark Mode - Built-in theme switching

🚀 Quick Start

Prerequisites

Ensure you have the following installed:

PHP 8.2 or higher
Composer 2.x
Node.js 18+ and npm
MySQL 5.7+ / PostgreSQL / MariaDB 10.3+
PHP Extensions: ext-intl, ext-gd, ext-zip

Installation

1️⃣ Clone & Install Dependencies

git clone <repository-url>
cd filament-fun
composer install
npm install

2️⃣ Environment Setup

cp .env.example .env
php artisan key:generate

3️⃣ Configure Database

Update your .env file:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=filament_fun
DB_USERNAME=root
DB_PASSWORD=your_password

4️⃣ Run Migrations & Seed Data

php artisan migrate --seed
php artisan storage:link

5️⃣ Configure Stripe (Optional)

STRIPE_KEY=pk_test_...
STRIPE_SECRET=sk_test_...
STRIPE_CURRENCY=usd

6️⃣ Build Frontend Assets

npm run build  # Production
# OR
npm run dev    # Development with HMR

🎮 Running the Application

Option 1: One Command to Rule Them All (Recommended)

composer dev

This starts:

🌐 Laravel dev server → http://localhost:8000
📦 Queue worker (for async jobs)
📊 Log viewer (Laravel Pail)
⚡ Vite HMR server

Option 2: Manual Mode

Run in separate terminals:

# Terminal 1
php artisan serve

# Terminal 2
php artisan queue:work

# Terminal 3
npm run dev

Option 3: Laravel Valet (macOS)

valet park
# Access at: http://filament-fun.test

👤 Default Credentials

After seeding, login with:

Email: Check database/seeders/UserSeeder.php
Password: Check database/seeders/UserSeeder.php

⚠️ Security Note: Change default credentials immediately in production!

📦 Tech Stack

Core Framework

Package	Version	Purpose
Laravel	11.x	Backend Framework
Filament	3.2	Admin Panel
Livewire	3.x	Reactive Components

Filament Plugins

Shield - Authorization & Permissions
Breezy - Authentication & Profile
Excel - Export Operations
Spotlight - Quick Search (⌘K)
Apex Charts - Data Visualization
Blog - Content Management
Translations - i18n Support
Spatie Backup - Automated Backups

Additional Tools

Spatie Permission - RBAC System
Spatie Media Library - File Management
Laravel Reverb - WebSocket Server
Laravel Trend - Analytics
Stripe PHP SDK - Payment Processing

🛠️ Development Commands

# Code Quality
composer pint              # Format code (Laravel Pint)
composer test              # Run tests

# IDE Support
php artisan ide-helper:generate
php artisan ide-helper:models

# Monitoring
php artisan pail           # Watch logs in real-time
php artisan queue:work     # Process background jobs

# Database
php artisan migrate:fresh --seed  # Fresh start
php artisan db:seed               # Re-seed data

# Cache Management
php artisan optimize:clear        # Clear all caches
php artisan filament:optimize     # Optimize Filament

📁 Project Structure

app/
├── Filament/
│   ├── Resources/          # CRUD Resources (Employee, Product, User)
│   ├── Pages/              # Custom Pages (Backups, Payments)
│   ├── Widgets/            # Dashboard Widgets
│   └── Clusters/           # Grouped Resources
├── Models/                 # Eloquent Models
├── Enums/                  # Enum Classes (Role, Status)
├── Casts/                  # Custom Casts (MoneyCast)
└── Providers/              # Service Providers

database/
├── migrations/             # Database Schema
├── seeders/                # Sample Data
└── factories/              # Model Factories

resources/
├── views/                  # Blade Templates
└── js/                     # Frontend Assets

🌍 Multi-language Support

Add new languages:

php artisan filament:translations

Available languages can be managed via the admin panel under Settings → Translations.

🔐 Security Features

✅ CSRF Protection
✅ SQL Injection Prevention (Eloquent ORM)
✅ XSS Protection (Blade Escaping)
✅ Role-Based Access Control
✅ Secure Password Hashing
✅ PCI-Compliant Payments (Stripe)
✅ Activity Logging & Audit Trail

📊 Queue & Background Jobs

Development

php artisan queue:work

Production (with Supervisor)

Create /etc/supervisor/conf.d/filament-fun-worker.conf:

[program:filament-fun-worker]
process_name=%(program_name)s_%(process_num)02d
command=php /path/to/artisan queue:work --sleep=3 --tries=3
autostart=true
autorestart=true
user=www-data
numprocs=2
redirect_stderr=true
stdout_logfile=/path/to/storage/logs/worker.log

Then:

sudo supervisorctl reread
sudo supervisorctl update
sudo supervisorctl start filament-fun-worker:*

💾 Automated Backups

Backups are managed via Spatie Laravel Backup. Access the backup panel at:

/admin/backups

Configure backup schedule in config/backup.php and setup cron:

* * * * * cd /path/to/project && php artisan schedule:run >> /dev/null 2>&1

🧪 Testing

# Run all tests
php artisan test

# Run specific test suite
php artisan test --testsuite=Feature

# Run with coverage
php artisan test --coverage

🤝 Contributing

Contributions are welcome! Please follow these steps:

Fork the repository
Create a feature branch

   git checkout -b feature/amazing-feature

Commit your changes (use Conventional Commits)

   git commit -m "feat: add amazing feature"

Push to your branch

   git push origin feature/amazing-feature

Open a Pull Request

🐛 Bug Reports & Feature Requests

Found a bug or have a feature idea? Please open an issue with:

Clear description
Steps to reproduce (for bugs)
Expected vs actual behavior
Screenshots (if applicable)

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

Filament PHP - Amazing admin panel framework
Laravel - The PHP framework for web artisans
Spatie - Quality Laravel packages
All the amazing open-source contributors

📞 Support

Documentation: Filament Docs
Issues: GitHub Issues
Discussions: GitHub Discussions

⭐ Star this repo if you find it helpful!

Made with ❤️ using Filament PHP

Report Bug · Request Feature · Documentation

Name		Name	Last commit message	Last commit date
Latest commit History 45 Commits
app		app
bootstrap		bootstrap
config		config
database		database
lang/vendor		lang/vendor
public		public
resources		resources
routes		routes
storage		storage
tests		tests
.editorconfig		.editorconfig
.env.example		.env.example
.gitattributes		.gitattributes
.gitignore		.gitignore
.phpstorm.meta.php		.phpstorm.meta.php
LICENSE		LICENSE
README.md		README.md
_ide_helper.php		_ide_helper.php
artisan		artisan
composer.json		composer.json
composer.lock		composer.lock
package-lock.json		package-lock.json
package.json		package.json
phpunit.xml		phpunit.xml
postcss.config.js		postcss.config.js
tailwind.config.js		tailwind.config.js
vite.config.js		vite.config.js

License

fabyo0/filament-fun

Folders and files

Latest commit

History

Repository files navigation