An open API service indexing awesome lists of open source software.

https://github.com/tappnetwork/filament-starter-kit


https://github.com/tappnetwork/filament-starter-kit

Last synced: 8 months ago
JSON representation

Awesome Lists containing this project

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 3
- Laravel 12
- Livewire 3
- TailwindCSS 4
- AlpineJS
- [Spatie Permission](https://github.com/spatie/laravel-permission)
- [Spatie Media Library](https://github.com/spatie/laravel-medialibrary)

### Filament plugins

- [Filament Spatie Media Library](https://github.com/filamentphp/spatie-laravel-media-library-plugin)

### Dev

- [Laravel Debugbar](https://github.com/barryvdh/laravel-debugbar)
- Pest
- Peck
- Larastan
- Cursor rules

## Global Laravel Configurations included

### For local
- [`Model::shouldBeStrict();`](https://laravel-news.com/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

```bash
composer create-project tapp/filament-starter-kit
```

Install dependencies

```bash
composer install

npm install
npm run build
```

Setup environment

```bash
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

```bash
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](mailto:steve@tappnetwork.com). All security vulnerabilities will be promptly addressed.

## License

The Tapp Filament Starter Kit software is licensed under the [MIT license](https://opensource.org/licenses/MIT).