konradmichalik/typo3-environment-indicator

Environment Indicator - TYPO3 extension with several features to show an environment indicator in the TYPO3 frontend and backend.

3.4.0 2026-07-28 13:29 UTC

Requires

• php: ~8.2.0 || ~8.3.0 || ~8.4.0 || ~8.5.0
• ext-dom: *
• ext-filter: *
• ext-libxml: *
• ext-mbstring: *
• intervention/image: ^3.11.7 || ^4.0
• konradmichalik/php-color: ^0.2
• konradmichalik/php-ico-file-loader: ^0.3
• meyfa/php-svg: ^0.16
• psr/http-factory: ^1.0
• psr/http-message: ^1.0 || ^2.0
• psr/http-server-handler: ^1.0.2
• psr/http-server-middleware: ^1.0.2
• psr/log: ^3.0.2
• symfony/console: ^7.0 || ^8.0
• symfony/expression-language: ^7.0 || ^8.0
• symfony/mime: ^7.0 || ^8.0
• typo3/cms-backend: ^13.4 || ^14.3
• typo3/cms-core: ^13.4 || ^14.3
• typo3/cms-dashboard: ^13.4 || ^14.3
• typo3/cms-fluid: ^13.4 || ^14.3
• typo3fluid/fluid: ^4.2 || ^5.0

Requires (Dev)

• eliashaeussler/typo3-vendor-bundler: ^4.1.0
• eliashaeussler/version-bumper: ^4.0.3
• konradmichalik/ttt: ^0.2.0
• phpunit/phpcov: ^10.0 || ^11.0 || ^13.0
• phpunit/phpunit: ^11.0 || ^12.0 || ^13.0
• typo3/cms-base-distribution: ^13.4 || ^14.3
• typo3/cms-lowlevel: ^13.4 || ^14.3
• typo3/testing-framework: ^9.6.1

Suggests

• ext-gd: Required for image processing and rendering of SVG icons.
• ext-imagick: Required for image processing and rendering of SVG icons with Imagick support.
• intervention/image-driver-vips: Required for image processing and rendering of SVG icons with VIPS support.

GPL-2.0-or-later

• Konrad Michalik

Published on Packagist.org on 2026-07-28 13:29 UTC

README

TYPO3 extension typo3_environment_indicator

This extension provides several features to show an environment indicator in the TYPO3 frontend and backend, and beyond (CLI, mails).

Note

Has it ever happened to you that you changed data on a test system and then realized: oh no, that's the live system. Well, to prevent that from happening (again), I created this extension.

✨ Features

Icon	Preview	Feature
Frontend + Backend
		Modified favicon Modify the favicon for frontend and backend based on the original favicon, the current application context and your configuration.
		Page title Prefix or suffix the page title in frontend and backend with the current application context.
Frontend
		Frontend hint Adds an informative hint to the frontend showing the website title and the current application context.
		Modified frontend image Modify frontend image based on the original image, the current application context and your configuration.
Backend
		Backend toolbar item Adds an informative item with the current application context to the backend toolbar.
		Backend topbar Colorize the backend header topbar regarding the application context.
		Modified backend logo Modify the backend logo based on the original logo, the current application context and your configuration.
		Dashboard widget Render a dashboard widget according to the environment.
		Backend theme (experimental) Colorize the entire TYPO3 v14+ backend (primary color, header, sidebar) based on the environment.
		Backend login Show a colored environment badge directly on the backend login screen.
Misc
		CLI banner Print a colored environment banner to stderr before an interactive console command runs.
		Mail subject prefix Prepends the environment to the subject of every mail sent through the TYPO3 Mailer API.

Note

These environment indicators are mainly for development purposes (e.g. distinguishing between different test systems) and will not show on the live production site. They do show in Production/Staging and Production/Standby application contexts, where they help distinguish those systems from the live site.

🔥 Installation

Requirements

Version	TYPO3	PHP
3.x	13.4 - 14.x	8.2 - 8.5
2.x	11.5 - 13.4	8.1 - 8.4

Composer

Use the following composer command to install the extension:

composer require konradmichalik/typo3-environment-indicator

TER

Download the zip file from TYPO3 extension repository (TER).

📙 Documentation

Please have a look at the official extension documentation.

🧑‍💻 Contributing

Please have a look at CONTRIBUTING.md.

💎 Credits

This project is partly inspired by the laravel-favicon package.

⭐ License

This project is licensed under GNU General Public License 2.0 (or later).