filament-resource

SKILL.md

FilamentPHP Resource Generation Skill

Overview

This skill generates complete FilamentPHP v4 resources including form schemas, table configurations, relation managers, and custom pages. All generated code follows official documentation patterns.

Documentation Reference

CRITICAL: Before generating any resource, read:

/home/mwguerra/projects/mwguerra/claude-code-plugins/filament-specialist/skills/filament-docs/references/general/03-resources/

/home/mwguerra/projects/mwguerra/claude-code-plugins/filament-specialist/skills/filament-docs/references/forms/

/home/mwguerra/projects/mwguerra/claude-code-plugins/filament-specialist/skills/filament-docs/references/tables/

Workflow

Step 1: Gather Requirements
Identify:

Model name and namespace

Fields to include in form

Columns to display in table

Relationships to manage

Custom actions needed

Authorization requirements

Step 2: Generate Base Resource

Use Laravel artisan to create the resource:

# Basic resource
php artisan make:filament-resource ModelName

# With generate flag (creates form/table from model)
php artisan make:filament-resource ModelName --generate

# Soft deletes support
php artisan make:filament-resource ModelName --soft-deletes

# View page only
php artisan make:filament-resource ModelName --view

# Simple resource (modal forms instead of pages)
php artisan make:filament-resource ModelName --simple

Step 3: Customize Form Schema

Read form field documentation and implement:

use Filament\Forms;
use Filament\Forms\Form;

public static function form(Form $form): Form
{
    return $form
        ->schema([
            Forms\Components\Section::make('Basic Information')
                ->schema([
                    Forms\Components\TextInput::make('name')
                        ->required()
                        ->maxLength(255),
                    Forms\Components\Textarea::make('description')
                        ->rows(3)
                        ->columnSpanFull(),
                ]),
            Forms\Components\Section::make('Settings')
                ->schema([
                    Forms\Components\Toggle::make('is_active')
                        ->default(true),
                    Forms\Components\Select::make('status')
                        ->options([
                            'draft' => 'Draft',
                            'published' => 'Published',
                        ]),
                ]),
        ]);
}

Step 4: Customize Table

Read table documentation and implement:

use Filament\Tables;
use Filament\Tables\Table;

public static function table(Table $table): Table
{
    return $table
        ->columns([
            Tables\Columns\TextColumn::make('name')
                ->searchable()
                ->sortable(),
            Tables\Columns\IconColumn::make('is_active')
                ->boolean(),
            Tables\Columns\BadgeColumn::make('status')
                ->colors([
                    'warning' => 'draft',
                    'success' => 'published',
                ]),
            Tables\Columns\TextColumn::make('created_at')
                ->dateTime()
                ->sortable()
                ->toggleable(isToggledHiddenByDefault: true),
        ])
        ->filters([
            Tables\Filters\SelectFilter::make('status')
                ->options([
                    'draft' => 'Draft',
                    'published' => 'Published',
                ]),
            Tables\Filters\TernaryFilter::make('is_active'),
        ])
        ->actions([
            Tables\Actions\ViewAction::make(),
            Tables\Actions\EditAction::make(),
            Tables\Actions\DeleteAction::make(),
        ])
        ->bulkActions([
            Tables\Actions\BulkActionGroup::make([
                Tables\Actions\DeleteBulkAction::make(),
            ]),
        ]);
}

Step 5: Add Relation Managers

For relationships, create relation managers:

php artisan make:filament-relation-manager ResourceName RelationName column_name

Register in resource:

public static function getRelations(): array
{
    return [
        RelationManagers\CommentsRelationManager::class,
        RelationManagers\TagsRelationManager::class,
    ];
}

Step 6: Configure Pages

Define resource pages:

public static function getPages(): array
{
    return [
        'index' => Pages\ListModels::route('/'),
        'create' => Pages\CreateModel::route('/create'),
        'view' => Pages\ViewModel::route('/{record}'),
        'edit' => Pages\EditModel::route('/{record}/edit'),
    ];
}

Step 7: Add Authorization

Implement policy methods:

public static function canViewAny(): bool
{
    return auth()->user()->can('view_any_model');
}

public static function canCreate(): bool
{
    return auth()->user()->can('create_model');
}

Form Field Reference

Text Fields

TextInput::make() - Single line text

Textarea::make() - Multi-line text

RichEditor::make() - WYSIWYG editor

MarkdownEditor::make() - Markdown editor

Selection Fields

Select::make() - Dropdown select

Radio::make() - Radio buttons

Checkbox::make() - Single checkbox

CheckboxList::make() - Multiple checkboxes

Toggle::make() - Toggle switch

Date/Time Fields

DatePicker::make() - Date only

DateTimePicker::make() - Date and time

TimePicker::make() - Time only

File Fields

FileUpload::make() - File upload

SpatieMediaLibraryFileUpload::make() - Media library

Relationship Fields

Select::make()->relationship() - BelongsTo select

CheckboxList::make()->relationship() - BelongsToMany

Repeater::make()->relationship() - HasMany inline

Layout Components

Section::make() - Card section

Fieldset::make() - Fieldset grouping

Tabs::make() - Tabbed sections

Grid::make() - Grid layout

Split::make() - Split layout

Table Column Reference

Text Columns

TextColumn::make() - Basic text

IconColumn::make() - Boolean icon

ImageColumn::make() - Image thumbnail

BadgeColumn::make() - Badge styling

ColorColumn::make() - Color swatch

Column Modifiers

->searchable() - Enable search

->sortable() - Enable sort

->toggleable() - Can hide/show

->wrap() - Wrap text

->limit() - Truncate text

Output

For each resource, generate:

Resource class - app/Filament/Resources/ModelResource.php

Pages - app/Filament/Resources/ModelResource/Pages/

Relation Managers - app/Filament/Resources/ModelResource/RelationManagers/

Test file - tests/Feature/Filament/ModelResourceTest.php