PHPackages                             la-souris/filament-env-indicator - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. la-souris/filament-env-indicator

ActiveLibrary

la-souris/filament-env-indicator
================================

Filament v5 plugin to change the header color according to environment

v1.0(yesterday)02↑2900%MITPHP ^8.5

Since Jul 22Compare

[ Source](https://github.com/la-souris/package-filament-env-indicator)[ Packagist](https://packagist.org/packages/la-souris/filament-env-indicator)[ RSS](/packages/la-souris-filament-env-indicator/feed)WikiDiscussions Synced today

READMEChangelog (1)Dependencies (5)Versions (2)Used By (0)

Filament Environment Indicator
==============================

[](#filament-environment-indicator)

`la-souris/filament-env-indicator` is a Filament v5 plugin that makes non-production panels visually obvious by:

- recoloring the Filament topbar,
- recoloring the global search field to match,
- and adding a small environment badge before global search.

This helps avoid mistakes when switching between `local`, staging-like, and demo/admin environments.

Example
-------

[](#example)

[![local.png](docs/local.png)](docs/local.png)[![acceptance.png](docs/acceptance.png)](docs/acceptance.png)[![production.png](docs/production.png)](docs/production.png)

Requirements
------------

[](#requirements)

- PHP `^8.5`
- Filament `^5.6`

Installation
------------

[](#installation)

```
composer require la-souris/filament-env-indicator
```

Basic usage
-----------

[](#basic-usage)

Register the plugin on your panel provider:

```
use Filament\Panel;
use LaSouris\FilamentEnvIndicator\EnvironmentIndicatorPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        ->plugin(EnvironmentIndicatorPlugin::make());
}
```

Default behavior
----------------

[](#default-behavior)

- Nothing is shown in `production` (styles and badge are disabled).
- Defaults are provided for:
    - `local` and `development` (green),
    - `demo` (amber),
    - `acceptance` (red).
- Environments not registered on the plugin are ignored.
- The badge text is the current Laravel environment name (`app()->environment()`).
- The current git branch is included as the badge tooltip (`title`) when available.

Customizing environments
------------------------

[](#customizing-environments)

Use `environment()` to add new environment themes or override defaults:

```
use Filament\Support\Colors\Color;
use LaSouris\FilamentEnvIndicator\EnvironmentIndicatorPlugin;

EnvironmentIndicatorPlugin::make()
    ->environment('staging', Color::Yellow, topbarShade: '600', topbarAccent: '100', textColor: 'black')
    ->environment('local', Color::Blue, topbarShade: '700', topbarAccent: '100', textColor: 'white');
```

Method signature:

```
environment(
    string $name,
    array $palette,
    string $topbarShade = '500',
    string $topbarAccent = '50',
    string $textColor = 'black',
)
```

- `$palette` should be a Filament color palette (for example `Color::Blue`).
- Shade values like `'50'`, `'500'`, `'800'` must exist on the palette.

Testing
-------

[](#testing)

```
composer test
```

Credits
-------

[](#credits)

This package is inspired by [pxlrbt/filament-environment-indicator](https://filamentphp.com/plugins/pxlrbt-environment-indicator).

###  Health Score

41

—

FairBetter than 87% of packages

Maintenance100

Actively maintained with recent releases

Popularity3

Limited adoption so far

Community2

Small or concentrated contributor base

Maturity50

Maturing project, gaining track record

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

1d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/930ca3b1756d00a63c8ff3363e81f16f961cf3ef79ff0c9d362670c36d97e456?d=identicon)[LauLaman](/maintainers/LauLaman)

###  Code Quality

TestsPHPUnit

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/la-souris-filament-env-indicator/health.svg)

```
[![Health](https://phpackages.com/badges/la-souris-filament-env-indicator/health.svg)](https://phpackages.com/packages/la-souris-filament-env-indicator)
```

###  Alternatives

[filament/filament

A collection of full-stack components for accelerated Laravel app development.

3829.6M3.9k](/packages/filament-filament)[filament/infolists

Easily add beautiful read-only infolists to any Livewire component.

1327.7M68](/packages/filament-infolists)[backstage/mails

View logged mails and events in a beautiful Filament UI.

16121.5k](/packages/backstage-mails)[rawilk/profile-filament-plugin

Profile & MFA starter kit for filament.

3914.8k](/packages/rawilk-profile-filament-plugin)[crumbls/layup

A visual page builder plugin for Filament 5 — Divi-style grid layouts with extensible widgets.

592.8k2](/packages/crumbls-layup)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)