filament-tables
Create FilamentPHP v4 tables with columns, filters, sorting, search, and bulk actions
When & Why to Use This Skill
This Claude skill automates the generation of FilamentPHP v4 table configurations, enabling developers to rapidly build feature-rich data tables. It follows official documentation patterns to implement columns, advanced filters, sorting, search capabilities, and bulk actions, significantly reducing the boilerplate code required for Laravel admin panels.
Use Cases
- Rapidly scaffolding administrative dashboard tables for Laravel applications using the FilamentPHP v4 framework.
- Implementing complex data filtering and global search logic for large datasets without manual configuration.
- Configuring interactive and editable table columns, such as inline toggles, selects, and status badges, to improve UI/UX.
- Setting up custom row-level actions and bulk operations for efficient batch processing of database records.
- Displaying and managing complex relational data, including BelongsTo relationships and HasMany counts, within a unified table interface.
| name | filament-tables |
|---|---|
| description | Create FilamentPHP v4 tables with columns, filters, sorting, search, and bulk actions |
FilamentPHP Tables Generation Skill
Overview
This skill generates FilamentPHP v4 table configurations with columns, filters, actions, and bulk operations following official documentation patterns.
Documentation Reference
CRITICAL: Before generating tables, read:
/home/mwguerra/projects/mwguerra/claude-code-plugins/filament-specialist/skills/filament-docs/references/tables//home/mwguerra/projects/mwguerra/claude-code-plugins/filament-specialist/skills/filament-docs/references/tables/02-columns//home/mwguerra/projects/mwguerra/claude-code-plugins/filament-specialist/skills/filament-docs/references/tables/03-filters/
Workflow
Step 1: Analyze Requirements
Identify:
- Columns to display
- Searchable fields
- Sortable fields
- Filter requirements
- Row actions
- Bulk actions
- Relationships to display
Step 2: Read Documentation
Navigate to table documentation and extract:
- Column class names and options
- Filter configurations
- Action patterns
- Performance considerations
Step 3: Generate Table
Build table configuration:
use Filament\Tables;
use Filament\Tables\Table;
public static function table(Table $table): Table
{
return $table
->columns([
// Columns
])
->filters([
// Filters
])
->actions([
// Row actions
])
->bulkActions([
// Bulk actions
]);
}
Column Types Reference
Text Column
// Basic text
Tables\Columns\TextColumn::make('name')
->searchable()
->sortable();
// With limit and tooltip
Tables\Columns\TextColumn::make('description')
->limit(50)
->tooltip(fn ($record): string => $record->description);
// Formatted
Tables\Columns\TextColumn::make('price')
->money('usd')
->sortable();
// Date formatting
Tables\Columns\TextColumn::make('created_at')
->dateTime('M j, Y H:i')
->sortable()
->since(); // Shows "2 hours ago"
// Copyable
Tables\Columns\TextColumn::make('uuid')
->copyable()
->copyMessage('UUID copied!')
->copyMessageDuration(1500);
// With color
Tables\Columns\TextColumn::make('status')
->color(fn (string $state): string => match ($state) {
'draft' => 'gray',
'reviewing' => 'warning',
'published' => 'success',
default => 'gray',
});
// HTML content
Tables\Columns\TextColumn::make('content')
->html()
->wrap();
// Word/character count
Tables\Columns\TextColumn::make('bio')
->words(10);
// List values (array)
Tables\Columns\TextColumn::make('tags')
->listWithLineBreaks()
->bulleted();
Icon Column
// Boolean icon
Tables\Columns\IconColumn::make('is_active')
->boolean();
// Custom icons
Tables\Columns\IconColumn::make('status')
->icon(fn (string $state): string => match ($state) {
'draft' => 'heroicon-o-pencil',
'reviewing' => 'heroicon-o-clock',
'published' => 'heroicon-o-check-circle',
})
->color(fn (string $state): string => match ($state) {
'draft' => 'info',
'reviewing' => 'warning',
'published' => 'success',
default => 'gray',
});
Image Column
// Basic image
Tables\Columns\ImageColumn::make('avatar')
->circular()
->size(40);
// Multiple images (stacked)
Tables\Columns\ImageColumn::make('images')
->circular()
->stacked()
->limit(3)
->limitedRemainingText();
// With default
Tables\Columns\ImageColumn::make('logo')
->defaultImageUrl(url('/images/default-logo.png'))
->square()
->size(60);
Badge Column
Tables\Columns\BadgeColumn::make('status')
->colors([
'danger' => 'draft',
'warning' => 'reviewing',
'success' => 'published',
])
->icons([
'heroicon-o-pencil' => 'draft',
'heroicon-o-clock' => 'reviewing',
'heroicon-o-check' => 'published',
]);
// Or with closure
Tables\Columns\BadgeColumn::make('priority')
->color(fn (string $state): string => match ($state) {
'low' => 'gray',
'medium' => 'warning',
'high' => 'danger',
});
Color Column
Tables\Columns\ColorColumn::make('color')
->copyable()
->copyMessage('Color code copied');
Toggle Column
// Editable inline toggle
Tables\Columns\ToggleColumn::make('is_active')
->onColor('success')
->offColor('danger')
->afterStateUpdated(fn () => Notification::make()
->title('Status updated')
->success()
->send()
);
Select Column
// Editable inline select
Tables\Columns\SelectColumn::make('status')
->options([
'draft' => 'Draft',
'published' => 'Published',
]);
Text Input Column
// Editable inline text
Tables\Columns\TextInputColumn::make('sort_order')
->rules(['required', 'numeric']);
Checkbox Column
// Editable inline checkbox
Tables\Columns\CheckboxColumn::make('is_featured');
Relationship Columns
// BelongsTo
Tables\Columns\TextColumn::make('author.name')
->label('Author')
->searchable()
->sortable();
// HasMany count
Tables\Columns\TextColumn::make('comments_count')
->counts('comments')
->label('Comments')
->sortable();
// HasMany sum
Tables\Columns\TextColumn::make('items_sum_quantity')
->sum('items', 'quantity')
->label('Total Quantity');
// BelongsToMany list
Tables\Columns\TextColumn::make('tags.name')
->badge()
->separator(',');
View Column (Custom)
Tables\Columns\ViewColumn::make('custom')
->view('filament.tables.columns.custom-column');
Column Modifiers
Tables\Columns\TextColumn::make('name')
// Search
->searchable()
->searchable(isIndividual: true)
// Sort
->sortable()
->sortable(['first_name', 'last_name'])
// Visibility
->toggleable()
->toggleable(isToggledHiddenByDefault: true)
->visible(fn (): bool => auth()->user()->isAdmin())
->hidden(fn ($record): bool => $record->is_private)
// Sizing
->grow(false)
->width('200px')
->alignCenter()
->alignEnd()
// Styling
->weight(FontWeight::Bold)
->size(TextColumn\TextColumnSize::Large)
->color('primary')
->extraAttributes(['class' => 'custom-class']);
Filters Reference
Select Filter
Tables\Filters\SelectFilter::make('status')
->options([
'draft' => 'Draft',
'reviewing' => 'Reviewing',
'published' => 'Published',
]);
// Multiple selection
Tables\Filters\SelectFilter::make('status')
->multiple()
->options([
'draft' => 'Draft',
'published' => 'Published',
]);
// Relationship filter
Tables\Filters\SelectFilter::make('author')
->relationship('author', 'name')
->searchable()
->preload();
Ternary Filter (Boolean)
Tables\Filters\TernaryFilter::make('is_active')
->label('Active')
->boolean()
->trueLabel('Active only')
->falseLabel('Inactive only')
->native(false);
Date Filter
Tables\Filters\Filter::make('created_at')
->form([
Forms\Components\DatePicker::make('created_from'),
Forms\Components\DatePicker::make('created_until'),
])
->query(function (Builder $query, array $data): Builder {
return $query
->when(
$data['created_from'],
fn (Builder $query, $date): Builder => $query->whereDate('created_at', '>=', $date),
)
->when(
$data['created_until'],
fn (Builder $query, $date): Builder => $query->whereDate('created_at', '<=', $date),
);
})
->indicateUsing(function (array $data): array {
$indicators = [];
if ($data['created_from'] ?? null) {
$indicators['created_from'] = 'From ' . Carbon::parse($data['created_from'])->toFormattedDateString();
}
if ($data['created_until'] ?? null) {
$indicators['created_until'] = 'Until ' . Carbon::parse($data['created_until'])->toFormattedDateString();
}
return $indicators;
});
Trashed Filter (Soft Deletes)
Tables\Filters\TrashedFilter::make();
Query Builder Filter
Tables\Filters\QueryBuilder::make()
->constraints([
Tables\Filters\QueryBuilder\Constraints\TextConstraint::make('name'),
Tables\Filters\QueryBuilder\Constraints\NumberConstraint::make('price'),
Tables\Filters\QueryBuilder\Constraints\DateConstraint::make('created_at'),
Tables\Filters\QueryBuilder\Constraints\RelationshipConstraint::make('author')
->icon('heroicon-o-user')
->multiple(),
]);
Actions Reference
Row Actions
->actions([
Tables\Actions\ViewAction::make(),
Tables\Actions\EditAction::make(),
Tables\Actions\DeleteAction::make()
->requiresConfirmation(),
// Custom action
Tables\Actions\Action::make('publish')
->icon('heroicon-o-check')
->color('success')
->requiresConfirmation()
->action(fn (Model $record) => $record->publish())
->visible(fn (Model $record): bool => $record->status === 'draft'),
// Action with modal form
Tables\Actions\Action::make('send_email')
->icon('heroicon-o-envelope')
->form([
Forms\Components\TextInput::make('subject')
->required(),
Forms\Components\RichEditor::make('body')
->required(),
])
->action(function (Model $record, array $data): void {
Mail::to($record->email)->send(new CustomEmail($data));
}),
// Grouped actions
Tables\Actions\ActionGroup::make([
Tables\Actions\ViewAction::make(),
Tables\Actions\EditAction::make(),
Tables\Actions\DeleteAction::make(),
])->dropdown(),
// Replicate action
Tables\Actions\ReplicateAction::make()
->excludeAttributes(['slug', 'published_at'])
->beforeReplicaSaved(function (Model $replica): void {
$replica->name = $replica->name . ' (Copy)';
}),
]);
Bulk Actions
->bulkActions([
Tables\Actions\BulkActionGroup::make([
Tables\Actions\DeleteBulkAction::make(),
Tables\Actions\ForceDeleteBulkAction::make(),
Tables\Actions\RestoreBulkAction::make(),
// Custom bulk action
Tables\Actions\BulkAction::make('publish')
->icon('heroicon-o-check')
->requiresConfirmation()
->action(fn (Collection $records) => $records->each->publish())
->deselectRecordsAfterCompletion(),
// Export bulk action
Tables\Actions\BulkAction::make('export')
->icon('heroicon-o-arrow-down-tray')
->action(fn (Collection $records) => static::export($records)),
]),
]);
Header Actions
->headerActions([
Tables\Actions\CreateAction::make(),
Tables\Actions\AttachAction::make()
->preloadRecordSelect(),
// Import action
Tables\Actions\Action::make('import')
->icon('heroicon-o-arrow-up-tray')
->form([
Forms\Components\FileUpload::make('file')
->acceptedFileTypes(['text/csv']),
])
->action(fn (array $data) => static::import($data['file'])),
]);
Table Configuration
public static function table(Table $table): Table
{
return $table
->columns([...])
->filters([...])
->actions([...])
->bulkActions([...])
// Pagination
->paginated([10, 25, 50, 100])
->defaultPaginationPageOption(25)
// Default sort
->defaultSort('created_at', 'desc')
// Reordering
->reorderable('sort_order')
->defaultSort('sort_order')
// Grouping
->groups([
Tables\Grouping\Group::make('status')
->label('Status')
->collapsible(),
Tables\Grouping\Group::make('author.name')
->label('Author'),
])
// Striped rows
->striped()
// Poll for updates
->poll('10s')
// Empty state
->emptyStateHeading('No posts yet')
->emptyStateDescription('Create your first post to get started.')
->emptyStateIcon('heroicon-o-document-text')
->emptyStateActions([
Tables\Actions\CreateAction::make()
->label('Create Post'),
])
// Modals
->modals([
'view' => true,
])
// Persist filters
->filtersFormColumns(3)
->persistFiltersInSession();
}
Output
Generated tables include:
- Complete column configuration
- Search and sort settings
- Filter definitions
- Row and bulk actions
- Relationship handling
- Performance optimizations