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

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

License

Released under the MIT license. See LICENSE.