PHPackages                             pxlrbt/filament-environment-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. [Utility & Helpers](/categories/utility)
4. /
5. pxlrbt/filament-environment-indicator

ActiveLibrary[Utility & Helpers](/categories/utility)

pxlrbt/filament-environment-indicator
=====================================

Indicator for the current environment inside Filament

v3.5.1(2mo ago)151923.9k—3.9%24[1 issues](https://github.com/pxlrbt/filament-environment-indicator/issues)11MITPHPPHP ^8.0CI passing

Since Jul 14Pushed 2mo ago4 watchersCompare

[ Source](https://github.com/pxlrbt/filament-environment-indicator)[ Packagist](https://packagist.org/packages/pxlrbt/filament-environment-indicator)[ GitHub Sponsors](https://github.com/pxlrbt)[ RSS](/packages/pxlrbt-filament-environment-indicator/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (4)Versions (29)Used By (11)

[![header](./.github/resources/pxlrbt-environment-indicator.png)](./.github/resources/pxlrbt-environment-indicator.png)

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

[](#filament-environment-indicator)

[![Latest Version on Packagist](https://camo.githubusercontent.com/55578606e500153602b7a2f6876b3040854336fc664d49a3f5d9135b7a73a20e/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f70786c7262742f66696c616d656e742d656e7669726f6e6d656e742d696e64696361746f722e7376673f696e636c7564655f70726572656c6561736573)](https://packagist.org/packages/pxlrbt/filament-environment-indicator)[![Software License](https://camo.githubusercontent.com/074b89bca64d3edc93a1db6c7e3b1636b874540ba91d66367c0e5e354c56d0ea/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e737667)](LICENSE.md)[![GitHub Workflow Status](https://camo.githubusercontent.com/d358d00b5ca44f03f058d17f7a275e076be223f1dfed18ef05738cc9413eb4ab/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f70786c7262742f66696c616d656e742d656e7669726f6e6d656e742d696e64696361746f722f636f64652d7374796c652e796d6c3f6272616e63683d6d61696e266c6162656c3d436f64652532307374796c65267374796c653d666c61742d737175617265)](https://camo.githubusercontent.com/d358d00b5ca44f03f058d17f7a275e076be223f1dfed18ef05738cc9413eb4ab/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f70786c7262742f66696c616d656e742d656e7669726f6e6d656e742d696e64696361746f722f636f64652d7374796c652e796d6c3f6272616e63683d6d61696e266c6162656c3d436f64652532307374796c65267374796c653d666c61742d737175617265)[![Total Downloads](https://camo.githubusercontent.com/03de67e559fb6133cccd53bdb91e31915cbd08607d9974007a968b0a1cd2abac/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f70786c7262742f66696c616d656e742d656e7669726f6e6d656e742d696e64696361746f722e737667)](https://packagist.org/packages/pxlrbt/filament-environment-indicator)

Never confuse your tabs with different Filament environments again.

[![Screenshot](./.github/resources/preview.gif)](./.github/resources/preview.gif)

Installation via Composer
-------------------------

[](#installation-via-composer)

Plugin VersionFilament VersionPHP Version1.x^2.9.15> 8.02.x3.x> 8.13.x4.x, 5.x> 8.1```
composer require pxlrbt/filament-environment-indicator
```

Usage
-----

[](#usage)

To use this plugin register it in your panel configuration:

```
use pxlrbt\FilamentEnvironmentIndicator\EnvironmentIndicatorPlugin;

$panel
    ->plugins([
        EnvironmentIndicatorPlugin::make(),
    ]);
```

Configuration
-------------

[](#configuration)

Out of the box, this plugin adds a colored border to the top of the admin panel and a badge next to the search bar.

You can customize any behaviour via the plugin object.

### Customizing the view

[](#customizing-the-view)

Use `php artisan vendor:publish --tag="filament-environment-indicator-views"` to publish the view to the `resources/views/vendor/filament-environment-indicator` folder. After this you can customize it as you wish!

### Visibility

[](#visibility)

By default, the package checks whether you have Spatie permissions plugin installed and checks for a role called `super_admin`. You can further customize whether the indicators should be shown.

```
use pxlrbt\FilamentEnvironmentIndicator\EnvironmentIndicatorPlugin;

$panel->plugins([
    EnvironmentIndicatorPlugin::make()
        ->visible(fn () => auth()->user()?->can('see_indicator'))
]);
```

### Environment

[](#environment)

By default, the environment is resolved from `app()->environment()` (i.e. the `APP_ENV` value). You can override it with a static string or a closure:

```
use pxlrbt\FilamentEnvironmentIndicator\EnvironmentIndicatorPlugin;

$panel->plugins([
    EnvironmentIndicatorPlugin::make()
        ->environment(fn () => config('app.custom_env', app()->environment()))
]);
```

This affects the badge label, as well as the default color, badge visibility, and border visibility which all key off the environment value.

### Colors

[](#colors)

You can overwrite the default colors if you want your own colors or need to add more. The `->color()`method accepts any Filament's Color object or a closure that returns a color object.

```
use pxlrbt\FilamentEnvironmentIndicator\EnvironmentIndicatorPlugin;
use Filament\Support\Colors\Color;

$panel->plugins([
    EnvironmentIndicatorPlugin::make()
        ->color(fn () => match (app()->environment()) {
            'production' => null,
            'staging' => Color::Orange,
            default => Color::Blue,
        })
]);
```

### Indicators

[](#indicators)

By default, both indicators are displayed on non-production environments. You can turn them off separately.

```
use pxlrbt\FilamentEnvironmentIndicator\EnvironmentIndicatorPlugin;
use Filament\Support\Colors\Color;

$panel->plugins([
    EnvironmentIndicatorPlugin::make()
        ->showBadge(false)
        ->showBorder(true)
]);
```

### Badge position

[](#badge-position)

By default, badge position is `\Filament\View\PanelsRenderHook::GLOBAL_SEARCH_BEFORE`.

```
use Filament\View\PanelsRenderHook;
use pxlrbt\FilamentEnvironmentIndicator\EnvironmentIndicatorPlugin;

$panel->plugins([
    EnvironmentIndicatorPlugin::make()
        ->badgePosition(PanelsRenderHook::TOPBAR_LOGO_BEFORE)
]);
```

### Git Branch

[](#git-branch)

You can enable the display of the current git branch in the badge via `->showGitBranch()`. This requires the `exec()` function to be enabled in your PHP configuration.

```
use pxlrbt\FilamentEnvironmentIndicator\EnvironmentIndicatorPlugin;
use Filament\Support\Colors\Color;

$panel->plugins([
    EnvironmentIndicatorPlugin::make()
        ->showGitBranch()
]);
```

### Debug Mode Warning

[](#debug-mode-warning)

You can enable a debug mode warning for every environment or just for production by using `->showDebugModeWarning()`/`->showDebugModeWarningInProduction()`

```
use pxlrbt\FilamentEnvironmentIndicator\EnvironmentIndicatorPlugin;
use Filament\Support\Colors\Color;

$panel->plugins([
    EnvironmentIndicatorPlugin::make()
        ->showDebugModeWarningInProduction()
]);
```

Contributing
------------

[](#contributing)

If you want to contribute to this packages, you may want to test it in a real Filament project:

- Fork this repository to your GitHub account.
- Create a Filament app locally.
- Clone your fork in your Filament app's root directory.
- In the `/filament-environment-indicator` directory, create a branch for your fix, e.g. `fix/error-message`.

Install the packages in your app's `composer.json`:

```
"require": {
    "pxlrbt/filament-environment-indicator": "dev-fix/error-message as main-dev",
},
"repositories": [
    {
        "type": "path",
        "url": "filament-environment-indicator"
    }
]
```

Now, run `composer update`.

Credits
-------

[](#credits)

- [Dennis Koch](https://github.com/pxlrbt)
- [All Contributors](../../contributors)

###  Health Score

62

—

FairBetter than 99% of packages

Maintenance86

Actively maintained with recent releases

Popularity57

Moderate usage in the ecosystem

Community33

Small or concentrated contributor base

Maturity63

Established project with proven stability

 Bus Factor1

Top contributor holds 75.5% of commits — single point of failure

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

Every ~60 days

Recently: every ~28 days

Total

23

Last Release

70d ago

Major Versions

v0.2.0 → v1.0.02022-10-04

v0.3.0 → v2.0.02023-08-03

v2.1.0 → v3.0.02025-06-13

v2.2.0 → v3.1.12025-07-31

### Community

Maintainers

![](https://www.gravatar.com/avatar/de2f0e928f16fab39bac058ab23744ed045a432404d1275a5a5258acbd368798?d=identicon)[pxlrbt](/maintainers/pxlrbt)

---

Top Contributors

[![pxlrbt](https://avatars.githubusercontent.com/u/22632550?v=4)](https://github.com/pxlrbt "pxlrbt (71 commits)")[![achyutkneupane](https://avatars.githubusercontent.com/u/30431426?v=4)](https://github.com/achyutkneupane "achyutkneupane (6 commits)")[![tonypartridge](https://avatars.githubusercontent.com/u/1400982?v=4)](https://github.com/tonypartridge "tonypartridge (4 commits)")[![mathieutu](https://avatars.githubusercontent.com/u/11351322?v=4)](https://github.com/mathieutu "mathieutu (2 commits)")[![hlipnick](https://avatars.githubusercontent.com/u/5473499?v=4)](https://github.com/hlipnick "hlipnick (2 commits)")[![arcdigital](https://avatars.githubusercontent.com/u/551002?v=4)](https://github.com/arcdigital "arcdigital (1 commits)")[![sakanjo](https://avatars.githubusercontent.com/u/121197517?v=4)](https://github.com/sakanjo "sakanjo (1 commits)")[![slizhva](https://avatars.githubusercontent.com/u/29979800?v=4)](https://github.com/slizhva "slizhva (1 commits)")[![ukeloop](https://avatars.githubusercontent.com/u/45733259?v=4)](https://github.com/ukeloop "ukeloop (1 commits)")[![vlados](https://avatars.githubusercontent.com/u/46914?v=4)](https://github.com/vlados "vlados (1 commits)")[![claude](https://avatars.githubusercontent.com/u/81847?v=4)](https://github.com/claude "claude (1 commits)")[![webard](https://avatars.githubusercontent.com/u/855788?v=4)](https://github.com/webard "webard (1 commits)")[![DanielvdSpoel](https://avatars.githubusercontent.com/u/28593493?v=4)](https://github.com/DanielvdSpoel "DanielvdSpoel (1 commits)")[![martin-ro](https://avatars.githubusercontent.com/u/10107779?v=4)](https://github.com/martin-ro "martin-ro (1 commits)")

---

Tags

environmentfilamentadminfilamentphpfilamentlaravel-filamentenvironment indicator

###  Code Quality

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/pxlrbt-filament-environment-indicator/health.svg)

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

###  Alternatives

[pboivin/filament-peek

Full-screen page preview modal for Filament

253319.6k12](/packages/pboivin-filament-peek)[dotswan/filament-map-picker

Easily pick and retrieve geo-coordinates using a map-based interface in your Filament applications.

124139.3k2](/packages/dotswan-filament-map-picker)[creagia/filament-code-field

A Filamentphp input field to edit or view code data.

58289.3k3](/packages/creagia-filament-code-field)[jibaymcs/filament-tour

Bring the power of DriverJs to your Filament panels and start a tour !

12247.8k](/packages/jibaymcs-filament-tour)[swisnl/filament-backgrounds

Beautiful backgrounds for Filament auth pages

54149.2k6](/packages/swisnl-filament-backgrounds)[aymanalhattami/filament-context-menu

context menu (right click menu) for filament

9838.0k](/packages/aymanalhattami-filament-context-menu)

PHPackages © 2026

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