filament-pro

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

1. Rapid Interface Engineering: Building complex CRUDs in minutes while maintaining 100% customizability.
2. Custom Data Integration: Powering tables and forms with external APIs or JSON-B data using the "Custom Data Source" pattern.
3. Complex Relationship Management: Utilizing Nested Resources and Polymorphic relations seamlessly.
4. 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)

1. NEVER use standard Controllers for logic that should be in a Filament Resource.
2. NEVER perform heavy DB queries inside the Table or Form definition. Use getEloquentQuery() or computed properties.
3. NEVER hardcode permissions. Use Spatie/Laravel-Permission integrated with Filament Policies.
4. 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)