albertofuentes/filament-maintenance

Enable maintenance mode per Filament panel with configurable access exceptions, customizable downtime pages, and audit history.

v1.0.0-beta.1 2026-06-11 16:06 UTC

Requires

• php: ^8.2
• filament/filament: ^5.0
• spatie/laravel-package-tools: ^1.15.0

Requires (Dev)

• larastan/larastan: ^3.0
• laravel/pint: ^1.0
• nunomaduro/collision: ^8.0
• orchestra/testbench: ^9.0|^10.0|^11.0
• pestphp/pest: ^3.7|^4.0
• pestphp/pest-plugin-arch: ^3.0|^4.0
• pestphp/pest-plugin-laravel: ^3.0|^4.0
• pestphp/pest-plugin-livewire: ^3.0|^4.0

MIT

• Alberto Fuentes

• laravel
• filament
• filament-plugin
• filamentphp
• filament-maintenance
• albertofuentes

README

Filament Maintenance lets you enable maintenance mode per Filament panel, with access exceptions for IP addresses, CIDR ranges, manager users, and Spatie Permission roles.

Installation

composer require albertofuentes/filament-maintenance

Publish and run the migrations:

php artisan vendor:publish --tag="filament-maintenance-migrations"
php artisan migrate

Optionally publish the config and views:

php artisan vendor:publish --tag="filament-maintenance-config"
php artisan vendor:publish --tag="filament-maintenance-views"

Usage

Register the plugin in the Filament panel where you want maintenance mode:

use Albertofuentes\FilamentMaintenance\FilamentMaintenancePlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        // ...
        ->plugin(FilamentMaintenancePlugin::make());
}

The plugin adds:

• A maintenance switch near the user menu for allowed managers.
• A maintenance settings page inside the panel.
• Middleware that blocks the panel when maintenance is enabled.
• A customizable 503 maintenance view.
• Audit events for enable, disable and settings updates.

Permissions

Managers can be configured from the settings page by selecting users or Spatie role names. The package also allows users with the Laravel permission manage-filament-maintenance.

While no manager users or manager roles are configured for a panel, authenticated users can access the settings page so the first configuration can be completed.

Testing

composer test