README

Tapp Filament Starter Kit

Key features include:

• Pre-configured User architecture (Model, Policy, Factory, Migration, and Seeder)
• Authorization using Spatie Permission library (roles and permissions)

For Filament

• Admin panel with a custom theme initialized

What is included

• Filament 3
• Laravel 12
• Livewire 3
• TailwindCSS 4
• AlpineJS
• Spatie Permission
• Spatie Media Library

Filament plugins

• Filament Spatie Media Library

Dev

• Laravel Debugbar
• Pest
• Peck
• Larastan
• Cursor rules

Global Laravel Configurations included

For local

• Model::shouldBeStrict();:
  • Prevent lazy loading
  • Prevent silently discarding attributes
  • Prevent accessing missing attributes

For production

• Force HTTPs (URL::forceHttps(app()->isProduction()))
• Prohibit destructive database commands (DB::prohibitDestructiveCommands(app()->isProduction()))

Seeder

• Permission and role seeders
• User seeder

Quick Start

composer create-project tapp/filament-starter-kit

Install dependencies

composer install

npm install
npm run build

Setup environment

cp .env.example .env

# in the newly created .env file, configure your database:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE="filament_starter"
DB_USERNAME=root
DB_PASSWORD=

# Testing
DB_TEST_CONNECTION="mysql-test"
DB_TEST_HOST=127.0.0.1
DB_TEST_PORT=3306
DB_TEST_DATABASE="filament_starter_test"
DB_TEST_USERNAME=root
DB_TEST_PASSWORD=

Run database migrations

php artisan migrate --seed

This will create an admin user:

user: admin@dev.com
password: secret

and also an "Administrator" role and user permissions.

Contributing

Thank you for considering contributing to the Tapp Filament Starter Kit!

Security Vulnerabilities

If you discover a security vulnerability, please send an e-mail to Steve Williamson via steve@tappnetwork.com. All security vulnerabilities will be promptly addressed.

License

The Tapp Filament Starter Kit software is licensed under the MIT license.