PHPackages                             devrabiul/laravel-toaster-magic - 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. [Mail & Notifications](/categories/mail)
4. /
5. devrabiul/laravel-toaster-magic

ActiveLibrary[Mail & Notifications](/categories/mail)

devrabiul/laravel-toaster-magic
===============================

Laravel Toaster Magic is a lightweight, flexible toast library for Laravel projects, with no jQuery, Bootstrap, or Tailwind dependency.

2.3.0(2w ago)22671.4k↓35.2%151MITCSSPHP ^8.0

Since Apr 8Pushed 1mo ago7 watchersCompare

[ Source](https://github.com/devrabiul/laravel-toaster-magic)[ Packagist](https://packagist.org/packages/devrabiul/laravel-toaster-magic)[ Docs](https://github.com/devrabiul/laravel-toaster-magic)[ RSS](/packages/devrabiul-laravel-toaster-magic/feed)WikiDiscussions main Synced 2d ago

READMEChangelog (10)Dependencies (3)Versions (17)Used By (1)

🍞 Laravel Toaster Magic — v2.1
==============================

[](#-laravel-toaster-magic--v21)

Laravel Toaster Magic is a lightweight, dependency-free toast notification package for Laravel with Livewire v3 & v4 support.

Laravel Toaster Magic provides elegant, fully customizable toast notifications for Laravel applications — with **zero dependency** on jQuery, Bootstrap, or Tailwind CSS. It works out of the box with Livewire, supports multiple modern themes, and is simple enough to drop into any project in minutes.

[![Latest Stable Version](https://camo.githubusercontent.com/a8ff2b2f9edfd804248aa6119abd401034aa8ee49f968bb007ae317dbf0e6603/68747470733a2f2f706f7365722e707567782e6f72672f64657672616269756c2f6c61726176656c2d746f61737465722d6d616769632f762f737461626c65)](https://packagist.org/packages/devrabiul/laravel-toaster-magic)[![Total Downloads](https://camo.githubusercontent.com/5041f002bac594402763148a4d677a8b13db89c2d26005a91a9a1fe5e85ac383/68747470733a2f2f706f7365722e707567782e6f72672f64657672616269756c2f6c61726176656c2d746f61737465722d6d616769632f646f776e6c6f616473)](https://packagist.org/packages/devrabiul/laravel-toaster-magic)[![Monthly Downloads](https://camo.githubusercontent.com/a3466b5b350781e208f71c05ecd60db65dc60880ef9a1d6eea7890464403df2b/68747470733a2f2f706f7365722e707567782e6f72672f64657672616269756c2f6c61726176656c2d746f61737465722d6d616769632f642f6d6f6e74686c79)](https://packagist.org/packages/devrabiul/laravel-toaster-magic)[![GitHub License](https://camo.githubusercontent.com/5629272e087524c8d6ff042aebb16994d2b3bd1f8a436bf1a17ee4a0655555b4/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f64657672616269756c2f6c61726176656c2d746f61737465722d6d61676963)](LICENSE)[![Buy us a tree](https://camo.githubusercontent.com/130148911f548b001b2ac68a32c0a06559977ca60ada3bf480c72ae4ea093175/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f54726565776172652d2546302539462538432542332d6c69676874677265656e)](https://plant.treeware.earth/devrabiul/laravel-toaster-magic)[![GitHub Stars](https://camo.githubusercontent.com/6edaae3ba09979d185257e9f2c997eeeaa8de24cdf5db5683f9cdba358415f10/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73746172732f64657672616269756c2f6c61726176656c2d746f61737465722d6d616769633f7374796c653d736f6369616c)](https://github.com/devrabiul/laravel-toaster-magic)

---

🚀 Live Demo
-----------

[](#-live-demo)

👉 [Try the Live Demo](https://laravel-toaster-magic.rixetbd.com)

[![Live Demo Thumbnail](https://camo.githubusercontent.com/4dc038c1f81a45f56db2d1ae52cff58a465ab2f22311ef6b68aa713adea12253/68747470733a2f2f726978657462642e636f6d2f73746f726167652f6170702f7075626c69632f7061636b6167652f64657672616269756c2f6c61726176656c2d746f61737465722d6d616769632e77656270)](https://camo.githubusercontent.com/4dc038c1f81a45f56db2d1ae52cff58a465ab2f22311ef6b68aa713adea12253/68747470733a2f2f726978657462642e636f6d2f73746f726167652f6170702f7075626c69632f7061636b6167652f64657672616269756c2f6c61726176656c2d746f61737465722d6d616769632e77656270)

---

✨ Features
----------

[](#-features)

- 🔥 **Easy to Use** — Simple, intuitive API with support for both static and fluent syntax.
- 🌍 **RTL Support** — Full compatibility with right-to-left languages.
- 🌙 **Dark Mode** — Built-in dark mode support via a single HTML attribute.
- 🎨 **7+ Themes** — iOS, Neon, Glassmorphism, Material, Minimal, Neumorphism, and Default.
- ⚡ **Livewire Ready** — First-class support for Livewire v3 & v4 with event-based dispatching.
- 🔒 **XSS Safe** — Custom button URLs are sanitized before rendering into the DOM.
- ✅ **Zero Dependencies** — No jQuery, Bootstrap, or Tailwind required.

---

📦 Installation
--------------

[](#-installation)

Install the package via Composer:

```
composer require devrabiul/laravel-toaster-magic
```

Publish the package assets:

```
php artisan vendor:publish --provider="Devrabiul\ToastMagic\ToastMagicServiceProvider"
```

> **Note:** Assets are also auto-published on the first page load and automatically refreshed whenever the package is updated.

---

⚙️ Basic Setup
--------------

[](#️-basic-setup)

Add the stylesheet inside your `` tag and the scripts just before the closing `` tag:

```

    Page Title

    {!! ToastMagic::styles() !!}

    {!! ToastMagic::scripts() !!}

```

---

🧑‍💻 Usage
---------

[](#‍-usage)

### 1. Controller Usage

[](#1-controller-usage)

Trigger toast notifications from your controllers using the `ToastMagic` facade:

```
use Devrabiul\ToastMagic\Facades\ToastMagic;

public function store()
{
    // Simple message
    ToastMagic::success('Successfully Created');

    // Message with description
    ToastMagic::success('Success!', 'Your data has been saved!');

    // With custom options
    ToastMagic::success('Success!', 'Your data has been saved!', [
        'showCloseBtn' => true,
        'customBtnText' => 'View Record',
        'customBtnLink' => 'https://example.com',
    ]);

    return back();
}
```

**Available toast types:** `success`, `info`, `warning`, `error`

---

### 2. JavaScript Usage

[](#2-javascript-usage)

Use ToastMagic directly in JavaScript for AJAX responses or client-side events:

```
const toastMagic = new ToastMagic();

toastMagic.success('Success!', 'Your data has been saved!');
toastMagic.error('Error!', 'Something went wrong.');
toastMagic.warning('Warning!', 'Check your input.', true);
toastMagic.info('Info!', 'Click for details.', false, 'Learn More', 'https://example.com');
```

**Signature:** `toastMagic.{type}(heading, description, showCloseBtn, customBtnText, customBtnLink)`

---

### 3. Livewire Support (v3 & v4)

[](#3-livewire-support-v3--v4)

Enable Livewire support in your config file:

```
// config/laravel-toaster-magic.php

return [
    'options' => [
        // your toast options...
    ],
    'livewire_enabled' => true,
    'livewire_version' => 'v3', // 'v3' or 'v4'
];
```

Dispatch toast notifications from any Livewire component:

```
// With full options
$this->dispatch('toastMagic',
    status: 'success',
    title: 'User Created',
    message: 'The user has been successfully created.',
    options: [
        'showCloseBtn' => true,
        'customBtnText' => 'View Profile',
        'customBtnLink' => 'https://example.com',
    ],
);

// Simple dispatch
$this->dispatch('toastMagic',
    status: 'info',
    title: 'Heads Up',
    message: 'Your session will expire soon.'
);
```

**Supported status values:** `success`, `info`, `warning`, `error`

> **Backward Compatibility:** Both `showCloseBtn` and `closeButton` option keys are supported in Livewire events. If both are provided, `showCloseBtn` takes priority.

---

### 4. Alternative & Fluent Syntax

[](#4-alternative--fluent-syntax)

ToastMagic supports both a quick static method and a fluent dispatch style.

**Static (Quick):**

```
use Devrabiul\ToastMagic\Facades\ToastMagic;

ToastMagic::success('Operation Successful');
ToastMagic::error('Something went wrong');
```

**Fluent (Advanced):**

```
ToastMagic::dispatch()->success(
    'User Created',
    'The user has been successfully created.',
    [
        'showCloseBtn'  => true,
        'customBtnText' => 'View Profile',
        'customBtnLink' => 'https://example.com',
    ]
);
```

---

📍 Position Options
------------------

[](#-position-options)

Control where toasts appear on screen using the `positionClass` config option:

ValuePosition`toast-top-start`Top left`toast-top-end`Top right *(default)*`toast-top-center`Top center`toast-bottom-start`Bottom left`toast-bottom-end`Bottom right`toast-bottom-center`Bottom center---

🎨 Themes
--------

[](#-themes)

ToastMagic includes 7 built-in themes. Set your preferred theme in `config/laravel-toaster-magic.php`:

```
return [
    'options' => [
        "theme" => "default", // See options below
    ],
];
```

ThemeDescription`default`Clean, classic look`material`Material Design — flat and bold`ios`Apple-style notifications with backdrop blur`glassmorphism`Heavy blur, semi-transparent, modern aesthetic`neon`Dark background with glowing borders — ideal for dark UIs`minimal`Clean design with colored left-side accent`neumorphism`Soft UI with extruded shadow stylingFor a full theme preview, see [THEMES.md](THEMES.md).

---

🌈 Color Mode
------------

[](#-color-mode)

Enable color mode to apply toast-type colors automatically to backgrounds and accents:

```
return [
    'options' => [
        'color_mode' => true,
    ],
];
```

---

🌟 Gradient Mode
---------------

[](#-gradient-mode)

Enable gradient mode to apply subtle gradients to toast backgrounds:

```
return [
    'options' => [
        "gradient_enable" => true,
    ],
];
```

> **Note:** Gradient mode works best with the `default`, `material`, and `neon` themes.

---

🌙 Dark Mode
-----------

[](#-dark-mode)

Add `theme="dark"` to your `` tag to enable dark mode globally:

```

```

---

⚙️ Full Configuration Reference
-------------------------------

[](#️-full-configuration-reference)

```
// config/laravel-toaster-magic.php

return [
    'options' => [
        'closeButton'       => true,
        'positionClass'     => 'toast-top-end',
        'preventDuplicates' => false,
        'showDuration'      => 300,
        'timeOut'           => 5000,
        'theme'             => 'default', // default, material, ios, glassmorphism, neon, minimal, neumorphism
        'gradient_enable'   => false,
        'color_mode'        => false,
    ],
    'livewire_enabled'  => false,
    'livewire_version'  => 'v3',
];
```

---

🔒 Security
----------

[](#-security)

Custom button links (`customBtnLink`) are validated before being rendered into `href` attributes. Only URLs starting with `http://`, `https://`, `/`, or `#` are allowed. All other values are safely replaced with `#` to prevent XSS attacks.

---

🤝 Contributing
--------------

[](#-contributing)

Contributions are welcome! Please fork the repository, make your changes, and open a pull request. For bug reports or feature requests, [open an issue on GitHub](https://github.com/devrabiul/laravel-toaster-magic/issues).

---

📄 License
---------

[](#-license)

This package is open-source software licensed under the [MIT License](LICENSE).

---

🌱 Treeware
----------

[](#-treeware)

This package is [Treeware](https://treeware.earth). If you use it in production, we ask that you [**buy the world a tree**](https://plant.treeware.earth/devrabiul/laravel-toaster-magic) to thank us for our work. By contributing to the Treeware forest you'll be creating employment for local families and restoring wildlife habitats.

---

📬 Contact & Links
---------------------

[](#-contact--links)

- 🔗 **GitHub:** [devrabiul/laravel-toaster-magic](https://github.com/devrabiul/laravel-toaster-magic)
- 🔗 **Live Demo:** [laravel-toaster-magic.rixetbd.com](https://laravel-toaster-magic.rixetbd.com)
- 🔗 **Packagist:** [packagist.org/packages/devrabiul/laravel-toaster-magic](https://packagist.org/packages/devrabiul/laravel-toaster-magic)
- 📧 **Email:**

###  Health Score

56

—

FairBetter than 97% of packages

Maintenance93

Actively maintained with recent releases

Popularity50

Moderate usage in the ecosystem

Community18

Small or concentrated contributor base

Maturity51

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 64% 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 ~31 days

Recently: every ~40 days

Total

15

Last Release

15d ago

Major Versions

v1.6 → v2.02026-01-19

### Community

Maintainers

![](https://www.gravatar.com/avatar/9eaf28cb5d9d5d87660cbe335e7b82a08bc7801a40556c3a99740e22282d9e17?d=identicon)[devrabiul](/maintainers/devrabiul)

---

Top Contributors

[![devrabiul](https://avatars.githubusercontent.com/u/112581088?v=4)](https://github.com/devrabiul "devrabiul (64 commits)")[![rabiul6am](https://avatars.githubusercontent.com/u/128285760?v=4)](https://github.com/rabiul6am "rabiul6am (36 commits)")

---

Tags

laravel-toaster-magiclivewirelivewire-toastertoaster-magictoaster-magic-prophplaravelnotificationslivewiretoastrmagicflash-notificationstoasterdynamic-notificationslaravel-toastrlivewire-toaster

###  Code Quality

TestsPest

### Embed Badge

![Health badge](/badges/devrabiul-laravel-toaster-magic/health.svg)

```
[![Health](https://phpackages.com/badges/devrabiul-laravel-toaster-magic/health.svg)](https://phpackages.com/packages/devrabiul-laravel-toaster-magic)
```

###  Alternatives

[php-flasher/flasher-laravel

Seamlessly integrate flash notifications into your Laravel applications with PHPFlasher. Enhance user feedback and engagement with minimal setup.

453.0M45](/packages/php-flasher-flasher-laravel)[brian2694/laravel-toastr

toastr.js for Laravel

136721.9k7](/packages/brian2694-laravel-toastr)[php-flasher/flasher-toastr-laravel

Leverage Toastr for stylish toast notifications in Laravel with PHPFlasher. Add Toastr's sleek notifications to your Laravel projects effortlessly.

31626.1k5](/packages/php-flasher-flasher-toastr-laravel)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)