@elyracode/stack-filament 0.4.1

package/skills/filament/SKILL.md

@@ -0,0 +1,1841 @@
+---
+name: filament
+description: Deep knowledge of Filament v5 for Laravel. Use when building admin panels, CRUD resources, data tables, forms, actions, widgets, dashboards, multi-tenancy, or any Filament feature in a Laravel application.
+---
+
+# Filament v5 Reference
+
+## Installation
+
+```bash
+composer require filament/filament
+php artisan filament:install --panels
+```
+
+Create the first admin user:
+
+```bash
+php artisan make:filament-user
+```
+
+## Artisan Commands
+
+```bash
+php artisan make:filament-resource Customer
+php artisan make:filament-resource Customer --generate  # Auto-generate form/table from DB columns
+php artisan make:filament-resource Customer --simple     # Modal CRUD (no separate create/edit pages)
+php artisan make:filament-resource Customer --soft-deletes
+php artisan make:filament-resource Customer --view       # Include a view page
+php artisan make:filament-page Settings
+php artisan make:filament-widget SalesChart --chart
+php artisan make:filament-widget LatestOrders --table
+php artisan make:filament-relation-manager CategoryResource posts title
+php artisan make:filament-cluster Settings
+```
+
+## Panel Configuration
+
+```php
+// app/Providers/Filament/AdminPanelProvider.php
+use Filament\Panel;
+use Filament\PanelProvider;
+use Filament\Support\Colors\Color;
+
+class AdminPanelProvider extends PanelProvider
+{
+    public function panel(Panel $panel): Panel
+    {
+        return $panel
+            ->default()
+            ->id('admin')
+            ->path('admin')
+            ->login()
+            ->registration()
+            ->passwordReset()
+            ->emailVerification()
+            ->colors([
+                'primary' => Color::Indigo,
+                'danger' => Color::Rose,
+                'gray' => Color::Zinc,
+                'success' => Color::Emerald,
+                'warning' => Color::Amber,
+            ])
+            ->font('Inter')
+            ->brandName('My App')
+            ->brandLogo(asset('images/logo.svg'))
+            ->favicon(asset('images/favicon.png'))
+            ->sidebarCollapsibleOnDesktop()
+            ->maxContentWidth('full')
+            ->discoverResources(in: app_path('Filament/Resources'), for: 'App\\Filament\\Resources')
+            ->discoverPages(in: app_path('Filament/Pages'), for: 'App\\Filament\\Pages')
+            ->discoverWidgets(in: app_path('Filament/Widgets'), for: 'App\\Filament\\Widgets')
+            ->discoverClusters(in: app_path('Filament/Clusters'), for: 'App\\Filament\\Clusters')
+            ->middleware([...])
+            ->authMiddleware([...])
+            ->databaseNotifications()
+            ->spa();
+    }
+}
+```
+
+## Resources (CRUD)
+
+### v5 File Structure
+
+```
+app/Filament/Resources/Customers/
+  CustomerResource.php        # Main resource class
+  Pages/
+    CreateCustomer.php
+    EditCustomer.php
+    ListCustomers.php
+    ViewCustomer.php          # Optional
+  Schemas/
+    CustomerForm.php          # Form schema (split from resource)
+  Tables/
+    CustomersTable.php        # Table definition (split from resource)
+```
+
+### Resource Class
+
+```php
+<?php
+
+namespace App\Filament\Resources\Customers;
+
+use App\Models\Customer;
+use Filament\Resources\Resource;
+use Filament\Schemas\Schema;
+use Filament\Tables\Table;
+
+class CustomerResource extends Resource
+{
+    protected static ?string $model = Customer::class;
+    protected static ?string $navigationIcon = 'heroicon-o-user-group';
+    protected static ?string $navigationGroup = 'Shop';
+    protected static ?int $navigationSort = 2;
+    protected static ?string $recordTitleAttribute = 'name';
+    protected static ?string $slug = 'customers';
+
+    public static function form(Schema $schema): Schema
+    {
+        return CustomerForm::configure($schema);
+    }
+
+    public static function table(Table $table): Table
+    {
+        return CustomersTable::configure($table);
+    }
+
+    public static function getRelations(): array
+    {
+        return [
+            OrdersRelationManager::class,
+        ];
+    }
+
+    public static function getPages(): array
+    {
+        return [
+            'index' => ListCustomers::route('/'),
+            'create' => CreateCustomer::route('/create'),
+            'edit' => EditCustomer::route('/{record}/edit'),
+        ];
+    }
+
+    public static function getGloballySearchableAttributes(): array
+    {
+        return ['name', 'email', 'phone'];
+    }
+
+    public static function getGlobalSearchResultDetails(\Illuminate\Database\Eloquent\Model $record): array
+    {
+        return [
+            'Email' => $record->email,
+        ];
+    }
+}
+```
+
+### Form Schema Class (v5 split pattern)
+
+```php
+<?php
+
+namespace App\Filament\Resources\Customers\Schemas;
+
+use Filament\Forms\Components\TextInput;
+use Filament\Forms\Components\Select;
+use Filament\Forms\Components\DatePicker;
+use Filament\Forms\Components\Toggle;
+use Filament\Schemas\Components\Section;
+use Filament\Schemas\Components\Grid;
+use Filament\Schemas\Schema;
+
+class CustomerForm
+{
+    public static function configure(Schema $schema): Schema
+    {
+        return $schema->components([
+            Section::make('Personal Information')
+                ->schema([
+                    Grid::make(2)->schema([
+                        TextInput::make('name')
+                            ->required()
+                            ->maxLength(255),
+                        TextInput::make('email')
+                            ->email()
+                            ->required()
+                            ->unique(ignoreRecord: true),
+                    ]),
+                    TextInput::make('phone')
+                        ->tel(),
+                    DatePicker::make('date_of_birth')
+                        ->native(false)
+                        ->maxDate(now()),
+                ]),
+            Section::make('Settings')
+                ->schema([
+                    Select::make('status')
+                        ->options([
+                            'active' => 'Active',
+                            'inactive' => 'Inactive',
+                            'blocked' => 'Blocked',
+                        ])
+                        ->default('active')
+                        ->required(),
+                    Toggle::make('is_vip')
+                        ->label('VIP Customer'),
+                ])
+                ->collapsible(),
+        ]);
+    }
+}
+```
+
+### Table Class (v5 split pattern)
+
+```php
+<?php
+
+namespace App\Filament\Resources\Customers\Tables;
+
+use Filament\Tables\Table;
+use Filament\Tables\Columns\TextColumn;
+use Filament\Tables\Columns\IconColumn;
+use Filament\Tables\Filters\SelectFilter;
+use Filament\Actions\EditAction;
+use Filament\Actions\DeleteBulkAction;
+use Filament\Actions\BulkActionGroup;
+
+class CustomersTable
+{
+    public static function configure(Table $table): Table
+    {
+        return $table
+            ->columns([
+                TextColumn::make('name')
+                    ->searchable()
+                    ->sortable(),
+                TextColumn::make('email')
+                    ->searchable()
+                    ->copyable(),
+                TextColumn::make('status')
+                    ->badge()
+                    ->color(fn (string $state): string => match ($state) {
+                        'active' => 'success',
+                        'inactive' => 'gray',
+                        'blocked' => 'danger',
+                    }),
+                IconColumn::make('is_vip')
+                    ->boolean(),
+                TextColumn::make('created_at')
+                    ->dateTime()
+                    ->sortable()
+                    ->toggleable(isToggledHiddenByDefault: true),
+            ])
+            ->filters([
+                SelectFilter::make('status')
+                    ->options([
+                        'active' => 'Active',
+                        'inactive' => 'Inactive',
+                        'blocked' => 'Blocked',
+                    ]),
+            ])
+            ->recordActions([
+                EditAction::make(),
+            ])
+            ->toolbarActions([
+                BulkActionGroup::make([
+                    DeleteBulkAction::make(),
+                ]),
+            ]);
+    }
+}
+```
+
+### Page Classes
+
+```php
+// Pages/ListCustomers.php
+<?php
+
+namespace App\Filament\Resources\Customers\Pages;
+
+use App\Filament\Resources\Customers\CustomerResource;
+use Filament\Resources\Pages\ListRecords;
+use Filament\Actions\CreateAction;
+
+class ListCustomers extends ListRecords
+{
+    protected static string $resource = CustomerResource::class;
+
+    protected function getHeaderActions(): array
+    {
+        return [CreateAction::make()];
+    }
+}
+
+// Pages/CreateCustomer.php
+<?php
+
+namespace App\Filament\Resources\Customers\Pages;
+
+use App\Filament\Resources\Customers\CustomerResource;
+use Filament\Resources\Pages\CreateRecord;
+
+class CreateCustomer extends CreateRecord
+{
+    protected static string $resource = CustomerResource::class;
+
+    protected function getRedirectUrl(): string
+    {
+        return $this->getResource()::getUrl('index');
+    }
+
+    protected function mutateFormDataBeforeCreate(array $data): array
+    {
+        $data['created_by'] = auth()->id();
+        return $data;
+    }
+}
+
+// Pages/EditCustomer.php
+<?php
+
+namespace App\Filament\Resources\Customers\Pages;
+
+use App\Filament\Resources\Customers\CustomerResource;
+use Filament\Resources\Pages\EditRecord;
+use Filament\Actions\DeleteAction;
+
+class EditCustomer extends EditRecord
+{
+    protected static string $resource = CustomerResource::class;
+
+    protected function getHeaderActions(): array
+    {
+        return [DeleteAction::make()];
+    }
+
+    protected function afterSave(): void
+    {
+        // Hook after record is saved
+    }
+}
+```
+
+## Tables
+
+### Column Types
+
+```php
+use Filament\Tables\Columns\TextColumn;
+use Filament\Tables\Columns\IconColumn;
+use Filament\Tables\Columns\ImageColumn;
+use Filament\Tables\Columns\SelectColumn;
+use Filament\Tables\Columns\ToggleColumn;
+use Filament\Tables\Columns\CheckboxColumn;
+use Filament\Tables\Columns\ColorColumn;
+use Filament\Tables\Columns\TextInputColumn;
+
+// Text column variants
+TextColumn::make('name')->searchable()->sortable()->copyable()
+TextColumn::make('email')->icon('heroicon-m-envelope')
+TextColumn::make('created_at')->dateTime('M j, Y')->sortable()
+TextColumn::make('amount')->money('USD')->sortable()
+TextColumn::make('size')->formatStateUsing(fn (int $state): string => number_format($state / 1024, 2) . ' KB')
+TextColumn::make('tags')->badge()->separator(',')
+TextColumn::make('description')->limit(50)->tooltip(fn ($record) => $record->description)
+TextColumn::make('status')->badge()->color(fn (string $state): string => match ($state) {
+    'draft' => 'gray',
+    'reviewing' => 'warning',
+    'published' => 'success',
+    'rejected' => 'danger',
+})
+TextColumn::make('author.name')  // Dot-notation auto-eager-loads relationships
+TextColumn::make('tags.name')->badge()  // HasMany / BelongsToMany
+
+// Other column types
+IconColumn::make('is_featured')->boolean()
+ImageColumn::make('avatar')->circular()->size(40)
+ToggleColumn::make('is_active')  // Inline toggle, updates DB immediately
+SelectColumn::make('status')->options([...])  // Inline select
+CheckboxColumn::make('is_verified')
+ColorColumn::make('hex_color')
+TextInputColumn::make('sort_order')->rules(['required', 'integer'])  // Inline editable
+```
+
+### Column Formatting
+
+```php
+TextColumn::make('price')->money('USD')              // $1,234.56
+TextColumn::make('views')->numeric(decimalPlaces: 0) // 1,234
+TextColumn::make('created_at')->since()               // 3 hours ago
+TextColumn::make('birthday')->date('F j, Y')          // January 1, 2000
+TextColumn::make('duration')->time()                   // 12:30:00
+TextColumn::make('total')
+    ->summarize([
+        Sum::make()->label('Total'),
+        Average::make()->label('Average'),
+    ])
+```
+
+### Column Toggleability
+
+```php
+TextColumn::make('created_at')
+    ->toggleable()                                // User can show/hide
+TextColumn::make('updated_at')
+    ->toggleable(isToggledHiddenByDefault: true)  // Hidden by default
+```
+
+### Filters
+
+```php
+use Filament\Tables\Filters\Filter;
+use Filament\Tables\Filters\SelectFilter;
+use Filament\Tables\Filters\TernaryFilter;
+use Filament\Tables\Filters\QueryBuilder;
+use Filament\Tables\Filters\QueryBuilder\Constraints\TextConstraint;
+use Filament\Tables\Filters\QueryBuilder\Constraints\DateConstraint;
+use Filament\Tables\Filters\QueryBuilder\Constraints\NumberConstraint;
+use Illuminate\Database\Eloquent\Builder;
+
+// Simple query filter
+Filter::make('is_featured')
+    ->query(fn (Builder $query) => $query->where('is_featured', true))
+    ->toggle()  // Shows as a toggle instead of checkbox
+
+// Select filter
+SelectFilter::make('status')
+    ->options([
+        'draft' => 'Draft',
+        'published' => 'Published',
+        'archived' => 'Archived',
+    ])
+    ->multiple()  // Allow selecting multiple values
+
+// Relationship filter
+SelectFilter::make('category')
+    ->relationship('category', 'name')
+    ->searchable()
+    ->preload()
+
+// Ternary filter (yes / no / any)
+TernaryFilter::make('email_verified')
+    ->nullable()  // Uses whereNull / whereNotNull
+    ->label('Email verified')
+
+// Custom form filter
+Filter::make('created_at')
+    ->schema([
+        DatePicker::make('created_from'),
+        DatePicker::make('created_until'),
+    ])
+    ->query(function (Builder $query, array $data): Builder {
+        return $query
+            ->when($data['created_from'], fn (Builder $q, $date) => $q->whereDate('created_at', '>=', $date))
+            ->when($data['created_until'], fn (Builder $q, $date) => $q->whereDate('created_at', '<=', $date));
+    })
+    ->indicateUsing(function (array $data): array {
+        $indicators = [];
+        if ($data['created_from'] ?? null) {
+            $indicators[] = 'Created from ' . Carbon::parse($data['created_from'])->toFormattedDateString();
+        }
+        if ($data['created_until'] ?? null) {
+            $indicators[] = 'Created until ' . Carbon::parse($data['created_until'])->toFormattedDateString();
+        }
+        return $indicators;
+    })
+
+// Advanced query builder (user-facing filter UI)
+QueryBuilder::make()
+    ->constraints([
+        TextConstraint::make('name'),
+        DateConstraint::make('created_at'),
+        NumberConstraint::make('amount'),
+    ])
+```
+
+### Table Actions
+
+```php
+use Filament\Actions\Action;
+use Filament\Actions\EditAction;
+use Filament\Actions\ViewAction;
+use Filament\Actions\DeleteAction;
+use Filament\Actions\ForceDeleteAction;
+use Filament\Actions\RestoreAction;
+use Filament\Actions\ReplicateAction;
+use Filament\Actions\BulkActionGroup;
+use Filament\Actions\DeleteBulkAction;
+use Filament\Actions\ForceDeleteBulkAction;
+use Filament\Actions\RestoreBulkAction;
+use Filament\Actions\ExportAction;
+use Filament\Actions\ImportAction;
+
+$table
+    ->recordActions([
+        ViewAction::make(),
+        EditAction::make(),
+        DeleteAction::make(),
+        ReplicateAction::make()
+            ->excludeAttributes(['slug']),
+        Action::make('feature')
+            ->icon('heroicon-o-star')
+            ->action(fn (Post $record) => $record->update(['is_featured' => true]))
+            ->requiresConfirmation()
+            ->hidden(fn (Post $record): bool => $record->is_featured)
+            ->color('warning'),
+        ForceDeleteAction::make(),
+        RestoreAction::make(),
+    ])
+    ->toolbarActions([
+        BulkActionGroup::make([
+            DeleteBulkAction::make(),
+            ForceDeleteBulkAction::make(),
+            RestoreBulkAction::make(),
+            ExportAction::make()->exporter(CustomerExporter::class),
+        ]),
+        ImportAction::make()->importer(CustomerImporter::class),
+    ])
+```
+
+### Table Configuration
+
+```php
+$table
+    ->paginated([10, 25, 50, 100])
+    ->defaultPaginationPageOption(25)
+    ->defaultSort('created_at', 'desc')
+    ->striped()
+    ->deferLoading()
+    ->poll('10s')
+    ->reorderable('sort')
+    ->heading('Clients')
+    ->description('Manage your clients')
+    ->emptyStateHeading('No clients yet')
+    ->emptyStateDescription('Create your first client to get started.')
+    ->emptyStateIcon('heroicon-o-users')
+    ->groups([
+        Group::make('status')->collapsible(),
+        Group::make('category.name')->label('Category'),
+    ])
+    ->modifyQueryUsing(fn (Builder $query) => $query->withoutTrashed())
+    ->recordUrl(fn (Model $record): string => route('customers.show', $record))
+    ->recordClasses(fn (Model $record) => match ($record->status) {
+        'blocked' => 'opacity-50',
+        default => '',
+    })
+```
+
+## Forms
+
+### Field Types
+
+```php
+use Filament\Forms\Components\TextInput;
+use Filament\Forms\Components\Textarea;
+use Filament\Forms\Components\Select;
+use Filament\Forms\Components\Checkbox;
+use Filament\Forms\Components\Toggle;
+use Filament\Forms\Components\CheckboxList;
+use Filament\Forms\Components\Radio;
+use Filament\Forms\Components\DatePicker;
+use Filament\Forms\Components\DateTimePicker;
+use Filament\Forms\Components\TimePicker;
+use Filament\Forms\Components\FileUpload;
+use Filament\Forms\Components\RichEditor;
+use Filament\Forms\Components\MarkdownEditor;
+use Filament\Forms\Components\Repeater;
+use Filament\Forms\Components\Builder;
+use Filament\Forms\Components\TagsInput;
+use Filament\Forms\Components\KeyValue;
+use Filament\Forms\Components\ColorPicker;
+use Filament\Forms\Components\ToggleButtons;
+use Filament\Forms\Components\Hidden;
+use Filament\Forms\Components\Slider;
+use Filament\Forms\Components\CodeEditor;
+```
+
+### TextInput Patterns
+
+```php
+TextInput::make('name')
+    ->required()
+    ->maxLength(255)
+    ->autofocus()
+    ->placeholder('Enter customer name')
+
+TextInput::make('slug')
+    ->required()
+    ->unique(ignoreRecord: true)
+    ->alphaDash()
+
+TextInput::make('price')
+    ->numeric()
+    ->prefix('$')
+    ->step(0.01)
+    ->minValue(0)
+    ->maxValue(999999.99)
+
+TextInput::make('email')
+    ->email()
+    ->required()
+    ->unique(ignoreRecord: true)
+
+TextInput::make('phone')
+    ->tel()
+    ->mask('(999) 999-9999')
+
+TextInput::make('password')
+    ->password()
+    ->revealable()
+    ->confirmed()  // Requires a password_confirmation field
+    ->dehydrateStateUsing(fn (string $state): string => Hash::make($state))
+    ->dehydrated(fn (?string $state): bool => filled($state))  // Skip if empty on edit
+    ->required(fn (string $operation): bool => $operation === 'create')
+```
+
+### Select Patterns
+
+```php
+// Static options
+Select::make('status')
+    ->options([
+        'draft' => 'Draft',
+        'reviewing' => 'Reviewing',
+        'published' => 'Published',
+    ])
+    ->default('draft')
+    ->required()
+
+// From relationship
+Select::make('category_id')
+    ->relationship('category', 'name')
+    ->searchable()
+    ->preload()
+    ->createOptionForm([
+        TextInput::make('name')->required(),
+        TextInput::make('slug')->required(),
+    ])
+    ->editOptionForm([
+        TextInput::make('name')->required(),
+        TextInput::make('slug')->required(),
+    ])
+
+// Multiple select
+Select::make('tags')
+    ->multiple()
+    ->relationship('tags', 'name')
+    ->preload()
+
+// Dependent selects
+Select::make('country_id')
+    ->options(Country::pluck('name', 'id'))
+    ->live()
+    ->afterStateUpdated(fn (Set $set) => $set('city_id', null))
+
+Select::make('city_id')
+    ->options(fn (Get $get): array =>
+        City::where('country_id', $get('country_id'))->pluck('name', 'id')->toArray())
+    ->searchable()
+```
+
+### Date & Time
+
+```php
+DatePicker::make('published_at')
+    ->native(false)           // Use Filament date picker instead of browser native
+    ->default(now())
+    ->minDate(now())
+    ->maxDate(now()->addYear())
+    ->displayFormat('d/m/Y')
+    ->closeOnDateSelection()
+
+DateTimePicker::make('starts_at')
+    ->native(false)
+    ->seconds(false)          // Hide seconds
+    ->minutesStep(15)         // 15-minute intervals
+    ->timezone('America/New_York')
+
+TimePicker::make('opening_time')
+    ->native(false)
+    ->seconds(false)
+```
+
+### File Uploads
+
+```php
+FileUpload::make('avatar')
+    ->image()
+    ->directory('avatars')
+    ->disk('public')
+    ->imageEditor()
+    ->imageResizeMode('cover')
+    ->imageCropAspectRatio('1:1')
+    ->imageResizeTargetWidth('300')
+    ->imageResizeTargetHeight('300')
+    ->maxSize(2048)           // 2MB in KB
+
+FileUpload::make('attachments')
+    ->multiple()
+    ->directory('attachments')
+    ->acceptedFileTypes(['application/pdf', 'image/*'])
+    ->maxFiles(5)
+    ->reorderable()
+    ->downloadable()
+    ->openable()
+    ->previewable()
+```
+
+### Rich Text & Markdown
+
+```php
+RichEditor::make('body')
+    ->required()
+    ->columnSpanFull()
+    ->toolbarButtons([
+        'bold', 'italic', 'underline', 'strike',
+        'h2', 'h3',
+        'bulletList', 'orderedList',
+        'link', 'blockquote', 'codeBlock',
+        'attachFiles',
+    ])
+    ->fileAttachmentsDisk('public')
+    ->fileAttachmentsDirectory('attachments')
+
+MarkdownEditor::make('content')
+    ->columnSpanFull()
+    ->toolbarButtons([
+        'bold', 'italic', 'strike',
+        'heading', 'bulletList', 'orderedList',
+        'link', 'codeBlock', 'attachFiles',
+    ])
+```
+
+### Repeater & Builder
+
+```php
+// Repeater -- ordered list of identical items
+Repeater::make('line_items')
+    ->schema([
+        Select::make('product_id')
+            ->options(Product::pluck('name', 'id'))
+            ->required()
+            ->columnSpan(2),
+        TextInput::make('quantity')
+            ->numeric()
+            ->default(1)
+            ->minValue(1)
+            ->required(),
+        TextInput::make('unit_price')
+            ->numeric()
+            ->prefix('$')
+            ->required(),
+    ])
+    ->columns(4)
+    ->defaultItems(1)
+    ->addActionLabel('Add line item')
+    ->reorderable()
+    ->collapsible()
+    ->cloneable()
+    ->minItems(1)
+    ->maxItems(20)
+    ->itemLabel(fn (array $state): ?string => $state['product_id'] ?? null)
+
+// Builder -- flexible block-based content
+Builder::make('content')
+    ->blocks([
+        Builder\Block::make('heading')
+            ->schema([
+                TextInput::make('content')->required(),
+                Select::make('level')
+                    ->options(['h2' => 'H2', 'h3' => 'H3', 'h4' => 'H4'])
+                    ->default('h2'),
+            ]),
+        Builder\Block::make('paragraph')
+            ->schema([
+                RichEditor::make('content')->required(),
+            ]),
+        Builder\Block::make('image')
+            ->schema([
+                FileUpload::make('url')->image()->required(),
+                TextInput::make('alt')->required(),
+            ]),
+        Builder\Block::make('call_to_action')
+            ->schema([
+                TextInput::make('label')->required(),
+                TextInput::make('url')->url()->required(),
+            ]),
+    ])
+    ->collapsible()
+    ->blockNumbers(false)
+```
+
+### Other Field Types
+
+```php
+Toggle::make('is_active')
+    ->label('Active')
+    ->default(true)
+    ->onColor('success')
+    ->offColor('danger')
+
+ToggleButtons::make('status')
+    ->inline()
+    ->options([
+        'draft' => 'Draft',
+        'published' => 'Published',
+        'archived' => 'Archived',
+    ])
+    ->colors([
+        'draft' => 'info',
+        'published' => 'success',
+        'archived' => 'warning',
+    ])
+    ->icons([
+        'draft' => 'heroicon-o-pencil',
+        'published' => 'heroicon-o-check-circle',
+        'archived' => 'heroicon-o-archive-box',
+    ])
+
+CheckboxList::make('roles')
+    ->relationship('roles', 'name')
+    ->columns(2)
+
+Radio::make('plan')
+    ->options([
+        'free' => 'Free',
+        'pro' => 'Pro',
+        'enterprise' => 'Enterprise',
+    ])
+    ->descriptions([
+        'free' => 'Up to 5 projects',
+        'pro' => 'Unlimited projects',
+        'enterprise' => 'Custom limits',
+    ])
+
+TagsInput::make('tags')
+    ->separator(',')
+    ->suggestions(['Laravel', 'PHP', 'Filament'])
+
+KeyValue::make('metadata')
+    ->keyLabel('Key')
+    ->valueLabel('Value')
+    ->reorderable()
+
+ColorPicker::make('color')
+    ->hex()
+
+Hidden::make('user_id')
+    ->default(auth()->id())
+```
+
+### Reactive Fields (live)
+
+```php
+use Filament\Forms\Get;
+use Filament\Forms\Set;
+
+TextInput::make('title')
+    ->live(debounce: 500)       // Debounce server round-trips by 500ms
+    ->afterStateUpdated(fn (Set $set, ?string $state) =>
+        $set('slug', Str::slug($state)))
+
+TextInput::make('slug')
+    ->required()
+    ->unique(ignoreRecord: true)
+
+// Conditional visibility (server-side)
+TextInput::make('other_reason')
+    ->visible(fn (Get $get): bool => $get('reason') === 'other')
+
+// JS-side reactivity (no server round-trip)
+Toggle::make('is_admin')
+TextInput::make('admin_notes')
+    ->hiddenJs(<<<'JS' $get('is_admin') !== true JS)
+
+// Calculated fields
+TextInput::make('quantity')->numeric()->live()
+TextInput::make('unit_price')->numeric()->live()
+TextInput::make('total')
+    ->numeric()
+    ->readOnly()
+    ->dehydrated(false)
+    ->afterStateHydrated(function (Get $get, Set $set) {
+        $set('total', ($get('quantity') ?? 0) * ($get('unit_price') ?? 0));
+    })
+```
+
+### Utility Injection Parameters
+
+Closures used in field configuration receive named parameters via dependency injection:
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `$state` | `mixed` | Current field value |
+| `$get` | `Get` | Get sibling field values: `$get('field_name')` |
+| `$set` | `Set` | Set sibling field values: `$set('field_name', $value)` |
+| `$record` | `?Model` | Current Eloquent record (null on create) |
+| `$operation` | `string` | `'create'`, `'edit'`, or `'view'` |
+| `$livewire` | `Component` | Parent Livewire component instance |
+| `$component` | `Component` | The field component instance itself |
+| `$model` | `string` | Model class name |
+
+### Validation
+
+```php
+TextInput::make('name')
+    ->required()
+    ->minLength(2)
+    ->maxLength(255)
+    ->rules(['alpha_dash'])
+    ->unique(table: 'users', column: 'name', ignoreRecord: true)
+    ->exists(table: 'categories', column: 'slug')
+    ->requiredWith('other_field')
+    ->prohibitedUnless('status', 'active')
+
+// Custom validation
+TextInput::make('code')
+    ->rules([
+        fn (): \Closure => function (string $attribute, $value, \Closure $fail) {
+            if (! preg_match('/^[A-Z]{3}-\d{4}$/', $value)) {
+                $fail('The code must match the format XXX-0000.');
+            }
+        },
+    ])
+```
+
+## Schemas (Layouts)
+
+```php
+use Filament\Schemas\Components\Grid;
+use Filament\Schemas\Components\Flex;
+use Filament\Schemas\Components\Section;
+use Filament\Schemas\Components\Tabs;
+use Filament\Schemas\Components\Wizard;
+use Filament\Schemas\Components\Fieldset;
+use Filament\Schemas\Components\Callout;
+use Filament\Schemas\Components\EmptyState;
+
+// Grid layout
+Grid::make(2)->schema([
+    TextInput::make('first_name'),
+    TextInput::make('last_name'),
+])
+
+// Columns on individual fields
+TextInput::make('description')->columnSpan(2)
+TextInput::make('notes')->columnSpanFull()
+
+// Section with header
+Section::make('Contact Information')
+    ->description('How can we reach this customer?')
+    ->schema([...])
+    ->collapsible()
+    ->collapsed()       // Start collapsed
+    ->icon('heroicon-o-phone')
+    ->columns(2)
+    ->aside()           // Show section content beside the header
+
+// Tabs
+Tabs::make('Settings')
+    ->tabs([
+        Tabs\Tab::make('General')
+            ->icon('heroicon-o-cog-6-tooth')
+            ->schema([...]),
+        Tabs\Tab::make('Security')
+            ->icon('heroicon-o-lock-closed')
+            ->schema([...])
+            ->badge(5),     // Show badge count
+        Tabs\Tab::make('Notifications')
+            ->schema([...]),
+    ])
+    ->persistTabInQueryString()  // Remember selected tab in URL
+
+// Wizard (multi-step form)
+Wizard::make([
+    Wizard\Step::make('Account')
+        ->description('Set up your account')
+        ->schema([
+            TextInput::make('email')->email()->required(),
+            TextInput::make('password')->password()->required(),
+        ])
+        ->icon('heroicon-o-user'),
+    Wizard\Step::make('Profile')
+        ->description('Tell us about yourself')
+        ->schema([
+            TextInput::make('name')->required(),
+            FileUpload::make('avatar')->image(),
+        ]),
+    Wizard\Step::make('Billing')
+        ->schema([...]),
+])
+->skippable()             // Allow skipping steps
+->submitAction(view('filament.wizard-submit'))
+
+// Fieldset
+Fieldset::make('Address')
+    ->schema([
+        TextInput::make('street'),
+        TextInput::make('city'),
+        TextInput::make('state'),
+        TextInput::make('zip'),
+    ])
+    ->columns(2)
+
+// Callout
+Callout::make()
+    ->info()
+    ->content('This resource is read-only because the record is archived.')
+```
+
+## Actions & Modals
+
+```php
+use Filament\Actions\Action;
+
+// Simple confirmation
+Action::make('delete')
+    ->requiresConfirmation()
+    ->modalHeading('Delete record')
+    ->modalDescription('Are you sure you want to delete this record? This cannot be undone.')
+    ->modalSubmitActionLabel('Yes, delete')
+    ->action(fn () => $this->record->delete())
+    ->color('danger')
+    ->icon('heroicon-o-trash')
+
+// With modal form
+Action::make('sendEmail')
+    ->icon('heroicon-o-envelope')
+    ->schema([
+        TextInput::make('subject')->required(),
+        RichEditor::make('body')->required(),
+    ])
+    ->action(function (array $data) {
+        Mail::to($this->record->email)->send(
+            new GenericEmail($data['subject'], $data['body'])
+        );
+        Notification::make()->title('Email sent')->success()->send();
+    })
+
+// Button styles
+Action::make('save')->button()
+Action::make('edit')->link()
+Action::make('delete')->iconButton()->icon('heroicon-m-trash')
+Action::make('info')->badge()
+Action::make('export')->outlined()
+
+// Grouped actions
+\Filament\Actions\ActionGroup::make([
+    Action::make('view'),
+    Action::make('edit'),
+    Action::make('delete'),
+])->icon('heroicon-m-ellipsis-vertical')
+
+// Action with custom URL
+Action::make('visit')
+    ->url(fn (): string => route('posts.show', $this->record))
+    ->openUrlInNewTab()
+
+// Header actions on pages
+protected function getHeaderActions(): array
+{
+    return [
+        Action::make('export')
+            ->action(fn () => $this->export())
+            ->color('gray'),
+        \Filament\Actions\CreateAction::make(),
+    ];
+}
+```
+
+## Widgets & Dashboard
+
+### Stats Overview
+
+```php
+use Filament\Widgets\StatsOverviewWidget;
+use Filament\Widgets\StatsOverviewWidget\Stat;
+
+class StatsOverview extends StatsOverviewWidget
+{
+    protected static ?int $sort = 1;
+
+    protected function getStats(): array
+    {
+        return [
+            Stat::make('Total Revenue', '$' . number_format(Order::sum('total'), 2))
+                ->description('32% increase')
+                ->descriptionIcon('heroicon-m-arrow-trending-up')
+                ->color('success')
+                ->chart([7, 2, 10, 3, 15, 4, 17]),
+            Stat::make('New Customers', Customer::whereMonth('created_at', now()->month)->count())
+                ->description('3% decrease')
+                ->descriptionIcon('heroicon-m-arrow-trending-down')
+                ->color('danger'),
+            Stat::make('Active Orders', Order::where('status', 'processing')->count())
+                ->description('21 shipped today')
+                ->color('info'),
+        ];
+    }
+}
+```
+
+### Chart Widget
+
+```php
+use Filament\Widgets\ChartWidget;
+
+class RevenueChart extends ChartWidget
+{
+    protected static ?string $heading = 'Monthly Revenue';
+    protected static ?int $sort = 2;
+    protected static ?string $maxHeight = '300px';
+    protected int|string|array $columnSpan = 'full';
+
+    protected function getData(): array
+    {
+        $data = Order::selectRaw('MONTH(created_at) as month, SUM(total) as revenue')
+            ->whereYear('created_at', now()->year)
+            ->groupBy('month')
+            ->pluck('revenue', 'month')
+            ->toArray();
+
+        return [
+            'datasets' => [
+                [
+                    'label' => 'Revenue',
+                    'data' => array_values($data),
+                    'backgroundColor' => '#36A2EB',
+                    'borderColor' => '#36A2EB',
+                ],
+            ],
+            'labels' => ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun',
+                         'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'],
+        ];
+    }
+
+    protected function getType(): string
+    {
+        return 'line'; // bar, pie, doughnut, radar, polarArea, bubble, scatter
+    }
+
+    protected function getOptions(): array
+    {
+        return [
+            'scales' => [
+                'y' => ['beginAtZero' => true],
+            ],
+        ];
+    }
+}
+```
+
+### Table Widget
+
+```php
+use Filament\Widgets\TableWidget;
+
+class LatestOrders extends TableWidget
+{
+    protected static ?int $sort = 3;
+    protected int|string|array $columnSpan = 'full';
+
+    public function table(Table $table): Table
+    {
+        return $table
+            ->query(Order::query()->latest()->limit(5))
+            ->columns([
+                TextColumn::make('number')->label('Order #'),
+                TextColumn::make('customer.name'),
+                TextColumn::make('total')->money('USD'),
+                TextColumn::make('status')->badge(),
+                TextColumn::make('created_at')->since(),
+            ])
+            ->paginated(false);
+    }
+}
+```
+
+### Dashboard Filters
+
+```php
+use Filament\Pages\Dashboard as BaseDashboard;
+use Filament\Pages\Dashboard\Actions\FilterAction;
+use Filament\Pages\Dashboard\Concerns\HasFiltersAction;
+use Filament\Forms\Components\DatePicker;
+use Filament\Forms\Components\Select;
+
+class Dashboard extends BaseDashboard
+{
+    use HasFiltersAction;
+
+    protected function getHeaderActions(): array
+    {
+        return [
+            FilterAction::make()->schema([
+                DatePicker::make('startDate')->default(now()->subMonth()),
+                DatePicker::make('endDate')->default(now()),
+                Select::make('status')
+                    ->options(['all' => 'All', 'active' => 'Active', 'inactive' => 'Inactive'])
+                    ->default('all'),
+            ]),
+        ];
+    }
+}
+
+// Consuming filters in a widget
+use Filament\Widgets\Concerns\InteractsWithPageFilters;
+
+class RevenueWidget extends StatsOverviewWidget
+{
+    use InteractsWithPageFilters;
+
+    protected function getStats(): array
+    {
+        $start = $this->pageFilters['startDate'] ?? now()->subMonth();
+        $end = $this->pageFilters['endDate'] ?? now();
+
+        $revenue = Order::whereBetween('created_at', [$start, $end])->sum('total');
+
+        return [
+            Stat::make('Revenue', '$' . number_format($revenue, 2)),
+        ];
+    }
+}
+```
+
+### Widget Placement
+
+```php
+// In resource class -- attach widgets to resource pages
+public static function getWidgets(): array
+{
+    return [CustomerStatsWidget::class];
+}
+
+// In ListRecords page
+protected function getHeaderWidgets(): array
+{
+    return [CustomerStatsWidget::class];
+}
+
+// Widget column span
+protected int|string|array $columnSpan = 'full';  // or 1, 2, etc.
+```
+
+## Multi-Tenancy
+
+```php
+// Panel configuration
+$panel->tenant(Team::class, slugAttribute: 'slug')
+    ->tenantRegistration(RegisterTeam::class)
+    ->tenantProfile(EditTeamProfile::class)
+    ->requiresTenantSubscription()
+    ->tenantMenu(true)
+    ->tenantMiddleware([
+        ApplyTenantScopes::class,
+    ]);
+
+// User model
+use Filament\Models\Contracts\HasTenants;
+use Filament\Panel;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Support\Collection;
+
+class User extends Authenticatable implements HasTenants
+{
+    public function teams(): BelongsToMany
+    {
+        return $this->belongsToMany(Team::class);
+    }
+
+    public function getTenants(Panel $panel): Collection
+    {
+        return $this->teams;
+    }
+
+    public function canAccessTenant(Model $tenant): bool
+    {
+        return $this->teams()->whereKey($tenant)->exists();
+    }
+}
+
+// Accessing current tenant anywhere
+use Filament\Facades\Filament;
+
+$tenant = Filament::getTenant();
+
+// Scoping resource queries to tenant
+// In resource:
+public static function getEloquentQuery(): Builder
+{
+    return parent::getEloquentQuery()->whereBelongsTo(Filament::getTenant());
+}
+
+// Or use the global scope approach via TenantScope
+```
+
+## Infolists (Read-Only Display)
+
+```php
+use Filament\Infolists\Components\TextEntry;
+use Filament\Infolists\Components\IconEntry;
+use Filament\Infolists\Components\ImageEntry;
+use Filament\Infolists\Components\ColorEntry;
+use Filament\Infolists\Components\RepeatableEntry;
+use Filament\Infolists\Components\KeyValueEntry;
+
+// In resource or ViewRecord page
+public static function infolist(Infolist $infolist): Infolist
+{
+    return $infolist->schema([
+        Section::make('Customer Details')->schema([
+            TextEntry::make('name'),
+            TextEntry::make('email')
+                ->copyable()
+                ->icon('heroicon-m-envelope'),
+            TextEntry::make('status')
+                ->badge()
+                ->color(fn (string $state) => match ($state) {
+                    'active' => 'success',
+                    'inactive' => 'gray',
+                    'blocked' => 'danger',
+                }),
+            IconEntry::make('is_vip')->boolean(),
+            ImageEntry::make('avatar')->circular(),
+            TextEntry::make('created_at')->dateTime(),
+        ])->columns(2),
+
+        Section::make('Orders')->schema([
+            RepeatableEntry::make('orders')->schema([
+                TextEntry::make('number'),
+                TextEntry::make('total')->money('USD'),
+                TextEntry::make('status')->badge(),
+            ])->columns(3),
+        ]),
+
+        KeyValueEntry::make('metadata'),
+    ]);
+}
+```
+
+## Notifications
+
+```php
+use Filament\Notifications\Notification;
+
+// Success notification
+Notification::make()
+    ->title('Saved successfully')
+    ->success()
+    ->send();
+
+// Error notification
+Notification::make()
+    ->title('Error occurred')
+    ->body('Could not save the record. Please try again.')
+    ->danger()
+    ->persistent()            // Does not auto-dismiss
+    ->send();
+
+// Warning with action
+Notification::make()
+    ->title('Rate limit approaching')
+    ->body('You have used 90% of your API quota.')
+    ->warning()
+    ->actions([
+        \Filament\Notifications\Actions\Action::make('upgrade')
+            ->button()
+            ->url(route('billing')),
+        \Filament\Notifications\Actions\Action::make('dismiss')
+            ->close(),
+    ])
+    ->send();
+
+// Database notifications (persisted, shown in bell icon)
+Notification::make()
+    ->title('New order received')
+    ->body("Order #{$order->number} was placed by {$order->customer->name}.")
+    ->icon('heroicon-o-shopping-cart')
+    ->sendToDatabase($user);
+
+// Broadcast (real-time via websockets)
+Notification::make()
+    ->title('Deployment complete')
+    ->success()
+    ->broadcast($user);
+```
+
+## Navigation
+
+```php
+// Resource / Page navigation properties
+protected static ?string $navigationIcon = 'heroicon-o-document-text';
+protected static ?string $navigationGroup = 'Content';
+protected static ?int $navigationSort = 3;
+protected static ?string $navigationLabel = 'Articles';
+protected static ?string $navigationParentItem = 'Content';
+
+// Dynamic navigation badge
+public static function getNavigationBadge(): ?string
+{
+    return static::getModel()::count();
+}
+
+public static function getNavigationBadgeColor(): ?string
+{
+    return static::getModel()::count() > 10 ? 'warning' : 'primary';
+}
+
+// Clusters (group of related pages)
+use Filament\Clusters\Cluster;
+
+class Settings extends Cluster
+{
+    protected static ?string $navigationIcon = 'heroicon-o-cog-6-tooth';
+}
+
+// Page inside a cluster
+class GeneralSettings extends Page
+{
+    protected static ?string $cluster = Settings::class;
+}
+
+// Custom navigation items in panel provider
+$panel->navigationItems([
+    NavigationItem::make('Documentation')
+        ->url('https://docs.example.com', shouldOpenInNewTab: true)
+        ->icon('heroicon-o-book-open')
+        ->group('Support')
+        ->sort(10),
+])
+
+// User menu items
+$panel->userMenuItems([
+    MenuItem::make()
+        ->label('Profile')
+        ->url(fn () => route('profile'))
+        ->icon('heroicon-o-user'),
+])
+```
+
+## Custom Pages
+
+```php
+use Filament\Pages\Page;
+
+class Settings extends Page
+{
+    protected static ?string $navigationIcon = 'heroicon-o-cog-6-tooth';
+    protected static string $view = 'filament.pages.settings';
+    protected static ?string $title = 'Application Settings';
+
+    public ?array $data = [];
+
+    public function mount(): void
+    {
+        $this->form->fill([
+            'site_name' => config('app.name'),
+            'support_email' => config('mail.from.address'),
+        ]);
+    }
+
+    public function form(Schema $schema): Schema
+    {
+        return $schema->components([
+            Section::make('General')->schema([
+                TextInput::make('site_name')->required(),
+                TextInput::make('support_email')->email()->required(),
+            ]),
+        ])->statePath('data');
+    }
+
+    public function save(): void
+    {
+        $data = $this->form->getState();
+        // Persist settings...
+        Notification::make()->title('Settings saved')->success()->send();
+    }
+
+    protected function getHeaderActions(): array
+    {
+        return [
+            Action::make('save')
+                ->action('save')
+                ->button(),
+        ];
+    }
+}
+```
+
+## Relation Managers
+
+```php
+use Filament\Resources\RelationManagers\RelationManager;
+
+class OrdersRelationManager extends RelationManager
+{
+    protected static string $relationship = 'orders';
+    protected static ?string $recordTitleAttribute = 'number';
+
+    public function table(Table $table): Table
+    {
+        return $table
+            ->columns([
+                TextColumn::make('number'),
+                TextColumn::make('total')->money('USD'),
+                TextColumn::make('status')->badge(),
+                TextColumn::make('created_at')->dateTime(),
+            ])
+            ->recordActions([
+                EditAction::make(),
+                DeleteAction::make(),
+            ])
+            ->toolbarActions([
+                \Filament\Actions\CreateAction::make(),
+                BulkActionGroup::make([
+                    DeleteBulkAction::make(),
+                ]),
+            ]);
+    }
+
+    public function form(Schema $schema): Schema
+    {
+        return $schema->components([
+            TextInput::make('number')->required(),
+            TextInput::make('total')->numeric()->prefix('$')->required(),
+            Select::make('status')
+                ->options(['pending' => 'Pending', 'processing' => 'Processing', 'shipped' => 'Shipped'])
+                ->required(),
+        ]);
+    }
+}
+```
+
+## Authorization
+
+Filament maps to Laravel model policies automatically:
+
+| Policy Method | Controls |
+|---------------|----------|
+| `viewAny` | Can see resource in navigation and list page |
+| `view` | Can see view page / view action |
+| `create` | Can see create button and create page |
+| `update` | Can see edit button and edit page |
+| `delete` | Can delete individual records |
+| `deleteAny` | Can bulk-delete records |
+| `forceDelete` | Can force-delete soft-deleted records |
+| `forceDeleteAny` | Can bulk force-delete |
+| `restore` | Can restore soft-deleted records |
+| `restoreAny` | Can bulk-restore |
+| `reorder` | Can reorder records |
+
+```php
+// app/Policies/PostPolicy.php
+class PostPolicy
+{
+    public function viewAny(User $user): bool
+    {
+        return $user->hasPermissionTo('view posts');
+    }
+
+    public function create(User $user): bool
+    {
+        return $user->hasPermissionTo('create posts');
+    }
+
+    public function update(User $user, Post $post): bool
+    {
+        return $user->hasPermissionTo('edit posts') || $post->user_id === $user->id;
+    }
+
+    public function delete(User $user, Post $post): bool
+    {
+        return $user->hasPermissionTo('delete posts');
+    }
+}
+```
+
+## Exports & Imports
+
+```php
+// Generate exporter
+// php artisan make:filament-exporter Customer
+
+use App\Filament\Exports\CustomerExporter;
+use Filament\Actions\ExportAction;
+
+class CustomerExporter extends Exporter
+{
+    protected static ?string $model = Customer::class;
+
+    public static function getColumns(): array
+    {
+        return [
+            ExportColumn::make('name'),
+            ExportColumn::make('email'),
+            ExportColumn::make('created_at'),
+        ];
+    }
+}
+
+// Use in table toolbar
+ExportAction::make()->exporter(CustomerExporter::class)
+
+// Generate importer
+// php artisan make:filament-importer Customer
+
+use App\Filament\Imports\CustomerImporter;
+use Filament\Actions\ImportAction;
+
+class CustomerImporter extends Importer
+{
+    protected static ?string $model = Customer::class;
+
+    public static function getColumns(): array
+    {
+        return [
+            ImportColumn::make('name')->requiredMapping()->rules(['required', 'max:255']),
+            ImportColumn::make('email')->requiredMapping()->rules(['required', 'email']),
+        ];
+    }
+}
+
+ImportAction::make()->importer(CustomerImporter::class)
+```
+
+## Testing
+
+```php
+use function Pest\Livewire\livewire;
+
+// Test list page renders
+it('can render the list page', function () {
+    livewire(ListCustomers::class)->assertSuccessful();
+});
+
+// Test table shows records
+it('can list customers', function () {
+    $customers = Customer::factory()->count(5)->create();
+
+    livewire(ListCustomers::class)
+        ->assertCanSeeTableRecords($customers);
+});
+
+// Test table columns exist
+it('has the expected columns', function () {
+    livewire(ListCustomers::class)
+        ->assertTableColumnExists('name')
+        ->assertTableColumnExists('email')
+        ->assertTableColumnVisible('status');
+});
+
+// Test table search
+it('can search customers by name', function () {
+    $customer = Customer::factory()->create(['name' => 'John Doe']);
+    Customer::factory()->count(5)->create();
+
+    livewire(ListCustomers::class)
+        ->searchTable('John')
+        ->assertCanSeeTableRecords([$customer])
+        ->assertCountTableRecords(1);
+});
+
+// Test table filters
+it('can filter by status', function () {
+    $active = Customer::factory()->create(['status' => 'active']);
+    $inactive = Customer::factory()->create(['status' => 'inactive']);
+
+    livewire(ListCustomers::class)
+        ->filterTable('status', 'active')
+        ->assertCanSeeTableRecords([$active])
+        ->assertCanNotSeeTableRecords([$inactive]);
+});
+
+// Test create form
+it('can create a customer', function () {
+    livewire(CreateCustomer::class)
+        ->fillForm([
+            'name' => 'Jane Doe',
+            'email' => 'jane@example.com',
+            'status' => 'active',
+        ])
+        ->call('create')
+        ->assertHasNoFormErrors();
+
+    assertDatabaseHas('customers', ['email' => 'jane@example.com']);
+});
+
+// Test form validation
+it('validates required fields', function () {
+    livewire(CreateCustomer::class)
+        ->fillForm(['name' => ''])
+        ->call('create')
+        ->assertHasFormErrors(['name' => 'required']);
+});
+
+// Test edit form
+it('can update a customer', function () {
+    $customer = Customer::factory()->create();
+
+    livewire(EditCustomer::class, ['record' => $customer->getRouteKey()])
+        ->fillForm(['name' => 'Updated Name'])
+        ->call('save')
+        ->assertHasNoFormErrors();
+
+    expect($customer->fresh()->name)->toBe('Updated Name');
+});
+
+// Test table actions
+it('can delete a customer', function () {
+    $customer = Customer::factory()->create();
+
+    livewire(ListCustomers::class)
+        ->callTableAction('delete', $customer);
+
+    assertDatabaseMissing('customers', ['id' => $customer->id]);
+});
+
+// Test bulk actions
+it('can bulk delete customers', function () {
+    $customers = Customer::factory()->count(3)->create();
+
+    livewire(ListCustomers::class)
+        ->callTableBulkAction('delete', $customers);
+
+    assertDatabaseCount('customers', 0);
+});
+```
+
+## Common Patterns
+
+### Global Configuration (Service Provider)
+
+```php
+use Illuminate\Support\ServiceProvider;
+use Filament\Tables\Table;
+use Filament\Tables\Columns\TextColumn;
+use Filament\Schemas\Components\Section;
+
+class AppServiceProvider extends ServiceProvider
+{
+    public function boot(): void
+    {
+        // Apply columns to every table
+        Table::configureUsing(function (Table $table) {
+            $table->pushColumns([
+                TextColumn::make('created_at')
+                    ->dateTime()
+                    ->sortable()
+                    ->toggleable(isToggledHiddenByDefault: true),
+                TextColumn::make('updated_at')
+                    ->dateTime()
+                    ->sortable()
+                    ->toggleable(isToggledHiddenByDefault: true),
+            ]);
+        });
+
+        // Apply to all sections
+        Section::configureUsing(fn (Section $section) => $section->columns(2));
+    }
+}
+```
+
+### Soft Deletes in Resource
+
+```php
+// In table class
+use Filament\Tables\Filters\TrashedFilter;
+
+$table->filters([TrashedFilter::make()])
+
+// In resource
+use Illuminate\Database\Eloquent\SoftDeletingScope;
+
+public static function getEloquentQuery(): Builder
+{
+    return parent::getEloquentQuery()
+        ->withoutGlobalScopes([SoftDeletingScope::class]);
+}
+```
+
+### Simple (Modal) Resources
+
+```php
+// Generated with --simple flag
+// Uses modals instead of separate create/edit pages
+class CategoryResource extends Resource
+{
+    protected static ?string $model = Category::class;
+
+    public static function form(Schema $schema): Schema { /* ... */ }
+    public static function table(Table $table): Table { /* ... */ }
+
+    public static function getPages(): array
+    {
+        return [
+            'index' => ListCategories::route('/'),
+        ];
+    }
+}
+```
+
+### Multiple Panels
+
+```php
+// Second panel provider (e.g., for customers)
+class CustomerPanelProvider extends PanelProvider
+{
+    public function panel(Panel $panel): Panel
+    {
+        return $panel
+            ->id('customer')
+            ->path('customer')
+            ->login()
+            ->colors(['primary' => Color::Blue])
+            ->discoverResources(
+                in: app_path('Filament/Customer/Resources'),
+                for: 'App\\Filament\\Customer\\Resources'
+            );
+    }
+}
+```
+
+## Gotchas
+
+1. **v5 file structure**: Resources split forms/tables into separate classes under `Schemas/` and `Tables/` directories.
+2. **`live()` is required** for reactive fields -- without it, `afterStateUpdated` won't fire.
+3. **Dot notation** auto-eager-loads relationships: `TextColumn::make('author.name')`.
+4. **Authorization** uses model policies by default -- if pages 404 or actions are hidden, check your policy methods.
+5. **`configureUsing()`** in service providers applies globally to all instances of a component type.
+6. **Utility injection** uses named parameters: `$state`, `$get`, `$set`, `$record`, `$operation`. Don't use positional args.
+7. **JS reactivity** (`hiddenJs`, `actionJs`) runs entirely client-side -- use for simple toggle/show/hide logic without server calls.
+8. **`ignoreRecord: true`** on unique validation is required for edit forms, otherwise the current record fails its own uniqueness check.
+9. **`dehydrated(false)`** prevents a field's value from being saved to the database -- use for display-only calculated fields.
+10. **Relation managers** vs **Select with relationship**: Use relation managers for HasMany/BelongsToMany management with full CRUD. Use `Select::make()->relationship()` for BelongsTo assignments.
+11. **Navigation badges** returning `null` hides the badge; return `'0'` (string) to show zero.
+12. **`->searchable()` on columns** adds per-column search. `->searchable(isGlobal: true)` adds to global search. Resource-level `$recordTitleAttribute` also feeds global search.