README

Filament Extendable is a powerful extension toolkit for FilamentPHP, enabling highly composable and dynamic customization of tables, forms, and infolists — all without touching core logic.

🚩 Important Notice

This library is under active development. APIs and features may evolve. Contributions and feedback are highly appreciated.

Features

Dynamic registration of modifiers for forms, tables, and infolists
Insert components before or after existing ones
Remove components by key
Full compatibility with filament:make-* commands
Minimal interference with native Filament lifecycle

Requirements

PHP ^8.2
Laravel ^11.x || ^12.x
Filament ^4.0

📦 Installation

composer require quix-labs/filament-extendable

If needed, register the service provider (usually auto-discovered):

// config/app.php
'providers' => [
    // ...
    QuixLabs\FilamentExtendable\FilamentExtendableServiceProvider::class,
],

Usage

1. Enable Extensibility in Your Resource

Wrap your resource schema and tables with the builders:

use QuixLabs\FilamentExtendable\Facades\FilamentExtendable;

class UserResource extends Resource
{
    public static function form(Schema $schema): Schema
    {
        return FilamentExtendable::processSchema($schema, 'user-form');
    }

    public static function infolist(Schema $schema): Schema
    {
        return FilamentExtendable::processSchema($schema, 'user-infolist');
    }

    public static function table(Table $table): Table
    {
        return FilamentExtendable::processTable($table, 'user-table');
    }
}

2. Register Modifiers

Define dynamic modifiers in the boot function of your service provider:

use QuixLabs\FilamentExtendable\Builders\TableBuilder;
use QuixLabs\FilamentExtendable\Builders\SchemaBuilder;
use QuixLabs\FilamentExtendable\Facades\FilamentExtendable;
use Filament\Tables\Columns\TextColumn;
use Filament\Forms\Components\TextInput;
use Filament\Infolists\Components\TextEntry;

class FilamentExtendServiceProvider extends ServiceProvider
{
    public function boot(): void
    {
        // Insert a column after 'email' in the user table
        FilamentExtendable::addTableModifier('user-table', function (TableBuilder $tableBuilder) {
            $tableBuilder->insertAfter('email', [
                TextColumn::make('lastname')->label('Last Name'),
            ]);
        });

        // Add a field to the user infolist
        FilamentExtendable::addSchemaModifier('user-infolist', function (SchemaBuilder $schemaBuilder) {
            $schemaBuilder->pushComponents([
                TextEntry::make('lastname')->label('Last Name'),
            ]);
        });
    }
}

3. Schema Manipulations

Insert component in schema

Push components at root or inside nested groups via dot notation:

Control insertion with:

position — 'before' or 'after' relative to a target key
targetKey — component key near which to insert
targetGroup — dot notation path to nested group

// Append at root level (default behavior)
$schemaBuilder->pushComponents([
    TextInput::make('nickname')->label('Nickname'),
]);

// After 'bio' at root level
$schemaBuilder->pushComponents([
    TextArea::make('additional_notes'),
], position: InsertPosition::AFTER, targetKey: 'bio');

// Before 'email' at root level
$schemaBuilder->pushComponents([
    Select::make('preferred_contact_method'),
], position: InsertPosition::BEFORE, targetKey: 'email');

// After 'last_login' in 'tabs.activity' nested tab/section/group/...
$schemaBuilder->pushComponents([
    TextEntry::make('last_login_ip')->label('Last Login IP'),
], position: InsertPosition::AFTER, targetKey: 'last_login', targetGroup: 'tabs.activity');

Delete Components from Schema

You can remove components from both the root level and nested groups using their keys.

If a specified key is not found, the operation is silently skipped (no error thrown).

$schemaBuilder->removeComponents([
    'email', // Removes 'email' field from the root level
    'tabs.seo.meta_title', // Dot notation is supported for nested paths.
]);

Integration with Filament Artisan Commands

Filament Extendable patches the following commands to scaffold extendable resources automatically:

php artisan make:filament-resource User
php artisan make:filament-table UserTable
php artisan make:filament-form UserForm
php artisan make:filament-schema UserSchema

They generate boilerplate code that includes calls to FilamentExtendable::processSchema() and FilamentExtendable::processTable(), ready for modifier registration.

💡 This allows you to plug in modifiers immediately, without writing boilerplate.

Why this exists

Filament is an exceptional tool, but there are scenarios where additional dynamic control is needed:

Modular package systems needing to inject UI logic
Enterprise-grade systems with conditional rendering needs
Reusable and declarative customizations across multiple resources

Filament Extendable solves this with a non-intrusive, declarative API.

Changelog

Please see CHANGELOG for more information on what has changed recently.

🤝 Contributing

We welcome your contributions!

Fork the repository.
Create a new branch for your feature or bugfix.
Commit your changes.
Push your branch.
Create a pull request.

Credits

License

The MIT License (MIT). Please see License File for more information.

quix-labs / filament-extendable

Maintainers

Details