Filament Conventions

Use this when building or changing Filament admin panel code.

The version-specific schema and component-validation guidance below cites first-party documentation in SOURCES.md (FILAMENT-SCHEMAS-01, FILAMENT-FORM-VALIDATION-01, LIVEWIRE-FORM-VALIDATION-01, FILAMENT-SECURITY-UPLOADS-01, FILAMENT-UPGRADE-5-01).

Detect the version first

composer show filament/filament | grep versions

v3, v4, and v5 have different APIs — check before writing or copying code:

• v4 represents schemas with Filament\Schemas\Schema, including form, infolist, layout, and action components.
• Filament 5 builds on this schema architecture, requires Livewire 4 and PHP 8.3+, and formalizes custom form integration with Filament\Schemas\Contracts\HasSchemas and Filament\Schemas\Concerns\InteractsWithSchemas (FILAMENT-UPGRADE-5-01).
• The v4 and v5 upgrade guides record moved layout-component namespaces and changed component factory signatures; run official upgrade tooling and review every reported change before copying older snippets.
• Plugins are version-specific; a v3 or v4 plugin will not install on v5 without compatibility updates (see filament-plugin-first).