Download the PHP package marcin-orlowski/disco-toolbar-symfony without Composer
On this page you can find all versions of the php package marcin-orlowski/disco-toolbar-symfony. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download marcin-orlowski/disco-toolbar-symfony
More information about marcin-orlowski/disco-toolbar-symfony
Files in marcin-orlowski/disco-toolbar-symfony
Package disco-toolbar-symfony
Short Description Customizable toolbar for Symfony projects
License MIT
Informations about the package disco-toolbar-symfony
Welcome!
DiscoToolbar is a customizable toolbar for your Symfony application, providing all-time access to essential resources right from your browser. Perfect for streamlining your workflow by keeping frequently-used tools, admin panels, and services just one click away.
NOTE: This package is also available for Laravel framework! See project page for more information!
What is DiscoToolbar?
DiscoToolbar creates a persistent banner (typically placed at the top of your layout) that displays during development. It's highly configurable via YAML, allowing you to create custom buttons and links to anything you need: admin panels, database tools, email catchers, API documentation, or any other resource.
Perfect for Docker Environments
Since configuration is YAML-based, it's incredibly easy to generate dynamically when setting up new environments. When using Docker or similar containerization, port numbers often change between setups - but with DiscoToolbar, you can regenerate the configuration file on each environment startup, ensuring all links always point to the correct ports and services.
Features
- Fully customizable via YAML - Easy to configure and regenerate for different environments
- Flexible widget system - Create buttons with Font Awesome icons, Symfony UX Icons, emoji, text labels, or any combination
- Display anything - Add links to admin panels, database tools, email catchers, API docs, or any resource
- Action buttons - Direct access to frequently-used tools and services
- Environment-aware - Only loads in development environment, zero production overhead
- Dynamic configuration - Perfect for Docker setups where ports change - regenerate config on startup
- Customizable placement - Position widgets on left or right side of the toolbar
Requirements
- PHP 8.1 or higher
- Symfony 6.4+, 7.0+, or 8.0+
Optional Dependencies
symfony/ux-icons- Required foricon_type: uxsupport (200,000+ icons)
Notes
There's also Laravel version of this package!
Installation
Install via Composer:
For access to 200,000+ icons via Symfony UX Icons (recommended):
Register the bundle in config/bundles.php:
Install bundle assets:
Configuration
Create a configuration file with widget configuration. The bundle will automatically detect and load the first file found (in order of preference):
.disco.yaml(project root).disco.yml(project root)config/packages/disco_toolbar.yaml(Symfony convention)config/packages/disco_toolbar.yml
Example configuration that produces toolbar shown in the screenshot above:
Widget Properties
| Property | Type | Required | Description |
|---|---|---|---|
type |
string |
Widget type: link (default) or close (dismisses toolbar). |
|
icon* |
string |
Optional icon to display (Font Awesome class, UX Icons name, or emoji/text). | |
icon_type |
string |
Icon type: fa (Font Awesome, default), ux (Symfony UX Icons), or text. |
|
text* |
string |
Optional widget label to display alongside icon. | |
url |
string |
* | Link URL to redirect to once widget is clicked. |
target |
string |
Link target (e.g., _blank). Default: no target |
|
title |
string |
Tooltip text. If not given, url is shown. |
|
expand |
bool |
Set to true to make widget expand and fill available space. Default false. |
*) Either icon or text must be provided or exception will be thrown.
Font Awesome Icons
DiscoToolbar supports Font Awesome icons for widgets. You have two options for including Font Awesome:
Option 1: Automatic Inclusion (Recommended for Quick Setup)
Enable automatic Font Awesome inclusion from CDN in your .disco.yaml configuration file:
Benefits:
- Works out of the box - no additional setup needed
- Icons display immediately
- Configuration kept in one place with your widgets
Note: Only enable this if your application doesn't already include Font Awesome. If you have Font Awesome in your project, use Option 2 instead to avoid version conflicts.
Option 2: Manual Setup (Recommended if Font Awesome Already Installed)
If your application already includes Font Awesome (via NPM, CDN, or other means), simply use Font Awesome icon classes in your widget configuration. DiscoToolbar will use your existing Font Awesome installation.
Example:
If you don't have Font Awesome installed, you can include it manually in your base template:
Using Text/Emoji Instead
If you prefer not to use Font Awesome, you can use emoji or plain text:
Symfony UX Icons
DiscoToolbar supports Symfony UX Icons, which provides access to 200,000+ icons from popular icon sets (Lucide, Heroicons, Font Awesome, and more) as inline SVGs.
First, install the UX Icons package:
Then use the ux icon type with icon names in the set:name format:
Browse available icons at ux.symfony.com/icons.
Note: If symfony/ux-icons is not installed, widgets with icon_type: ux will display
the icon name in brackets as a fallback (e.g., [lucide:github]).
Usage
Include the toolbar template in your base layout:
Customization
Background Colors
Customize the breathing stripes background colors in your .disco.yaml:
Custom CSS
The bundle includes default styling. To customize, override the CSS after importing bundle assets or
create your own styles targeting .disco-toolbar classes.
Custom Template
Override the default template by creating:
templates/bundles/DiscoToolbarBundle/toolbar.html.twig
License
- Written and copyrighted ©2025-2026 by Marcin Orlowski <mail (#) marcinorlowski (.) com>
- DiscoToolbar is open-source software licensed under the MIT license
All versions of disco-toolbar-symfony with dependencies
symfony/dependency-injection Version ^6.4|^7.0|^8.0
symfony/http-kernel Version ^6.4|^7.0|^8.0
symfony/yaml Version ^6.4|^7.0|^8.0
symfony/twig-bundle Version ^6.4|^7.0|^8.0