tapp/filament-starter-kit

The Tapp Filament Starter Kit.


README

Tapp Filament Starter Kit Light Logo

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 plugins

Dev

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.