# Laravel Filament

> Build Filament admin panels on the v5 API surface THIS project targets, not deprecated v3 patterns — a reference carrying the current namespaces and conventions for Resources, forms, tables, actions, filters, relation managers, widgets, infolists, panels, and testing, with business logic kept in application Actions, so a change lands idiomatic and review-ready instead of tripping over renamed APIs. Use when a task touches this project's Filament admin panels and should target the v5 surface rather than deprecated patterns.

- Skill: `ulpi-io/laravel-filament` (Agent Skill, multi-file: 13 files)
- Install (CLI): `npx skillmds@latest add ulpi-io/laravel-filament`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ulpi-io/laravel-filament/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: ulpi-io (https://skillmd.com/u/ulpi-io)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/ulpi-io/laravel-filament

---


<EXTREMELY-IMPORTANT>
This skill exists to keep Filament work aligned with v5, not to duplicate the entire reference library.

Non-negotiable rules:
1. Read `references/namespaces.md` first.
2. Then load only the reference files the task actually needs.
3. Keep business logic out of Resources.
4. Use the v5 action and table APIs, not old v3 patterns.
5. Keep the heavy Filament cookbook in `references/`, not inline here.
</EXTREMELY-IMPORTANT>

# laravel-filament

## Inputs

- `$request`: The Filament admin task or component to modify

## Goal

Route Filament work through the correct v5 conventions so the implementation uses the right namespaces, table APIs, and admin-panel composition patterns.

## Step 0: Read the v5 namespace contract

Always start with:

- `references/namespaces.md`

That establishes the namespace and API changes that commonly break Filament work.

**Success criteria**: The task is grounded in the correct Filament v5 surface before editing.

## Step 1: Load only the relevant admin references

Use the routing table to pick reference files. Do not bulk-load everything.

| Task | Read |
|------|------|
| v5 namespace and API changes | `references/namespaces.md` |
| Creating or editing a Resource (CRUD) | `references/resources.md` |
| Form fields, sections, layout | `references/forms.md` |
| Table columns, sorting, searching | `references/tables.md` |
| Bulk actions, row actions, header actions | `references/actions.md` |
| Table filters, filter forms | `references/filters.md` |
| Relation managers, BelongsToMany, HasMany | `references/relationships.md` |
| Dashboard widgets, stats, charts | `references/widgets.md` |
| Multi-panel setup, navigation, tenancy | `references/panels.md` |
| Flash messages, database notifications | `references/notifications.md` |
| Infolist entries, read-only views | `references/infolists.md` |
| Testing resources, pages, actions | `references/testing.md` |

Multiple tasks? Read multiple files.

**Success criteria**: Only the task-relevant Filament conventions are in the active context.

## Step 2: Implement with the core Filament guardrails

Keep these rules active:

- actions come from `Filament\\Actions\\*`
- tables use the v5 record/toolbar/header action methods
- badge presentation uses `TextColumn->badge()`
- layout components come from the Schemas package
- Resource classes delegate real business work to application Actions

**Success criteria**: The change uses valid v5 APIs and stays maintainable.

## Step 3: Verify the admin surface

Use the narrowest relevant verification:

- focused feature tests
- Filament page/resource tests
- lightweight UI smoke coverage if the repo already has it

**Success criteria**: The Filament surface still behaves correctly after the change.

## Guardrails

- Do not inline the whole Filament handbook in `SKILL.md`.
- Do not skip `references/namespaces.md`.
- Do not use v3 action namespaces or deprecated table methods.
- Do not put business logic directly in Resource classes.

## When To Load References

- `references/namespaces.md`
  Always.

- then only the task-relevant files under `references/`

## Output Contract

Report:

1. which Filament references were loaded
2. the v5 pattern applied
3. the change made
4. the verification run