# filamentphp/filament architecture

> Architecture diagram of the GitHub repository filamentphp/filament, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-09). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/filamentphp/filament
- Repository: https://github.com/filamentphp/filament

## Overview

Filament is a Laravel framework for building business applications and admin panels. In the principal workflow, a developer configures a panel and its resources; end users then interact with record tables, forms, actions, and read-only details, with notifications and dashboard widgets providing feedback and summaries. The repository also documents standalone capabilities such as navigation, tenancy, and query-building. The map combines README-described product behavior with relationships visible in the supplied excerpts and SOURCE INDEX; unsampled internals are represented only where their paths are supported by the tree.

Main entry points: [`packages/panels/src/FilamentManager.php`](https://github.com/filamentphp/filament/blob/4.x/packages/panels/src/FilamentManager.php) (Panel manager), [`packages/panels/src/Resources`](https://github.com/filamentphp/filament/tree/4.x/packages/panels/src/Resources) (Resources and pages), [`packages/tables/src/Table.php`](https://github.com/filamentphp/filament/blob/4.x/packages/tables/src/Table.php) (Tables), [`packages/forms/src/Components/Builder.php`](https://github.com/filamentphp/filament/blob/4.x/packages/forms/src/Components/Builder.php) (Forms)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_panel["Panels and navigation"]
  node_panels["Panel manager"]
  node_navigation["Navigation"]
  node_manager["Navigation items<br/>[NavigationItem.php]"]
end

subgraph group_records["Record management"]
  node_resources["Resources and pages"]
  node_relation["Relation managers"]
end

subgraph group_ui["Interaction components"]
  node_tables["Tables<br/>[Table.php]"]
  node_queryfilter["Query builder filter<br/>[QueryBuilder.php]"]
  node_forms["Forms<br/>[Builder.php]"]
  node_schemas["Schemas<br/>[Schema.php]"]
  node_schema_components["Schema components<br/>[Component.php]"]
  node_actions["Actions<br/>[Action.php]"]
  node_notifications["Notifications<br/>[Collection.php]"]
  node_widgets["Dashboard widgets"]
  node_infolists["Infolists"]
  node_columnmanager["Column preferences"]
end

subgraph group_shared["Shared runtime"]
  node_assets["Asset registry<br/>[FilamentAsset.php]"]
  node_color["Color manager<br/>[ColorManager.php]"]
  node_components["Component manager"]
  node_views["View manager<br/>[ViewManager.php]"]
  node_package["Translation package metadata<br/>[Package.php]"]
end

node_user(("Application user"))
node_developer(("Application developer"))

node_developer -->|"configures"| node_panels
node_user -->|"uses"| node_panels
node_panels -->|"provides navigation"| node_navigation
node_panels -->|"hosts"| node_resources
node_resources -->|"browses records"| node_tables
node_resources -->|"edits records"| node_forms
node_resources -->|"presents details"| node_infolists
node_resources -->|"manages relations"| node_relation
node_relation -->|"uses relationship table"| node_tables
node_tables -->|"supports filtering"| node_queryfilter
node_tables -->|"persists column state"| node_columnmanager
node_forms -.->|"builds schemas"| node_schemas
node_schemas -->|"renders components"| node_schema_components
node_user -->|"triggers actions"| node_actions
node_actions -->|"provides feedback"| node_notifications
node_panels -->|"displays dashboards"| node_widgets
node_panels -->|"registers assets"| node_assets
node_panels -->|"configures colors"| node_color
node_panels -->|"manages components"| node_components
node_panels -->|"manages views"| node_views
node_developer -->|"builds forms"| node_forms
node_developer -->|"defines interactions"| node_actions
node_developer -->|"configures query filters"| node_queryfilter

click node_panels "https://github.com/filamentphp/filament/blob/4.x/packages/panels/src/FilamentManager.php"
click node_navigation "https://github.com/filamentphp/filament/blob/4.x/packages/panels/src/Navigation/NavigationManager.php"
click node_resources "https://github.com/filamentphp/filament/tree/4.x/packages/panels/src/Resources"
click node_relation "https://github.com/filamentphp/filament/blob/4.x/packages/panels/src/Resources/RelationManagers/RelationManager.php"
click node_tables "https://github.com/filamentphp/filament/blob/4.x/packages/tables/src/Table.php"
click node_queryfilter "https://github.com/filamentphp/filament/blob/4.x/packages/tables/src/Filters/QueryBuilder.php"
click node_forms "https://github.com/filamentphp/filament/blob/4.x/packages/forms/src/Components/Builder.php"
click node_schemas "https://github.com/filamentphp/filament/blob/4.x/packages/schemas/src/Schema.php"
click node_schema_components "https://github.com/filamentphp/filament/blob/4.x/packages/schemas/src/Components/Component.php"
click node_actions "https://github.com/filamentphp/filament/blob/4.x/packages/actions/src/Action.php"
click node_notifications "https://github.com/filamentphp/filament/blob/4.x/packages/notifications/src/Collection.php"
click node_widgets "https://github.com/filamentphp/filament/blob/4.x/packages/widgets/src/WidgetsServiceProvider.php"
click node_infolists "https://github.com/filamentphp/filament/blob/4.x/packages/infolists/src/InfolistsServiceProvider.php"
click node_manager "https://github.com/filamentphp/filament/blob/4.x/packages/panels/src/Navigation/NavigationItem.php"
click node_columnmanager "https://github.com/filamentphp/filament/blob/4.x/packages/tables/src/Concerns/HasColumnManager.php"
click node_assets "https://github.com/filamentphp/filament/blob/4.x/packages/support/src/Facades/FilamentAsset.php"
click node_color "https://github.com/filamentphp/filament/blob/4.x/packages/support/src/Colors/ColorManager.php"
click node_components "https://github.com/filamentphp/filament/blob/4.x/packages/support/src/Components/ComponentManager.php"
click node_views "https://github.com/filamentphp/filament/blob/4.x/packages/support/src/View/ViewManager.php"
click node_package "https://github.com/filamentphp/filament/blob/4.x/bin/TranslationTool/src/DataObjects/Package.php"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_panels,node_navigation,node_manager,node_user toneBlue
class node_resources,node_relation toneAmber
class node_tables,node_queryfilter,node_forms,node_schemas,node_schema_components,node_actions,node_notifications,node_widgets,node_infolists,node_columnmanager toneMint
class node_assets,node_color,node_components,node_views,node_package toneRose
class node_developer toneIndigo
```

## Components

### Panels and navigation

- [Panel manager](https://github.com/filamentphp/filament/blob/4.x/packages/panels/src/FilamentManager.php): `packages/panels/src/FilamentManager.php`
- [Navigation](https://github.com/filamentphp/filament/blob/4.x/packages/panels/src/Navigation/NavigationManager.php): `packages/panels/src/Navigation/NavigationManager.php`
- [Navigation items](https://github.com/filamentphp/filament/blob/4.x/packages/panels/src/Navigation/NavigationItem.php): `packages/panels/src/Navigation/NavigationItem.php`

### Record management

- [Resources and pages](https://github.com/filamentphp/filament/tree/4.x/packages/panels/src/Resources): `packages/panels/src/Resources`
- [Relation managers](https://github.com/filamentphp/filament/blob/4.x/packages/panels/src/Resources/RelationManagers/RelationManager.php): `packages/panels/src/Resources/RelationManagers/RelationManager.php`

### Interaction components

- [Tables](https://github.com/filamentphp/filament/blob/4.x/packages/tables/src/Table.php): `packages/tables/src/Table.php`
- [Query builder filter](https://github.com/filamentphp/filament/blob/4.x/packages/tables/src/Filters/QueryBuilder.php): `packages/tables/src/Filters/QueryBuilder.php`
- [Forms](https://github.com/filamentphp/filament/blob/4.x/packages/forms/src/Components/Builder.php): `packages/forms/src/Components/Builder.php`
- [Schemas](https://github.com/filamentphp/filament/blob/4.x/packages/schemas/src/Schema.php): `packages/schemas/src/Schema.php`
- [Schema components](https://github.com/filamentphp/filament/blob/4.x/packages/schemas/src/Components/Component.php): `packages/schemas/src/Components/Component.php`
- [Actions](https://github.com/filamentphp/filament/blob/4.x/packages/actions/src/Action.php): `packages/actions/src/Action.php`
- [Notifications](https://github.com/filamentphp/filament/blob/4.x/packages/notifications/src/Collection.php): `packages/notifications/src/Collection.php`
- [Dashboard widgets](https://github.com/filamentphp/filament/blob/4.x/packages/widgets/src/WidgetsServiceProvider.php): `packages/widgets/src/WidgetsServiceProvider.php`
- [Infolists](https://github.com/filamentphp/filament/blob/4.x/packages/infolists/src/InfolistsServiceProvider.php): `packages/infolists/src/InfolistsServiceProvider.php`
- [Column preferences](https://github.com/filamentphp/filament/blob/4.x/packages/tables/src/Concerns/HasColumnManager.php): `packages/tables/src/Concerns/HasColumnManager.php`

### Shared runtime

- [Asset registry](https://github.com/filamentphp/filament/blob/4.x/packages/support/src/Facades/FilamentAsset.php): `packages/support/src/Facades/FilamentAsset.php`
- [Color manager](https://github.com/filamentphp/filament/blob/4.x/packages/support/src/Colors/ColorManager.php): `packages/support/src/Colors/ColorManager.php`
- [Component manager](https://github.com/filamentphp/filament/blob/4.x/packages/support/src/Components/ComponentManager.php): `packages/support/src/Components/ComponentManager.php`
- [View manager](https://github.com/filamentphp/filament/blob/4.x/packages/support/src/View/ViewManager.php): `packages/support/src/View/ViewManager.php`
- [Translation package metadata](https://github.com/filamentphp/filament/blob/4.x/bin/TranslationTool/src/DataObjects/Package.php): `bin/TranslationTool/src/DataObjects/Package.php`

### Other components

- **Application user**
- **Application developer**

## Connections

- Application developer → Panel manager: configures
- Application user → Panel manager: uses
- Panel manager → Navigation: provides navigation (evidence: `packages/panels/src/FilamentManager.php`)
- Panel manager → Resources and pages: hosts (evidence: `packages/panels/src/FilamentManager.php`)
- Resources and pages → Tables: browses records (evidence: `packages/panels/src/Resources/RelationManagers/RelationManager.php`)
- Resources and pages → Forms: edits records
- Resources and pages → Infolists: presents details
- Resources and pages → Relation managers: manages relations (evidence: `packages/panels/src/Resources/RelationManagers/RelationManager.php`)
- Relation managers → Tables: uses relationship table (evidence: `packages/panels/src/Resources/RelationManagers/RelationManager.php`)
- Tables → Query builder filter: supports filtering
- Tables → Column preferences: persists column state (evidence: `packages/tables/src/Concerns/HasColumnManager.php`)
- Forms → Schemas: builds schemas
- Schemas → Schema components: renders components (evidence: `packages/schemas/src/Schema.php`)
- Application user → Actions: triggers actions
- Actions → Notifications: provides feedback
- Panel manager → Dashboard widgets: displays dashboards
- Panel manager → Asset registry: registers assets (evidence: `packages/support/src/Facades/FilamentAsset.php`)
- Panel manager → Color manager: configures colors (evidence: `packages/support/src/Colors/ColorManager.php`)
- Panel manager → Component manager: manages components (evidence: `packages/support/src/Components/ComponentManager.php`)
- Panel manager → View manager: manages views (evidence: `packages/support/src/View/ViewManager.php`)
- Application developer → Forms: builds forms
- Application developer → Actions: defines interactions
- Application developer → Query builder filter: configures query filters (evidence: `packages/tables/src/Filters/QueryBuilder.php`)
