richardstyles/filament-laravel-starter-kit
最新稳定版本：v0.1
Composer 安装命令：
composer create-project richardstyles/filament-laravel-starter-kit
包简介
A Laravel 13 starter kit with Fortify, Livewire 4, Filament 5, Sanctum, Socialite, spatie/laravel-permission, Tailwind 4, and Pest 4 wired together.
README 文档
README
A Laravel 13 starter kit with authentication, two-factor, role-based authorization, profile management, an admin panel, OAuth social sign-in, and a token-authenticated API — wired together with Livewire 4, Filament 5, Tailwind 4, and Pest 4.
What's included
| Area | What you get |
|---|---|
| Authentication | Login, registration, password reset, email verification, two-factor (TOTP), browser-session management, account deletion — all Livewire 4 components driven by Filament Schemas and Fortify |
| Social sign-in | Socialite-backed GitHub + Google buttons on /login and /register, with a connected-accounts settings section |
| Authorization | spatie/laravel-permission with seeded admin and user roles, an example UserPolicy, and a before() admin-bypass pattern |
| Admin panel | Filament 5 panel at /admin, restricted to the admin role, with a UserResource for CRUD + role assignment |
| API | Sanctum-protected /api/v1/* (with /v1/user example) plus a settings section to issue and revoke personal-access tokens |
| Settings hub | Single /settings page with eight sections: profile + avatar upload, password, 2FA, appearance, API tokens, connected accounts, browser sessions, account deletion |
| Theming | Light / dark / system appearance toggle persisted per user, with a pre-paint script in the layout to prevent FOUC |
| Notifications | Filament's database notifications drawer wired through the navigation bell |
| Laravel's mail templates published and recolored to the kit's indigo palette | |
| Tooling | Pint, Larastan (level 5), Rector (PHP 8.3 + quality sets), Pest 4 (with Playwright browser tests), GitHub Actions matrix on PHP 8.3/8.4 |
| Quality | composer check runs lint, static analysis, refactor dry-run, and the full test suite as one command |
Requirements
- PHP 8.3+
- Composer 2
- Node 20+ and npm
- A PostgreSQL or MySQL database
- A Redis instance (optional — defaults to database queue and cache)
Install
composer create-project richardstyles/filament-laravel-starter-kit my-app
cd my-app
composer setup
composer setup copies .env.example to .env, generates an app key, runs migrations, installs npm packages, and builds frontend assets.
If you cloned directly:
composer install cp .env.example .env php artisan key:generate php artisan migrate --seed php artisan storage:link npm install npm run build
The seeder creates a test admin (test@example.com / password) and five regular users.
Running locally
composer dev
This launches php artisan serve, the queue worker, the log tailer, and the Vite dev server concurrently.
Quality commands
composer lint # apply Pint formatting composer lint:test # check Pint without applying changes (CI-safe) composer analyse # run Larastan composer refactor # apply Rector transforms composer refactor:dry # preview Rector changes composer test # run the Pest suite composer check # all of the above as one command
OAuth setup
Drop the credentials in .env:
GITHUB_CLIENT_ID= GITHUB_CLIENT_SECRET= GITHUB_REDIRECT_URI="${APP_URL}/auth/github/callback" GOOGLE_CLIENT_ID= GOOGLE_CLIENT_SECRET= GOOGLE_REDIRECT_URI="${APP_URL}/auth/google/callback"
Toggle which providers appear via SOCIALITE_PROVIDERS (comma-separated). Add new providers by extending config/services.php and the SocialController whitelist.
Customizing
| Want to... | Edit |
|---|---|
| Change the brand name | APP_NAME in .env, the logo <img> in resources/views/livewire/navigation.blade.php and resources/views/welcome.blade.php |
| Change the brand color | Color::Indigo in app/Providers/Filament/AdminPanelProvider.php, indigo classes in views, #4f46e5 in resources/views/vendor/mail/html/themes/default.css |
| Add a navigation link | The $links array at the top of resources/views/livewire/navigation.blade.php |
| Add a settings section | Create a Livewire component, add @livewire(...) to resources/views/livewire/settings/index.blade.php |
| Add a Filament resource | php artisan make:filament-resource Foo --generate |
| Disable email verification | FORTIFY_EMAIL_VERIFICATION=false in .env |
| Add a locale | Drop lang/{locale}/*.php files mirroring lang/en/, set APP_LOCALE |
License
Released under the MIT license. See LICENSE.
统计信息
- 总下载量： 14
- 月度下载量： 0
- 日度下载量： 0
- 收藏数： 0
- 点击次数： 2
- 依赖项目数： 0
- 推荐数： 0
其他信息
- 授权协议： MIT
- 更新时间： 2026-04-25