saasykit/filament-oops

Never accidentally edit your Filament production panel again! Filament Oops displays a clear 'Production' warning, helping you avoid costly mistakes and keeping your development safe.
8,056 16
Install
composer require saasykit/filament-oops
Latest Version:2.1.0
PHP:^8.2
License:MIT
Last Updated:Feb 3, 2026
Links: GitHub  ·  Packagist
Maintainer: aswilam

Never accidentally edit your Filament production panel again!

Latest Version on Packagist

Filament Oops displays a clear 'Production' warning on your production Filament panel, helping you avoid costly mistakes and keeping your development safe.

Filament Oops uses the APP_ENV environment variable to determine the environment your Filament panel is running in. If you're running your Filament panel in production, Filament Oops will display a clear 'Production' warning on your panel.

You can also define custom environment names and colors if you want to customize the warning message for your specific environments.

Installation

You can install the package via composer:

composer require saasykit/filament-oops

Optionally, you can publish the views using (in case you want to customize the views):

php artisan vendor:publish --tag="filament-oops-views"

Usage

All you need to do is add the FilamentOopsPlugin to your Filament plugin list in your FilamentServiceProvider (usually located in app/Providers/Filament/AdminPanelProvider.php):

class AdminPanelProvider extends PanelProvider
{
    public function panel(Panel $panel): Panel
    {
        return $panel
            // some other configurations
            ->plugins([
                FilamentOopsPlugin::make(),  // Add this line
            ]);
    }
}

Customization

You can customize the environment names and colors by using the addEnvironment method on the FilamentOopsPlugin:

class AdminPanelProvider extends PanelProvider
{
    public function panel(Panel $panel): Panel
    {
        return $panel
            // some other configurations
            ->plugins([
                FilamentOopsPlugin::make()->addEnvironment('local', 'Local', '#008000'),  // Add this line
            ]);
    }
}

Psst: Wanna build a Laravel SaaS application quickly?

If you want to build a SaaS app quickly, support us by checking out SaaSykit. SaaSykit is a SaaS starter kit (boilerplate) that comes packed with all components required to run a modern SaaS software. Available in both multi-tenant and single-tenant versions.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

License

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

Related Packages

doctrine/dbal

Powerful PHP database abstraction layer (DBAL) with many features for database s...

637,827,751 9,703
laravel/framework

The Laravel Framework.

589,172,971 34,950
laravel/tinker

Powerful REPL for the Laravel framework.

498,216,183 7,442
laravel/serializable-closure

Laravel Serializable Closure provides an easy and secure way to serialize closur...

413,412,504 609
nunomaduro/collision

Cli error handling for console/command-line PHP applications.

391,429,217 4,660