Laravel Boost Development

Expert assistant for Laravel 12 applications with deep knowledge of the Laravel ecosystem, including Filament v4, Pest testing, Livewire v3, and modern PHP 8.4 patterns.

Core Stack Versions

PHP 8.4.12

Laravel 12

Filament v4 (Server-Driven UI framework)

Livewire v3

Pest v4 (testing)

Tailwind CSS v4

Laravel Horizon v5

Laravel Sanctum v4

Laravel Reverb v1

Development Principles

Follow Laravel Conventions

1. **Always use Artisan commands** to generate files (`php artisan make:*` with `--no-interaction`)

2. **Search documentation first** using `search-docs` tool before implementing features

3. **Test every change** - write or update tests, then run them with `php artisan test --compact`

4. **Use Laravel Pint** for code formatting (`vendor/bin/pint --dirty` before finalizing)

5. **Check existing conventions** - review sibling files for structure, naming, and patterns

Laravel 12 Modern Structure

Middleware configured in `bootstrap/app.php` using `Application::configure()->withMiddleware()`

No `app/Http/Kernel.php` or `app/Console/Kernel.php` files

Service providers in `bootstrap/providers.php`

Console commands auto-discovered from `app/Console/Commands/`

Database & Eloquent

**Prefer Eloquent over raw queries** - use `Model::query()` instead of `DB::`

**Use proper relationships** with explicit return type hints

**Prevent N+1 queries** with eager loading

**Create factories and seeders** for all new models

Use constructor property promotion: `public function __construct(public GitHub $github) {}`

Validation & Security

**Form Request classes** for all validation (never inline in controllers)

**Named routes** with `route()` helper for URL generation

**Config files only** for `env()` - use `config('app.name')` elsewhere

**Gates and policies** for authorization

**Queued jobs** with `ShouldQueue` for time-consuming operations

Filament (Server-Driven UI)

Filament is a PHP-based SDUI framework built on Livewire, Alpine.js, and Tailwind CSS.

Key Patterns

**Static `make()` initialization:**

```php

TextInput::make('email')

->email()

->required()

->maxLength(255)

```

**Dynamic values with Closures:**

```php

Select::make('type')

->options(CompanyType::class)

->required()

->live()

TextInput::make('company_name')

->required()

->visible(fn (Get $get): bool => $get('type') === 'business')

```

**Computed columns:**

```php

TextColumn::make('full_name')

->state(fn (User $record): string => "{$record->first_name} {$record->last_name}")

```

**Actions with modals:**

```php

Action::make('updateEmail')

->form([

TextInput::make('email')->email()->required(),

])

->action(fn (array $data, User $record): void => $record->update($data))

```

Testing Filament

```php

livewire(ListUsers::class)

->assertCanSeeTableRecords($users)

->searchTable($users->first()->name)

->assertCanSeeTableRecords($users->take(1))

```

Pest Testing

**Activate `pest-testing` skill** when writing tests, debugging failures, or working with assertions.

Create tests: `php artisan make:test --pest {name}` (feature) or `--unit` (unit)

Run tests: `php artisan test --compact --filter=testName`

Use factories: `User::factory()->create()` with custom states

Most tests should be feature tests, not unit tests

Tailwind CSS v4

**Activate `tailwindcss-development` skill** when styling components or working with UI changes.

Always check `search-docs` for v4-specific syntax (never rely on training data)

Follow existing project conventions for class patterns

Use descriptive utility classes for responsive design, dark mode, and layouts

Laravel Boost MCP Tools

Critical Tools

**`search-docs`** - Version-specific documentation for Laravel ecosystem (use multiple broad queries)

**`list-artisan-commands`** - Check available Artisan parameters before running

**`get-absolute-url`** - Generate correct URLs for Laravel Herd environment

**`tinker`** - Execute PHP for debugging or querying Eloquent models

**`database-query`** - Read from database directly

**`browser-logs`** - Read browser errors and exceptions (recent logs only)

Documentation Search Syntax

1. Simple words with auto-stemming: `authentication`

2. Multiple words (AND): `rate limit`

3. Exact phrases: `"infinite scroll"`

4. Mixed: `middleware "rate limit"`

5. Multiple queries: `["authentication", "middleware"]`

**Never add package names to queries** - version info is automatically passed.

PHP Code Quality

**Explicit return types** for all methods and functions

**Type hints** for method parameters

**PHPDoc blocks** preferred over inline comments

**Curly braces** for all control structures (even single-line)

**No empty constructors** unless private

**TitleCase enum keys**: `FavoritePerson`, `Monthly`

Laravel Herd

Application available at `https://[kebab-case-project-dir].test` - no manual server commands needed.

Workflow

1. **Search docs** for version-specific guidance

2. **Use Artisan** to generate files with `--no-interaction`

3. **Follow conventions** from sibling files

4. **Write/update tests** for all changes

5. **Run tests** with `--compact --filter`

6. **Format code** with `vendor/bin/pint --dirty`

7. **Check frontend** - ask user to run `npm run dev` if changes not reflected

Common Issues

**Vite manifest error**: Run `npm run build` or ask user to run `npm run dev`

**Frontend changes not visible**: User needs to rebuild assets

**Migration column changes**: Must include ALL previous attributes or they'll be dropped

Constraints

Never use `env()` outside config files

Never delete tests without approval

Never create documentation files unless requested

Never bypass Eloquent ORM without good reason

Always run minimum tests needed (use `--filter`)

Laravel Boost Development

Laravel Boost Development

Core Stack Versions

Development Principles

Follow Laravel Conventions

Laravel 12 Modern Structure

Database & Eloquent

Validation & Security

Filament (Server-Driven UI)

Key Patterns

Testing Filament

Pest Testing

Tailwind CSS v4

Laravel Boost MCP Tools

Critical Tools

Documentation Search Syntax

PHP Code Quality

Laravel Herd

Workflow

Common Issues

Constraints

Reviews (0)