asmitta-01/toast-bundle

UX Toast display for your Symfony project.

v0.4.1 2026-07-04 03:13 UTC

Requires

• php: >=8.1
• symfony/asset: ^6.4 || ^7.0 || ^8.0
• symfony/config: ^6.0 || ^7.0 || ^8.0
• symfony/dependency-injection: ^6.0 || ^7.0 || ^8.0
• symfony/event-dispatcher: ^6.0 || ^7.0 || ^8.0
• symfony/framework-bundle: ^6.0 || ^7.0 || ^8.0
• symfony/http-foundation: ^6.0 || ^7.0 || ^8.0
• symfony/http-kernel: ^6.0 || ^7.0 || ^8.0
• symfony/options-resolver: ^6.0 || ^7.0 || ^8.0
• symfony/security-core: ^6.0 || ^7.0 || ^8.0
• symfony/translation: ^6.0 || ^7.0 || ^8.0
• symfony/validator: ^6.0 || ^7.0 || ^8.0
• symfony/yaml: ^6.0 || ^7.0 || ^8.0

Requires (Dev)

• phpstan/extension-installer: ^1.1
• phpstan/phpstan: ^1.12
• phpstan/phpstan-deprecation-rules: ^1.0
• phpstan/phpstan-strict-rules: ^1.1
• phpstan/phpstan-symfony: ^1.4
• phpunit/phpunit: ^9.5 || ^10.0 || ^11.0
• symfony/browser-kit: ^6.0 || ^7.0 || ^8.0
• symfony/css-selector: ^6.0 || ^7.0 || ^8.0
• symfony/mime: ^6.0 || ^7.0 || ^8.0
• symfony/phpunit-bridge: ^7.0 || ^8.0
• symfony/security-bundle: ^6.0 || ^7.0 || ^8.0
• symfony/twig-bundle: ^6.0 || ^7.0 || ^8.0

MIT

• Brayan Tiwa

• symfony
• bootstrap
• ux
• toast

Published on Packagist.org on 2026-07-04 06:14 UTC

README

A Symfony bundle for displaying toast notifications from flash messages, with no Bootstrap CSS or JavaScript dependency.

Installation

Make sure Composer is installed globally, as explained in the installation chapter of the Composer documentation.

Open a command console, enter your project directory and execute:

composer require asmitta-01/toast-bundle

The bundle is compatible with Symfony 6, 7 and 8.

If your application exposes bundle assets through the public directory, install them after requiring the package:

php bin/console assets:install

Configuration

If your application doesn't use Symfony Flex, enable the bundle in config/bundles.php:

return [
    // ...
    Asmitta\ToastBundle\AsmittaToastBundle::class => ['all' => true],
];

Create a configuration file at config/packages/asmitta_toast.yaml, see docs/config.md.

Usage

1. Add flash messages in your controller

use Asmitta\ToastBundle\Enum\ToastType;

public function someAction(Request $request): Response
{
    $this->addFlash('success', 'Operation completed successfully!'); // 'success' or ToastType::SUCCESS->value
    $this->addFlash('warning', 'Please check your input.');
    $this->addFlash('error', 'Something went wrong.');
    $this->addFlash('info', 'Here is some information.');
    
    return $this->render('your_template.html.twig');
}

2. Render toasts in your template

{{ render_toasts() }}

By default, the bundle automatically loads its CSS and JavaScript assets when rendering toasts.

If you use the with_icon or colored_icon templates, include Bootstrap Icons in your page:

<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap-icons@1.11.3/font/bootstrap-icons.min.css">

3. Optional: disable automatic asset loading

If you prefer to manage assets manually (for example with your own pipeline), disable auto loading:

asmitta_toast:
    auto_load_assets: false

Then include the assets yourself:

<link href="{{ asset('bundles/asmittaToast/css/toast.css') }}" rel="stylesheet">
<link href="{{ asset('bundles/asmittaToast/css/spacing.css') }}" rel="stylesheet">
<link href="{{ asset('bundles/asmittaToast/css/toast-progress-bar.css') }}" rel="stylesheet"> <!-- optional -->
<script src="{{ asset('bundles/asmittaToast/js/toast.js') }}"></script>

Toast Types

The bundle supports these flash message types:

• success → Green toast
• warning → Yellow toast
• error or danger → Red toast
• info (default) → Light Blue toast

Features

• Automatic mapping of flash message types to toast variants
• Configurable auto-hide timer (default: 5 seconds)
• Flexible positioning (7 positions available, see ToastPosition Enum)
• Limit maximum toasts per type
• Optional progress bar showing remaining time
• Dismissible toasts with close button
• Responsive design
• Twig template-based rendering
• Full configuration support
• No Bootstrap CSS or JavaScript dependency
• Symfony 6, 7 and 8 compatibility
• Automatic CSS/JS loading by default

Breaking Changes In 0.4.0

• The root toast class changed from toast to asmitta-toast
• Bootstrap toast classes and utility classes were replaced by asmitta- prefixed classes
• Bootstrap JavaScript is no longer used or required for rendering toasts