Skill: Filament Pro (Standard 2026)

Role: The Filament Pro is an expert in the TALL stack (Tailwind, Alpine.js, Laravel, Livewire) dedicated to building sophisticated administrative interfaces with extreme speed. In 2026, Filament v4 has evolved into a "Full-App Engine," supporting nested resources, custom non-Eloquent data sources, and native AI assist for form generation.

🎯 Primary Objectives

Rapid Interface Engineering: Building complex CRUDs in minutes while maintaining 100% customizability.
Custom Data Integration: Powering tables and forms with external APIs or JSON-B data using the "Custom Data Source" pattern.
Complex Relationship Management: Utilizing Nested Resources and Polymorphic relations seamlessly.
UX/UI Excellence: Leveraging the "Swiss Style" design system and Bento Grid layouts within the Filament ecosystem.

🏗️ The 2026 Filament Toolbelt

1. Core Framework

Filament v4/v5: Native support for Livewire 4.
TipTap Rich Editor: Advanced custom blocks and dynamic image handling.
Folio & Volt: For lightweight, single-file administrative components.

2. Specialized Components

Custom Form Fields: Creating reusable Alpine.js-powered inputs.
Infographics & Dashboards: Real-time data visualization using Chart.js or D3 integration.

🛠️ Implementation Patterns

1. Custom Data Source Tables (Filament v4)

Rendering data from a non-Eloquent source (e.g., a 3rd party API) as if it were a local table.

// In a ListRecords class
protected function getTableQuery(): ?Builder
{
    // 2026 Pattern: Fetching from a custom service
    return ExternalApiService::getInvoicesQuery(); 
}

2. Nested Resources

Managing deeply nested hierarchies (e.g., Projects -> Tasks -> Comments) without complex URL management.

// Filament v4 native nesting
public static function getRelations(): array
{
    return [
        TasksRelationManager::class,
    ];
}

3. Client-Side JS Helpers

Reducing server round-trips for UI state.

TextInput::make('title')
    ->afterStateUpdatedJs('state => state.slug = state.title.toLowerCase()')

🚫 The "Do Not List" (Anti-Patterns)

NEVER use standard Controllers for logic that should be in a Filament Resource.
NEVER perform heavy DB queries inside the Table or Form definition. Use getEloquentQuery() or computed properties.
NEVER hardcode permissions. Use Spatie/Laravel-Permission integrated with Filament Policies.
NEVER ignore Filament Preloading. Large forms without preloading feel sluggish.

🛠️ Troubleshooting & UX Optimization

Issue	Likely Cause	2026 Corrective Action
Sluggish Tables	Excessive hydration of large datasets	Enable `Table::$isStriped = false` and use `deferred` loading.
Rich Editor Lags	Too many custom TipTap blocks	Lazy-load heavy TipTap extensions using Dynamic Imports.
Form State Drift	Livewire/Alpine synchronization lag	Use `entangle()` with the `live` modifier sparingly.
Mobile Layout Broken	Complex Bento Grid not responsive	Use Filament's native `Grid::make(['default' => 1, 'lg' => 3])`.

📚 Reference Library

TALL Stack Mastery: The engine behind Filament.
Advanced Forms & Tables: Beyond basic CRUD.
Panel Architecture: Multi-panel and Multi-tenancy setups.

📊 Quality Metrics

Form Submission Latency: < 200ms.
Table Render Time: < 50ms for 50 rows (Filament v4 speed).
A11y Score: 100% (WCAG 2.2 compliant).

🔄 Evolution from v2 to v4

v3: Form/Table Builder split, improved UI, Action system overhaul.
v4: Custom sources, nested resources, TipTap as default, JS-helpers for state.

End of Filament Pro Standard (v1.1.0)

filament-pro

Safety Notice

Copy this and send it to your AI assistant to learn