1- ``` ascii
2- ▄▀▀▄ ▄▀█ █▀▀▄ ▀ █▀▀▄ █▀▀▄
3- ▀▄▄ █▀█▀▄ █ ▄▀▀▄ █▀▀▄ █ █ ▀█ ▄▀▀▄ ▄▀▀▄ ▄▀▀▄ █ █ ▄▀▀▄ █ █ █▀▀▄ ▄▀▀▄ █▄▀
4- █ █ █ █ █ █ ▀█▀ █ █ █ █ █ █ █ █ █ ▀▄ █ █ █ █ █ █▀▀ █ █ █ █ ▄▄█ █
5- ▀▄▄▀ ▀▄▄█ █ █ █ ▀▄▄▀ █ █ ▀▄▄█ █▄▄▀ ▄█▄ ▀▄▄▀ ▀▄▄▀ ▀▄▄▀ █▄▄▀ ▀▄▄▀ ▀▄▀ █▄▄▀ ▀▄▄▀ █
6- ▄▄▄▀ ▄▄▄▀
7-
8- Customizable developer toolbar for Symfony projects
9- ```
10-
1+ ![ img] ( img/banner.webp )
112
12- [ ![ Latest Stable Version] ( https://poser.pugx.org/marcin-orlowski/symfony-discodevbar /v )] ( https://packagist.org/packages/marcin-orlowski/symfony-discodevbar )
13- [ ![ Monthly Downloads] ( https://poser.pugx.org/marcin-orlowski/symfony-discodevbar /d/monthly )] ( https://packagist.org/packages/marcin-orlowski/symfony-discodevbar )
14- [ ![ License] ( https://poser.pugx.org/marcin-orlowski/symfony-discodevbar /license )] ( https://packagist.org/packages/marcin-orlowski/symfony-discodevbar )
3+ [ ![ Latest Stable Version] ( https://poser.pugx.org/marcin-orlowski/disco-toolbar-symfony /v )] ( https://packagist.org/packages/marcin-orlowski/disco-toolbar-symfony )
4+ [ ![ Monthly Downloads] ( https://poser.pugx.org/marcin-orlowski/disco-toolbar-symfony /d/monthly )] ( https://packagist.org/packages/marcin-orlowski/disco-toolbar-symfony )
5+ [ ![ License] ( https://poser.pugx.org/marcin-orlowski/disco-toolbar-symfony /license )] ( https://packagist.org/packages/marcin-orlowski/disco-toolbar-symfony )
156
167
178# Welcome!
189
19- ** DiscoDevBar** is a developer tool that adds a customizable toolbar/banner to your Symfony application,
20- providing all-time access to essential development resources right from your browser. Perfect for
21- streamlining your development workflow by keeping frequently-used tools, admin panels, and services
22- just one click away.
10+ ** DiscoToolbar** is a customizable toolbar for your Symfony application, providing all-time access to
11+ essential resources right from your browser. Perfect for streamlining your workflow by keeping
12+ frequently-used tools, admin panels, and services just one click away.
13+
14+ > ** NOTE:** This package is also available for Laravel framework!
15+ > See [ project page] ( https://github.com/MarcinOrlowski/php-discotoolbar-laravel ) for more information!
2316
24- ## What is DiscoDevBar ?
17+ ## What is DiscoToolbar ?
2518
26- DiscoDevBar creates a persistent banner (typically placed at the top of your layout) that displays
19+ DiscoToolbar creates a persistent banner (typically placed at the top of your layout) that displays
2720during development. It's highly configurable via YAML, allowing you to create custom buttons and
2821links to anything you need: admin panels, database tools, email catchers, API documentation, or
29- any other development resource.
22+ any other resource.
3023
31- ![ img] ( img/disco-devbar.png )
24+ ![ img] ( img/disco-toolbar.webp )
3225
3326### Perfect for Docker Environments
3427
3528Since configuration is YAML-based, it's incredibly easy to generate dynamically when setting up new
36- development environments. When using Docker or similar containerization, port numbers often change
37- between setups - but with DiscoDevBar , you can regenerate the configuration file on each environment
29+ environments. When using Docker or similar containerization, port numbers often change
30+ between setups - but with DiscoToolbar , you can regenerate the configuration file on each environment
3831startup, ensuring all links always point to the correct ports and services.
3932
4033## Features
4134
4235- ** Fully customizable via YAML** - Easy to configure and regenerate for different environments
4336- ** Flexible widget system** - Create buttons with Font Awesome icons, emoji, text labels, or any combination
44- - ** Display anything** - Add links to admin panels, database tools, email catchers, API docs, or any development resource
37+ - ** Display anything** - Add links to admin panels, database tools, email catchers, API docs, or any resource
4538- ** Action buttons** - Direct access to frequently-used tools and services
4639- ** Environment-aware** - Only loads in development environment, zero production overhead
4740- ** Dynamic configuration** - Perfect for Docker setups where ports change - regenerate config on startup
@@ -50,22 +43,22 @@ startup, ensuring all links always point to the correct ports and services.
5043## Requirements
5144
5245- PHP 8.1 or higher
53- - Symfony 6.4+ or 7 .0+
46+ - Symfony 6.4+, 7.0+, or 8 .0+
5447
5548## Installation
5649
5750Install via Composer:
5851
5952``` bash
60- composer require marcinorlowski/symfony-discodevbar --dev
53+ composer require --dev marcin-orlowski/disco-toolbar-symfony
6154```
6255
6356Register the bundle in ` config/bundles.php ` :
6457
6558``` php
6659return [
6760 // ... other bundles
68- MarcinOrlowski\DiscoDevBar\DiscoDevBarBundle ::class => ['dev' => true],
61+ MarcinOrlowski\DiscoToolbar\DiscoToolbarBundle ::class => ['dev' => true],
6962];
7063```
7164
@@ -80,10 +73,10 @@ php bin/console assets:install --symlink
8073Create a configuration file in your project root with widget configuration. The bundle will automatically
8174detect and load the first file found (in order of preference):
8275
83- - ` .disco-devbar .yaml ` (recommended)
84- - ` .disco-devbar .yml `
76+ - ` .disco.yaml ` (recommended)
77+ - ` .disco.yml `
8578
86- Example configuration that produces devbar shown in the screenshot above:
79+ Example configuration that produces toolbar shown in the screenshot above:
8780
8881``` yaml
8982widgets :
@@ -121,26 +114,26 @@ widgets:
121114
122115### Widget Properties
123116
124- | Property | Type | Required | Description |
125- |-------------|:--------:|:--------:|--------------------------------------------------------------------------------|
126- | ` type` | `string` | | Widget type: `link` (default) or `close` (dismisses devbar ). |
127- | `icon`* | `string` | | Optional icon to display. Can be Font Awesome class or emoji/text. |
128- | `icon_type` | `string` | | Icon type : ` fa` (Font Awesome, default) or `text` (emoji/plain text). |
129- | `text`* | `string` | | Optional widget label to display alongside icon. |
130- | `url` | `string` | * | Link URL to redirect to once widget is clicked. |
131- | `target` | `string` | | Link target (e.g., `_blank`). Default : no target |
132- | `title` | `string` | | Tooltip text. If not given, `url` is shown. |
133- | `expand` | `bool` | | Set to `true` to make widget expand and fill available space. Default `false`. |
117+ | Property | Type | Required | Description |
118+ |-------------|:--------:|:--------:|--------------------------------------------------------------------------------- |
119+ | ` type` | `string` | | Widget type: `link` (default) or `close` (dismisses toolbar ). |
120+ | `icon`* | `string` | | Optional icon to display. Can be Font Awesome class or emoji/text. |
121+ | `icon_type` | `string` | | Icon type : ` fa` (Font Awesome, default) or `text` (emoji/plain text). |
122+ | `text`* | `string` | | Optional widget label to display alongside icon. |
123+ | `url` | `string` | * | Link URL to redirect to once widget is clicked. |
124+ | `target` | `string` | | Link target (e.g., `_blank`). Default : no target |
125+ | `title` | `string` | | Tooltip text. If not given, `url` is shown. |
126+ | `expand` | `bool` | | Set to `true` to make widget expand and fill available space. Default `false`. |
134127
135128*) Either `icon` or `text` must be provided or exception will be thrown.
136129
137130# ## Font Awesome Icons
138131
139- DiscoDevBar supports Font Awesome icons for widgets. You have two options for including Font Awesome :
132+ DiscoToolbar supports Font Awesome icons for widgets. You have two options for including Font Awesome :
140133
141134# ### Option 1: Automatic Inclusion (Recommended for Quick Setup)
142135
143- Enable automatic Font Awesome inclusion from CDN in your `.disco-devbar .yaml` configuration file :
136+ Enable automatic Font Awesome inclusion from CDN in your `.disco.yaml` configuration file :
144137
145138` ` ` yaml
146139font_awesome:
@@ -166,7 +159,7 @@ your project, use Option 2 instead to avoid version conflicts.
166159# ### Option 2: Manual Setup (Recommended if Font Awesome Already Installed)
167160
168161If your application already includes Font Awesome (via NPM, CDN, or other means), simply use Font Awesome icon
169- classes in your widget configuration. DiscoDevBar will use your existing Font Awesome installation.
162+ classes in your widget configuration. DiscoToolbar will use your existing Font Awesome installation.
170163
171164**Example:**
172165
@@ -198,19 +191,19 @@ widgets:
198191
199192# # Usage
200193
201- Include the devbar template in your base layout :
194+ Include the toolbar template in your base layout :
202195
203196` ` ` twig
204197{% if app.environment == 'dev' %}
205- {% include '@DiscoDevBar/devbar .html.twig' %}
198+ {% include '@DiscoToolbar/toolbar .html.twig' %}
206199{% endif %}
207200` ` `
208201
209202# # Customization
210203
211204# ## Background Colors
212205
213- Customize the breathing stripes background colors in your `.disco-devbar .yaml` :
206+ Customize the breathing stripes background colors in your `.disco.yaml` :
214207
215208` ` ` yaml
216209bg_color_light: '#b71c1c'
@@ -220,15 +213,15 @@ bg_color_dark: '#8e0000'
220213# ## Custom CSS
221214
222215The bundle includes default styling. To customize, override the CSS after importing bundle assets or
223- create your own styles targeting `.disco-devbar ` classes.
216+ create your own styles targeting `.disco-toolbar ` classes.
224217
225218# ## Custom Template
226219
227220Override the default template by creating :
228- ` templates/bundles/DiscoDevBarBundle/devbar .html.twig`
221+ ` templates/bundles/DiscoToolbarBundle/toolbar .html.twig`
229222
230223# # License
231224
232- - Written and copyrighted ©2025 by Marcin Orlowski <mail (#) marcinorlowski (.) com>
233- - DiscoDevBar is open-source software licensed under
225+ - Written and copyrighted ©2025-2026 by Marcin Orlowski <mail (#) marcinorlowski (.) com>
226+ - DiscoToolbar is open-source software licensed under
234227 the [MIT license](http://opensource.org/licenses/MIT)
0 commit comments