PHPackages                             arnautdev/filament-deploy-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. arnautdev/filament-deploy-indicator

ActiveLibrary

arnautdev/filament-deploy-indicator
===================================

Show application ENV and latest deployment info inside your Filament admin.

v1.0.2(2w ago)06↓100%[1 PRs](https://github.com/arnautdev/filament-deploy-indicator/pulls)MITPHPPHP ^8.2CI passing

Since Mar 5Pushed 6d agoCompare

[ Source](https://github.com/arnautdev/filament-deploy-indicator)[ Packagist](https://packagist.org/packages/arnautdev/filament-deploy-indicator)[ Docs](https://github.com/arnautdev/filament-deploy-indicator)[ RSS](/packages/arnautdev-filament-deploy-indicator/feed)WikiDiscussions 5.x Synced today

READMEChangelog (3)Dependencies (11)Versions (5)Used By (0)

Filament Deploy Indicator
=========================

[](#filament-deploy-indicator)

Show the current application environment (ENV) and optional latest deployment info in your Filament topbar.

[![Latest Version on Packagist](https://camo.githubusercontent.com/60b12b1f5e375bc04791cd843c1e1af20b5990cbf6a0c3f0b16e5b44ac96ea37/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f61726e6175746465762f66696c616d656e742d6465706c6f792d696e64696361746f722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/arnautdev/filament-deploy-indicator)[![GitHub Tests Action Status](https://camo.githubusercontent.com/1f3175250fd713c31225d3acf7313c6424cb1a2dcf1ba5af84487a5cc74c78dd/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f61726e6175746465762f66696c616d656e742d6465706c6f792d696e64696361746f722f72756e2d74657374732e796d6c3f6272616e63683d6d61696e266c6162656c3d7465737473267374796c653d666c61742d737175617265)](https://github.com/arnautdev/filament-deploy-indicator/actions?query=workflow%3Arun-tests+branch%3Amain)[![GitHub Code Style Action Status](https://camo.githubusercontent.com/f9e9f3660da8c42d795905546c3ee93b89cebe332cebba00ad77858075a565be/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f61726e6175746465762f66696c616d656e742d6465706c6f792d696e64696361746f722f6669782d7068702d636f64652d7374796c652d6973737565732e796d6c3f6272616e63683d6d61696e266c6162656c3d636f64652532307374796c65267374796c653d666c61742d737175617265)](https://github.com/arnautdev/filament-deploy-indicator/actions?query=workflow%3A%22Fix+PHP+code+styling%22+branch%3Amain)[![Total Downloads](https://camo.githubusercontent.com/7c45134d92a4a6db9f65ffa840b092a332bd99c92831c26b3ebc259e85213fe9/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f61726e6175746465762f66696c616d656e742d6465706c6f792d696e64696361746f722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/arnautdev/filament-deploy-indicator)

Features
--------

[](#features)

- Shows current `APP_ENV` (mapped to a short label like `PROD`, `STAGE`, `LOCAL`) in the Filament topbar.
- Optional small hint next to the label: commit hash or deploy time.
- Reads deployment metadata from a JSON file (default: `storage/app/private/deploy-info.json`).
- Can auto-generate the JSON when missing (using `git`), if enabled.

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

[](#requirements)

- PHP ^8.2
- Filament ^4.0 or ^5.0

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

[](#installation)

Install the package via Composer:

```
composer require arnautdev/filament-deploy-indicator
```

Register the plugin
-------------------

[](#register-the-plugin)

Add the plugin to your panel:

```
use Arnautdev\FilamentDeployIndicator\FilamentDeployIndicatorPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        ->plugins([
            FilamentDeployIndicatorPlugin::make(),
        ]);
}
```

Conditional visibility
----------------------

[](#conditional-visibility)

You can control who can see the deploy indicator by using the `->visible()` method when registering the plugin.

### Show only for admins

[](#show-only-for-admins)

```
use Arnautdev\FilamentDeployIndicator\FilamentDeployIndicatorPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        ->plugins([
            FilamentDeployIndicatorPlugin::make()
                ->visible(fn (): bool => auth()->user()?->is_admin === true),
        ]);
}
```

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

[](#configuration)

Publish the config file:

```
php artisan vendor:publish --tag="filament-deploy-indicator-config"
```

Config file: config/filament-deploy-indicator.php

Main options
------------

[](#main-options)

OptionDescription`position`Filament render hook position`cache_ttl`Cache time in seconds`file_path`Path to deployment JSON`auto_generate_when_missing`Generate JSON using git if missing`write_path`Where generated JSON should be written`git_root`Root of the git repository`env_map`Mapping of env → label + color`topbar.show``null`, `commit`, or `deployed_at`---

Generate deployment info manually
---------------------------------

[](#generate-deployment-info-manually)

The package provides an Artisan command to generate the deployment metadata JSON file.

```
php artisan filament-deploy-indicator:write
```

Deployment JSON format
----------------------

[](#deployment-json-format)

The plugin reads a JSON file like:

```
{
  "environment": "local",
  "deployed_at": "2026-03-04 16:30:00",
  "commit": "33de817",
  "branch": "feature/deploy-indicator",
  "author": "You",
  "commit_message": "Local test"
}
```

Default location:

```
storage/app/private/deploy-info.json

```

Testing
-------

[](#testing)

```
composer test
```

Changelog
---------

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

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

[](#contributing)

Please see [CONTRIBUTING](.github/CONTRIBUTING.md) for details.

Security Vulnerabilities
------------------------

[](#security-vulnerabilities)

Please review [our security policy](.github/SECURITY.md) on how to report security vulnerabilities.

Credits
-------

[](#credits)

- [Dmitry Arnaut](https://github.com/arnautdev)
- [All Contributors](../../contributors)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

42

—

FairBetter than 90% of packages

Maintenance97

Actively maintained with recent releases

Popularity6

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity49

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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 ~0 days

Total

4

Last Release

18d ago

Major Versions

v1.0.1 → 5.x-dev2026-03-06

### Community

Maintainers

![](https://www.gravatar.com/avatar/d3b124fd52a66c0436019492fecc95dcae08e2bd45ea8e3e376ce494830948ed?d=identicon)[dmitrii.arnaut@gmail.com](/maintainers/dmitrii.arnaut@gmail.com)

---

Top Contributors

[![arnautdev](https://avatars.githubusercontent.com/u/13415129?v=4)](https://github.com/arnautdev "arnautdev (2 commits)")

---

Tags

filamentfilament-adminfilament-pluginfilament-pluginsfilamentphplaravellaravel-packagelaravelfilamentfilament-pluginfilamentphparnautdevfilament-envfilament-deploy-infofilament-deploy-indicator

###  Code Quality

TestsPest

Static AnalysisPHPStan, Rector

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/arnautdev-filament-deploy-indicator/health.svg)

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

###  Alternatives

[a909m/filament-statefusion

Filament StateFusion is a powerful FilamentPHP plugin that seamlessly integrates Spatie Laravel Model States into the Filament admin panel. This package provides an intuitive way to manage model states, transitions, and filtering within Filament, enhancing the user experience and developer productivity.

295.8k1](/packages/a909m-filament-statefusion)

PHPackages © 2026

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