Building Powerful Admin Panels with Laravel 12 and Filament v5: A Production Guide

Filament v5 is the version that finally makes "build the admin panel" a one-evening task instead of a two-week project. Released alongside Laravel 12, it ships with rebuilt forms and tables, native multi-tenancy, and a plugin ecosystem that genuinely covers the long tail. This guide is what I wish someone had handed me on day one — the patterns that scale to ten resources, fifty, and beyond.

1. Installation that actually works on day 30

composer require filament/filament:"^5.0" -W
php artisan filament:install --panels
php artisan make:filament-user

The default panel lives at /admin. Before you ship anything, lock it down.

// app/Providers/Filament/AdminPanelProvider.php
public function panel(Panel $panel): Panel
{
    return $panel
        ->default()
        ->id('admin')
        ->path('admin')
        ->login()
        ->authGuard('web')
        ->colors(['primary' => Color::Teal])
        ->discoverResources(in: app_path('Filament/Resources'), for: 'App\\Filament\\Resources')
        ->discoverPages(in: app_path('Filament/Pages'), for: 'App\\Filament\\Pages')
        ->discoverWidgets(in: app_path('Filament/Widgets'), for: 'App\\Filament\\Widgets')
        ->middleware([
            EncryptCookies::class,
            AddQueuedCookiesToResponse::class,
            StartSession::class,
            AuthenticateSession::class,
            ShareErrorsFromSession::class,
            VerifyCsrfToken::class,
            SubstituteBindings::class,
            DisableBladeIconComponents::class,
            DispatchServingFilamentEvent::class,
        ])
        ->authMiddleware([Authenticate::class, EnsureUserCanAccessFilament::class]);
}

2. Your first Resource — done right

php artisan make:filament-resource Project --generate

// app/Filament/Resources/ProjectResource.php
public static function form(Form $form): Form
{
    return $form->schema([
        Forms\Components\Section::make('Project details')
            ->columns(2)
            ->schema([
                Forms\Components\TextInput::make('name')
                    ->required()
                    ->maxLength(120)
                    ->live(onBlur: true)
                    ->afterStateUpdated(fn ($set, $state) => $set('slug', Str::slug($state))),

                Forms\Components\TextInput::make('slug')
                    ->required()
                    ->unique(ignoreRecord: true),

                Forms\Components\Select::make('owner_id')
                    ->relationship('owner', 'name')
                    ->searchable()
                    ->preload()
                    ->required(),

                Forms\Components\Select::make('status')
                    ->options(['draft' => 'Draft', 'active' => 'Active', 'archived' => 'Archived'])
                    ->default('draft')
                    ->required(),

                Forms\Components\RichEditor::make('description')
                    ->columnSpanFull()
                    ->disableToolbarButtons(['attachFiles']),
            ]),
    ]);
}

public static function table(Table $table): Table
{
    return $table
        ->columns([
            Tables\Columns\TextColumn::make('name')->searchable()->sortable(),
            Tables\Columns\TextColumn::make('owner.name')->label('Owner')->sortable(),
            Tables\Columns\BadgeColumn::make('status')
                ->colors(['gray' => 'draft', 'success' => 'active', 'warning' => 'archived']),
            Tables\Columns\TextColumn::make('updated_at')->since()->sortable(),
        ])
        ->filters([
            Tables\Filters\SelectFilter::make('status')->options(['draft', 'active', 'archived']),
            Tables\Filters\Filter::make('mine')
                ->toggle()
                ->query(fn ($query) => $query->where('owner_id', auth()->id())),
        ])
        ->actions([Tables\Actions\EditAction::make(), Tables\Actions\DeleteAction::make()])
        ->bulkActions([Tables\Actions\DeleteBulkAction::make()])
        ->defaultSort('updated_at', 'desc');
}

3. Role-based access with Spatie Permissions

composer require spatie/laravel-permission

// app/Filament/Resources/ProjectResource.php
public static function canViewAny(): bool   { return auth()->user()->can('view-any project'); }
public static function canCreate(): bool    { return auth()->user()->can('create project'); }
public static function canEdit($record): bool   { return auth()->user()->can('update', $record); }
public static function canDelete($record): bool { return auth()->user()->can('delete', $record); }

Wire the same permissions into your model policies and you get one source of truth — Filament inherits the policy automatically when you implement canEdit via the Gate.

4. Multi-tenancy without leaks

Filament v5 has first-class tenancy. Tell the panel which model represents a tenant and every resource is scoped automatically.

// In AdminPanelProvider::panel()
->tenant(Workspace::class, slugAttribute: 'slug')
->tenantRegistration(RegisterWorkspace::class)
->tenantProfile(EditWorkspaceProfile::class)

// app/Models/Workspace.php
public function getFilamentName(): string { return $this->name; }
public function canAccessFilament(): bool { return $this->users->contains(auth()->user()); }

// app/Models/User.php
public function getTenants(Panel $panel): Collection
{
    return $this->workspaces;
}

public function canAccessTenant(Model $tenant): bool
{
    return $this->workspaces->contains($tenant);
}

5. Custom widgets that earn their keep

// app/Filament/Widgets/ProjectsOverview.php
class ProjectsOverview extends BaseWidget
{
    protected function getStats(): array
    {
        $tenant = Filament::getTenant();

        return [
            Stat::make('Active projects', $tenant->projects()->where('status', 'active')->count())
                ->description('Last 30 days')
                ->descriptionIcon('heroicon-o-arrow-trending-up')
                ->color('success'),

            Stat::make('Open tasks', $tenant->tasks()->whereNull('completed_at')->count())
                ->color('warning'),

            Stat::make('Avg. response time', '4h 12m')
                ->color('primary'),
        ];
    }
}

Production checklist