PHPackages mikomagni/statamic-environment - 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. mikomagni/statamic-environment ActiveStatamic-addon[Utility & Helpers](/categories/utility) mikomagni/statamic-environment ============================== Statamic Environment Indicator and Dashboard Widget for Statamic 6 v2.0.1(1w ago)22.3kโ†‘85.7%MITPHPPHP ^8.3 Since Jul 18Pushed 1w agoCompare [ Source](https://github.com/mikomagni/statamic-environment)[ Packagist](https://packagist.org/packages/mikomagni/statamic-environment)[ Docs](https://graffio.co)[ RSS](/packages/mikomagni-statamic-environment/feed)WikiDiscussions main Synced yesterday READMEChangelog (3)Dependencies (2)Versions (6)Used By (0) Statamic Environment Indicator ============================== [](#statamic-environment-indicator) > Visual environment indicators for the Statamic control panel, instantly see whether you're working in Local, Staging, or Production. The addon adds a colored badge and background pattern to the CP header, plus a dashboard widget with environment details, so you never push the wrong button in the wrong environment again. Features -------- [](#features) - **Header Badge**: Shows the current environment name in the CP header (Local, Staging, Production) - **Header Background Patterns**: Distinct header patterns per environment (stripes, dots, checkerboard, solid) - **Dashboard Widget**: Built with native Statamic UI components, with full dark-mode support - **Highly Configurable**: Custom environment types, labels, icons, colors, and patterns - **Translation Ready**: Full i18n support with publishable language files - **Auto-Regenerating CSS**: Edits to the config apply automatically, no build step Compatibility ------------- [](#compatibility) Addon versionStatamicPHPLaravel**2.x** (this version)6.0+8.3+12.0+1.x5.0+8.1+10 / 11> Installing on **Statamic 5**? Require `^1.0` instead. See [Upgrading from 1.x](#upgrading-from-1x). Installation ------------ [](#installation) Install via Composer: ``` composer require mikomagni/statamic-environment ``` Composer automatically resolves the correct release for your Statamic version (2.x for Statamic 6, 1.x for Statamic 5). The config file is published automatically on install. To (re)publish it manually: ``` php artisan vendor:publish --tag=statamic-env-config ``` Enable the Widget ----------------- [](#enable-the-widget) Add the widget to your control panel in `config/statamic/cp.php`: ``` 'widgets' => [ [ 'type' => 'statamic_env', 'width' => 100, ], // ... other widgets ], ``` Configuration ------------- [](#configuration) All configuration lives in `config/statamic_environment.php`. ### Environment Types [](#environment-types) Map your `APP_ENV` values to environment types. The keys are your type names; the arrays list the `APP_ENV` values that resolve to each type: ``` 'environments' => [ 'local' => ['local'], 'staging' => ['staging', 'dev'], 'production' => ['production', 'prod', 'live'], ], ``` An `APP_ENV` that doesn't match any type resolves to `undefined`, which triggers a warning in the widget and the `undefined` icon. ### Labels & Icons [](#labels--icons) Customize the display text and emoji per type: ``` 'labels' => [ 'local' => 'Local', 'staging' => 'Staging', 'production' => 'Live', ], 'icons' => [ 'local' => '๐Ÿ‘จโ€๐Ÿ’ป', 'staging' => '๐Ÿ”ฅ', 'production' => '๐Ÿš€', 'undefined' => '๐Ÿšจ', ], ``` ### Badge Colors [](#badge-colors) Style the header badge per type. `border` is optional: ``` 'colors' => [ 'local' => [ 'background' => 'rgba(39, 145, 16, 0.6)', 'color' => 'white', 'border' => '1px solid rgba(39, 145, 16, 1)', ], 'staging' => [ 'background' => 'rgba(153, 0, 0, 0.6)', 'color' => 'white', 'border' => '1px solid rgba(153, 0, 0, 1)', ], 'production' => [ 'background' => 'transparent', 'color' => 'white', 'border' => '1px solid rgba(255, 255, 255, 0.5)', ], ], ``` ### Widget Details [](#widget-details) Control when the widget shows the detailed environment table: ``` 'widget' => [ 'show_details' => ['local', 'staging'], // Show only for these types // 'show_details' => true, // Always show // 'show_details' => false, // Never show ], ``` **Accepted values:** - **Array**: show details only for the listed environment types, e.g. `['local', 'staging']` - **`true`**: always show details - **`false`**: never show details When enabled, the table reports: `APP_NAME`, `APP_ENV`, `APP_DEBUG`, `APP_URL`, `MAIL_MAILER`, `MAIL_FROM_ADDRESS`, `STATAMIC_GIT_ENABLED`, `STATAMIC_GIT_PUSH`, `STATAMIC_STATIC_CACHING_STRATEGY`, and `DEBUGBAR_ENABLED`. ### Background Patterns [](#background-patterns) Give each environment a distinct CP header pattern. Colors are defined directly with `primary` and `secondary` keys: ``` 'patterns' => [ 'local' => [ 'type' => 'stripes', 'angle' => -45, 'primary' => 'transparent', 'secondary' => 'rgba(0, 0, 0, 0.6)', ], 'staging' => [ 'type' => 'stripes', 'angle' => -45, 'primary' => 'transparent', 'secondary' => 'rgba(255, 112, 163, 0.2)', ], 'production' => [ 'type' => 'solid', 'primary' => 'transparent', ], ], ``` > **Note:** The Statamic 6 CP header is always dark, so patterns use flat `primary`/`secondary` keys, with no `light_mode`/`dark_mode` nesting. The old nested format from 1.x is still read for backward compatibility, but the simplified format is recommended. #### Pattern Types [](#pattern-types) **Stripes**: diagonal repeating lines: ``` 'type' => 'stripes', 'angle' => -45, // Angle in degrees (default: -55) 'size' => 10, // Stripe width in pixels (default: 10) 'primary' => 'transparent', // Background color 'secondary' => 'rgba(0, 0, 0, 0.6)', // Stripe color ``` **Dots**: polka-dot pattern: ``` 'type' => 'dots', 'size' => '4px', // Dot size (default: 4px) 'spacing' => '20px', // Space between dots (default: 20px) 'primary' => '#1a1a1a', // Background color 'secondary' => '#ff4757', // Dot color ``` **Checkerboard:** ``` 'type' => 'checkerboard', 'size' => 20, // Square size in pixels (default: 20) 'primary' => '#1a1a1a', // Background color 'secondary' => '#ffab00', // Checkerboard color ``` **Solid**: plain color (only needs `primary`): ``` 'type' => 'solid', 'primary' => 'transparent', ``` Custom Environment Types ------------------------ [](#custom-environment-types) Type names are fully customizable, so you're not limited to `local`/`staging`/`production`. Define your own and provide matching `labels`, `icons`, `colors`, and `patterns`: ``` return [ 'environments' => [ 'development' => ['local', 'dev'], 'testing' => ['test', 'qa', 'staging'], 'live' => ['production', 'prod'], 'uat' => ['uat', 'acceptance'], ], 'labels' => [ 'development' => 'Dev', 'testing' => 'Test', 'live' => 'Production', 'uat' => 'UAT', ], 'icons' => [ 'development' => '๐Ÿ› ๏ธ', 'testing' => '๐Ÿงช', 'live' => '๐Ÿš€', 'uat' => 'โœ…', 'undefined' => '๐Ÿšจ', ], 'colors' => [ 'development' => [ 'background' => 'rgb(0, 123, 255)', 'color' => 'white', ], 'testing' => [ 'background' => 'rgb(255, 193, 7)', 'color' => 'black', ], 'live' => [ 'background' => 'rgb(40, 167, 69)', 'color' => 'white', ], 'uat' => [ 'background' => 'rgb(108, 117, 125)', 'color' => 'white', ], ], 'patterns' => [ 'development' => [ 'type' => 'stripes', 'angle' => -55, 'primary' => '#1a1a1a', 'secondary' => 'rgba(0, 123, 255, 0.3)', ], 'testing' => [ 'type' => 'dots', 'size' => '5px', 'spacing' => '15px', 'primary' => '#1a1a1a', 'secondary' => 'rgba(255, 193, 7, 0.4)', ], 'live' => [ 'type' => 'solid', 'primary' => '#1a1a1a', ], 'uat' => [ 'type' => 'checkerboard', 'size' => 15, 'primary' => '#1a1a1a', 'secondary' => 'rgba(108, 117, 125, 0.3)', ], ], ]; ``` How It Works ------------ [](#how-it-works) - A CP middleware adds `env_{APP_ENV}` and `env_type_{type}` classes to the `` tag. - The addon generates a dynamic stylesheet from your config and registers it with the CP. The header badge and background patterns are pure CSS keyed off those body classes. - The CSS is regenerated automatically whenever the config file changes, no asset compilation or `npm` step required. Translation Support ------------------- [](#translation-support) All widget text is translatable and follows Laravel's localization conventions. To customize translations, publish the language files: ``` php artisan vendor:publish --tag=statamic-env-lang ``` This copies the files to `resources/lang/vendor/statamic-environment/`, where you can: - Add new languages by creating a locale folder (e.g. `es`, `fr`, `de`) - Edit the English strings in `en/widget.php` ### Available Translation Keys [](#available-translation-keys) - `viewing_version`: main status message shown in the widget - `unusual_env_detected`: warning for unrecognized environments - `app_name`, `app_env`, `app_debug`, `app_url`, `mail_mailer`, `mail_from_address`, `statamic_git_enabled`, `statamic_git_push`: detail table labels - `true`, `false`: boolean values Upgrading from 1.x ------------------ [](#upgrading-from-1x) Version 2.0 targets Statamic 6 and raises the minimum platform requirements: - **Statamic 6.0+**, **PHP 8.3+**, **Laravel 12.0+** - The dashboard widget was rebuilt with native Statamic 6 UI components (full dark-mode support). - Widget configuration is simplified to a single `show_details` option. The old `always_show_details` / `never_show_details` flags are removed. Use `'show_details' => true` or `false` instead. - Pattern colors use flat `primary`/`secondary` keys instead of `light_mode`/`dark_mode` nesting (the old format still works, but updating is recommended). To upgrade, require the new version and run `composer update`: ``` composer require mikomagni/statamic-environment:^2.0 composer update mikomagni/statamic-environment ``` Staying on Statamic 5? Pin to the 1.x line, which remains installable but is no longer actively maintained: ``` composer require mikomagni/statamic-environment:^1.0 ``` License ------- [](#license) This addon is open-sourced software licensed under the [MIT license](LICENSE). ### Health Score 49 โ€” FairBetter than 94% of packages Maintenance98 Actively maintained with recent releases Popularity23 Limited adoption so far Community6 Small or concentrated contributor base Maturity55 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 ~85 days Total 5 Last Release 8d ago Major Versions 1.x-dev โ†’ v6.x-dev2025-11-21 ### Community Maintainers ![](https://avatars.githubusercontent.com/u/2527231?v=4)[Miko Magni](/maintainers/MikoMagni)[@mikomagni](https://github.com/mikomagni) --- Top Contributors [![mikomagni](https://avatars.githubusercontent.com/u/2527231?v=4)](https://github.com/mikomagni "mikomagni (17 commits)") --- Tags statamicstatamic-addonstatamic-v5statamic-v6environmentdevelopmentindicatoraddonstatamic ### Embed Badge ![Health badge](/badges/mikomagni-statamic-environment/health.svg) ``` [![Health](https://phpackages.com/badges/mikomagni-statamic-environment/health.svg)](https://phpackages.com/packages/mikomagni-statamic-environment) ``` ### Alternatives [statamic/seo-pro 68516.6k](/packages/statamic-seo-pro)[marcorieser/statamic-livewire A Laravel Livewire integration for Statamic. 23111.5k14](/packages/marcorieser-statamic-livewire)[withcandour/aardvark-seo Save time and get your Statamic site to rank better with the SEO addon for Statamic. 15133.0k](/packages/withcandour-aardvark-seo)[visuellverstehen/statamic-classify A useful helper to add CSS classes to all HTML tags generated by the bard editor. 20121.3k](/packages/visuellverstehen-statamic-classify)[justkidding96/aardvark-seo Save time and get your Statamic site to rank better with the SEO addon for Statamic. 155.4k](/packages/justkidding96-aardvark-seo)[aerni/livewire-forms A Statamic forms framework powered by Laravel Livewire 2915.1k](/packages/aerni-livewire-forms) PHPackages ยฉ 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)