PHPackages                             islamalsayed/laravel-toasts - 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. islamalsayed/laravel-toasts

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

islamalsayed/laravel-toasts
===========================

Modern, elegant toast notifications and confirmation dialogs for Laravel with full Livewire 3.x support, emoji integration, and RTL compatibility

v1.0.7(7mo ago)028MITPHPPHP ^8.0

Since Nov 2Pushed 7mo agoCompare

[ Source](https://github.com/IslamAlsayed/laravel-toasts)[ Packagist](https://packagist.org/packages/islamalsayed/laravel-toasts)[ Docs](https://github.com/IslamAlsayed/laravel-toasts)[ RSS](/packages/islamalsayed-laravel-toasts/feed)WikiDiscussions master Synced today

READMEChangelog (1)Dependencies (3)Versions (9)Used By (0)

🎉 Laravel Toast & Confirm Component
=======================================

[](#-laravel-toast--confirm-component)

[![License](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667)](LICENSE)[![Laravel](https://camo.githubusercontent.com/b7bd8c10f88035d2b0039e09cc47b4c71a6f3d85267e3efe9a9118631e0e8dae/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d31302e7825323025374325323031312e782d7265642e737667)](https://laravel.com)[![Livewire](https://camo.githubusercontent.com/907f276ed6d5682f5a53b3717c170bcf657f203572a36ba6421dc24afe3af06d/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c697665776972652d332e782d707572706c652e737667)](https://livewire.laravel.com)

**A modern, elegant, and powerful Laravel package for toast notifications and confirmation dialogs with full Livewire support.**

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

[](#-features)

- 🎨 **Multiple toast types**: Success ✅, Error ❌, Danger ⛔, Warning ⚠️, Info ℹ️
- 🏷️ **Two display modes**: Standard (with titles) and Message-only (without titles)
- 🎭 **Custom icons & emojis** with Font Awesome support
- 📌 **Pin support** for persistent notifications
- ⏱️ **Configurable duration** and display positionsش
- 🌍 **RTL/LTR support** with full Arabic compatibility
- 🎯 **Livewire 3.x integration** with event dispatching
- ⚡ **JavaScript API** for client-side notifications
- 🎬 **Smooth animations** with customizable timing
- 🔘 **Action buttons** with custom callbacks
- 🛡️ **Interactive confirmation dialogs**
- 🧪 **Fully tested** with PHPUnit
- 📦 **Easy installation** with granular asset publishing

---

🌍 RTL & Arabic Support
--------------------------

[](#-rtl--arabic-support)

All features work perfectly with Arabic text and RTL direction.

### RTL

[](#rtl)

[![RTL Example](./src/Resources/assets/images/toasts_ar.png)](./src/Resources/assets/images/toasts_ar.png)

### LTR

[](#ltr)

[![LTR Example](./src/Resources/assets/images/toasts.png)](./src/Resources/assets/images/toasts.png)

---

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

[](#-installation)

### 1. Install via Composer

[](#1-install-via-composer)

```
composer require islamalsayed/laravel-toasts
```

### 2. Publish Assets

[](#2-publish-assets)

```
# Publish everything (recommended for first-time setup)
php artisan vendor:publish --tag=toast-all

# Or publish components individually:
php artisan vendor:publish --tag=toast-config    # Configuration file
php artisan vendor:publish --tag=toast-views     # Blade templates
php artisan vendor:publish --tag=toast-css       # CSS styles
php artisan vendor:publish --tag=toast-js        # JavaScript files
php artisan vendor:publish --tag=toast-webfonts  # Font Awesome fonts
```

### 3. Inject Toast View

[](#3-inject-toast-view)

Run the inject command to add the toast component to your master layout:

```
php artisan toasts:inject
```

This will automatically inject the following into your layout files:

- Blade snippet: `@include('vendor.toasts.toasts')` in your `` tag
- CSS assets: FontAwesome and Toasts styles in `` or head.blade.php
- JavaScript: Toasts scripts in `` or foot.blade.php

---

⚙️ Configuration
----------------

[](#️-configuration)

### Environment Variables

[](#environment-variables)

Add these settings to your `.env` file:

```
# Animation timing
TOASTS_MOVE=enable                   # Enable/disable toast movement
TOASTS_ENTER_TIME=0.3s               # Entry animation duration
TOASTS_EXIT_TIME=0.3s                # Exit animation duration
TOASTS_VISIBLE_TIME=4s               # How long toast stays visible
TOASTS_START_DELAY_TIME=0.5s         # Delay before showing toast

# Confirmation defaults
TOASTS_CONFIRM_PIN=true              # Keep confirms pinned by default

# Display settings
TOASTS_DEFAULT_DIR=ltr               # Text direction: ltr or rtl
TOASTS_DEFAULT_POSITION=top          # Toast position: top, right
TOASTS_DEFAULT_THEME=info            # Default theme: success, error, warning, info

# Default messages
TOASTS_DEFAULT_MESSAGE=Hello there!
TOASTS_DEFAULT_TITLE=Notification

# Confirmation texts
TOASTS_CONFIRM_TITLE=Please Confirm
TOASTS_CONFIRM_MESSAGE=Do you really want to proceed?
TOASTS_CONFIRM_TEXT=Sure
TOASTS_CANCEL_TEXT=Cancel
```

### Configuration File

[](#configuration-file)

After publishing, customize `config/toasts.php` for more advanced settings.

---

�️ Artisan Commands
-------------------

[](#️-artisan-commands)

### `toasts:inject`

[](#toastsinject)

Automatically injects toast component references into your layout files.

```
php artisan toasts:inject
```

**What it does:**

- Adds `@include('vendor.toasts.toasts')` after `` tag in `master.blade.php`
- Adds CSS links (FontAwesome + Toasts) in `` section
- Adds JavaScript module in footer or `` section
- Creates proper comments for easy identification

**Output:**

```
Blade snippet injected into master.blade.php
CSS snippet injected into head.blade.php
JS snippet injected into foot.blade.php

```

**Command Features:**

- ✅ Smart pattern matching (handles various formatting styles)
- ✅ Safe operation (only removes toasts-related code)
- ✅ Informative feedback (clear success/skip messages)
- ✅ Clean output (removes extra blank lines)
- ✅ Non-destructive (can be reversed with `toasts:inject`)

---

�🚀 Basic Usage
--------------

[](#-basic-usage)

### Simple Toasts

[](#simple-toasts)

```
// Using helper functions
showToastSuccess('User created successfully!');
showToastError('Failed to delete item');
showToastWarning('Please check your input');
showToastInfo('New update available');

// Generic helper
showToast('success', 'Operation completed!');
```

### Message-Only Toasts (Without Titles)

[](#message-only-toasts-without-titles)

For cleaner, minimal toasts without type titles, use the message variants:

```
// Success message without "Success" title
showToastSuccessMessage('User created successfully!');

// Error message without "Error" title
showToastErrorMessage('Failed to delete item');

// Danger message without "Danger" title
showToastDangerMessage('Critical error occurred!');

// Warning message without "Warning" title
showToastWarningMessage('Please check your input');

// Info message without "Info" title
showToastInfoMessage('New update available');
```

**Difference between standard and message variants:**

```
// Standard toast (with title)
showToastSuccess('User created!');
// Displays: [✅ Success] User created!

// Message-only toast (no title)
showToastSuccessMessage('User created!');
// Displays: [✅] User created!
```

### With Session Flash

[](#with-session-flash)

```
// Automatic toast from session flash
return redirect()->back()->with('success', 'Data saved!');
return redirect()->route('dashboard')->withError('Access denied');

// All these work automatically:
session()->flash('success', 'Item created!');
session()->flash('error', 'Validation failed!');
session()->flash('warning', 'Action required!');
session()->flash('info', 'Did you know?');
```

### Using Toast Facade

[](#using-toast-facade)

```
use IslamAlsayed\LaravelToasts\Facades\Toast;

Toast::success('Record saved!');
Toast::error('Something went wrong')->icon('bomb');
Toast::warning('Check your email')->emoji('📧');
Toast::info('System maintenance at 10PM')->pin();
```

---

✨ Advanced Usage
----------------

[](#-advanced-usage)

### Chaining Methods

[](#chaining-methods)

```
showToast('success', 'User profile updated!')
    ->title('Success')           // Custom title
    ->emoji('🎉')               // Add emoji (replaces icon)
    ->icon('user-check')        // Font Awesome icon
    ->pin()                     // Make sticky (won't auto-hide)
    ->duration('5s')            // Custom duration (2s, 500ms, 1m)
    ->position('top')           // Position: top, right
    ->dir('rtl')                // Direction: rtl or ltr
    ->theme('success');         // Theme: success, error, warning, info
```

### With Action Buttons

[](#with-action-buttons)

```
showToast('info', 'New message received')
    ->title('Notification')
    ->emoji('📬')
    ->withAction('View', route('messages.show', 1))
    ->withAction('Mark as Read', '/messages/1/read');

Toast::warning('Unsaved changes detected')
    ->withAction('Save Now', '/save')
    ->withAction('Discard', '/discard')
    ->pin();
```

### Confirmation Dialogs

[](#confirmation-dialogs)

```
// Simple confirmation
addConfirm('Are you sure you want to delete this?');

// Advanced confirmation
addConfirm('Permanently delete this user?')
    ->title('Confirm Deletion')
    ->emoji('⚠️')
    ->link(route('users.destroy', $user->id))
    ->onConfirm('Yes, Delete')
    ->onCancel('Cancel')
    ->target('_self');

// Type-specific confirmations
addConfirmSuccess('Save changes?');
addConfirmError('Delete permanently?');
addConfirmWarning('Overwrite existing file?');
addConfirmInfo('Mark all as read?');
```

---

🎯 Livewire Integration
----------------------

[](#-livewire-integration)

### Event Dispatching

[](#event-dispatching)

Livewire components can dispatch toast events from the frontend:

```
// In your Livewire component

    Click Me

// With full options

    Show Toast

```

### Using HandlesCrudSafely Trait

[](#using-handlescrudsafely-trait)

The package provides a trait for safe CRUD operations with automatic toast notifications:

```
namespace App\Livewire;

use Livewire\Component;

class Users extends Component
{

    public function destroy($id)
    {
        // Default toast notification
        $user = User::find($id);
        if ($user) {
            $user->delete();
            $this->dispatch('show-toast', [
                'type' => 'success',
                'message' => 'Users deleted successfully.',
                'title' => 'Success',
                'emoji' => '✅'
            ]);
        } else {
            $this->dispatch('show-toast', [
                'type' => 'error',
                'message' => 'Users not found.',
                'title' => 'Error',
                'emoji' => '❌'
            ]);
        }
    }
}
```

### Complete Livewire Example

[](#complete-livewire-example)

```
namespace App\Livewire;

use Livewire\Component;
use App\Models\User;

class UserManager extends Component
{
    public $name;
    public $email;

    public function save()
    {
        $this->validate([
            'name' => 'required|string|max:255',
            'email' => 'required|email|unique:users',
        ]);

        try {
            User::create([
                'name' => $this->name,
                'email' => $this->email,
            ]);

            // Success toast
            showToast('success', 'User created successfully!')
                ->emoji('👤')
                ->title('Success')
                ->withAction('View Users', route('users.index'));

            $this->reset(['name', 'email']);

        } catch (\Exception $e) {
            // Error toast
            showToast('error', 'Failed to create user: ' . $e->getMessage())
                ->emoji('❌')
                ->title('Error')
                ->pin();
        }
    }

    public function render()
    {
        return view('livewire.user-manager');
    }
}
```

### Livewire Blade Template

[](#livewire-blade-template)

```

        @error('name') {{ $message }} @enderror

        @error('email') {{ $message }} @enderror

        Save User

    {{-- Dispatch toast from frontend --}}

        Show Info

```

---

🖥️ JavaScript Usage
-------------------

[](#️-javascript-usage)

### Browser Console

[](#browser-console)

Test toasts directly in the browser console:

```
// Simple toast
window.showToast({ type: "success", message: "It works!" });

// Advanced toast
window.showToast({
    type: "error",
    message: "Something went wrong",
    title: "Error",
    emoji: "💥",
    pin: true,
    duration: "5s",
});

// Confirmation dialog
window.showToastConfirm({
    type: "warning",
    message: "Are you sure?",
    onconfirmLink: "/delete/123",
    title: "Confirm",
    emoji: "⚠️",
    onConfirm: "Yes",
    onCancel: "No",
});
```

### Custom JavaScript Events

[](#custom-javascript-events)

```
// Dispatch from vanilla JavaScript
document.getElementById('myButton').addEventListener('click', function() {
    window.showToast({
        type: 'success',
        message: 'Button clicked!'
        emoji: '🖱️',
        duration: '2s'
    });
});

// With Livewire Alpine.js

    Click Me

```

### From External JavaScript Files

[](#from-external-javascript-files)

```
// In your app.js or custom script
export function showSuccessToast(message) {
    window.showToast({
        type: "success",
        message: message,
        title: "Success",
        emoji: "✅",
        duration: "3s",
    });
}

export function confirmDelete(url) {
    window.showToastConfirm({
        type: "info",
        message: "Are you sure you want to delete this?",
        onconfirmLink: url,
        title: "Confirm Deletion",
        emoji: "🗑️",
        onConfirm: "Delete",
        onCancel: "Cancel",
    });
}
```

---

Available Emojis:
-----------------

[](#available-emojis)

```
// Success
->emoji('✅') ->emoji('🎉') ->emoji('👍') ->emoji('✔️')

// Error
->emoji('❌') ->emoji('⛔') ->emoji('🚫') ->emoji('💥')

// Warning
->emoji('⚠️') ->emoji('⚡') ->emoji('🔔') ->emoji('📢')

// Info
->emoji('ℹ️') ->emoji('💡') ->emoji('📌') ->emoji('🔍')

// Delete
->emoji('🗑️') ->emoji('🚮') ->emoji('❌')

// Actions
->emoji('👁️') ->emoji('✏️') ->emoji('📝') ->emoji('💾')```
```

---

Real-World Examples:
--------------------

[](#real-world-examples)

#### Example 1: After creating a record

[](#example-1-after-creating-a-record)

```
public function store(Request $request)
{
    $user = User::create($request->all());

    showToast('success', 'User created successfully!')
        ->title('Success')
        ->emoji('👤')
        ->withAction('View Profile', route('users.show', $user->id));

    return redirect()->route('users.index');
}
```

#### Example 2: Before deleting (your current use case)

[](#example-2-before-deleting-your-current-use-case)

```
public function destroy($id)
{
    // Default toast notification
    $user = User::find($id);
    if ($user) {
        $user->delete();
        $this->dispatch('show-toast', [
            'type' => 'success',
            'message' => 'Users deleted successfully.',
            'title' => 'Success',
            'emoji' => '✅'
        ]);
    } else {
        $this->dispatch('show-toast', [
            'type' => 'error',
            'message' => 'Users not found.',
            'title' => 'Error',
            'emoji' => '❌'
        ]);
    }
}
```

#### Example 3: Livewire component

[](#example-3-livewire-component)

```
public function save()
{
    $this->validate();

    User::create($this->form);

    showToast('success', 'User added!')
        ->emoji('🎯')
        ->title('Added')
        ->pin();
}
```

#### Example 4: Multiple toasts at once

[](#example-4-multiple-toasts-at-once)

```
public function import()
{
    $success = 10;
    $failed = 2;

    if ($success > 0) {
        showToast('success', "$success items imported successfully")
            ->emoji('✅')
            ->duration(3000);
    }

    if ($failed > 0) {
        showToast('warning', "$failed items failed to import")
            ->emoji('⚠️')
            ->withAction('View Log', '/import/log');
    }
}
```

#### Example 5: Using message-only helpers for cleaner notifications

[](#example-5-using-message-only-helpers-for-cleaner-notifications)

```
public function updateProfile(Request $request)
{
    $user = auth()->user();
    $user->update($request->all());

    // Clean message without "Success" title
    showToastSuccessMessage('Profile updated successfully!');

    return redirect()->back();
}

public function validateForm($data)
{
    if (empty($data['email'])) {
        // Clean error without "Error" title
        showToastErrorMessage('Email is required');
        return false;
    }

    if (!filter_var($data['email'], FILTER_VALIDATE_EMAIL)) {
        // Clean warning without "Warning" title
        showToastWarningMessage('Please enter a valid email address');
        return false;
    }

    // Clean info without "Info" title
    showToastInfoMessage('Validation passed');
    return true;
}

public function sendNotification()
{
    try {
        // Send notification logic

        // Success with title for important actions
        showToastSuccess('Notification sent to all users!')
            ->emoji('📧')
            ->pin();
    } catch (\Exception $e) {
        // Danger message for critical errors
        showToastDangerMessage('Failed to send notification: ' . $e->getMessage());
    }
}
```

---

🧪 Testing
---------

[](#-testing)

### Running Tests

[](#running-tests)

```
# Run all tests
composer test

# Run specific test file
vendor/bin/phpunit tests/Feature/ToastFeatureTest.php

# Run with coverage
composer test-coverage
```

### Unit Tests Example

[](#unit-tests-example)

```
namespace IslamAlsayed\LaravelToasts\Tests\Unit;

use IslamAlsayed\LaravelToasts\ToastFactory;
use IslamAlsayed\LaravelToasts\Tests\TestCase;

class ToastFactoryTest extends TestCase
{
    public function test_can_create_success_toast()
    {
        $toast = ToastFactory::success('User created!');

        $this->assertEquals('success', $toast->type);
        $this->assertEquals('User created!', $toast->message);
    }

    public function test_can_chain_methods()
    {
        $toast = ToastFactory::error('Failed!')
            ->title('Error')
            ->emoji('❌')
            ->pin()
            ->duration('5s');

        $this->assertEquals('Error', $toast->title);
        $this->assertEquals('❌', $toast->emoji);
        $this->assertTrue($toast->pin);
        $this->assertEquals('5s', $toast->duration);
    }

    public function test_can_add_actions()
    {
        $toast = ToastFactory::info('New message')
            ->withAction('View', '/messages')
            ->withAction('Dismiss', '#');

        $this->assertCount(2, $toast->actions);
        $this->assertEquals('View', $toast->actions[0]['label']);
        $this->assertEquals('/messages', $toast->actions[0]['url']);
    }
}
```

### Feature Tests Example

[](#feature-tests-example)

```
namespace IslamAlsayed\LaravelToasts\Tests\Feature;

use IslamAlsayed\LaravelToasts\Tests\TestCase;
use Illuminate\Foundation\Testing\RefreshDatabase;

class ToastFeatureTest extends TestCase
{
    use RefreshDatabase;

    public function test_toast_is_added_to_session()
    {
        showToastSuccess('Test message');

        $toasts = session('toasts');

        $this->assertNotNull($toasts);
        $this->assertCount(1, $toasts);
        $this->assertEquals('success', $toasts[0]->type);
        $this->assertEquals('Test message', $toasts[0]->message);
    }

    public function test_multiple_toasts_can_be_queued()
    {
        showToastSuccess('First');
        showToastError('Second');
        showToastWarning('Third');

        $toasts = session('toasts');

        $this->assertCount(3, $toasts);
    }

    public function test_redirect_with_flash_creates_toast()
    {
        $response = $this->get('/test-redirect');

        $response->assertSessionHas('success', 'Operation completed!');
    }
}
```

### Testing Livewire Integration

[](#testing-livewire-integration)

```
namespace Tests\Feature\Livewire;

use App\Livewire\UserManager;
use Livewire\Livewire;
use Tests\TestCase;

class UserManagerTest extends TestCase
{
    public function test_success_toast_on_user_creation()
    {
        Livewire::test(UserManager::class)
            ->set('name', 'John Doe')
            ->set('email', 'john@example.com')
            ->call('save')
            ->assertDispatched('toast');

        $toasts = session('toasts');
        $this->assertNotNull($toasts);
        $this->assertEquals('success', $toasts[0]->type);
    }

    public function test_error_toast_on_validation_failure()
    {
        Livewire::test(UserManager::class)
            ->set('name', '')
            ->set('email', 'invalid-email')
            ->call('save')
            ->assertHasErrors(['name', 'email']);
    }
}
```

---

🌍 RTL & Arabic Support
--------------------------

[](#-rtl--arabic-support-1)

All features work perfectly with Arabic text and RTL direction.

[![RTL Example - Confirm](./src/Resources/assets/images/confirms_ar.png)](./src/Resources/assets/images/confirms_ar.png)[![RTL Example - Success](./src/Resources/assets/images/success_ar.png)](./src/Resources/assets/images/success_ar.png)[![RTL Example - Error](./src/Resources/assets/images/error_ar.png)](./src/Resources/assets/images/error_ar.png)[![RTL Example - Warning](./src/Resources/assets/images/warning_ar.png)](./src/Resources/assets/images/warning_ar.png)[![RTL Example - Info](./src/Resources/assets/images/info_ar.png)](./src/Resources/assets/images/info_ar.png)

---

🧩 API Reference
---------------

[](#-api-reference)

### Toast Properties

[](#toast-properties)

```
public $type;        // success, error, info, warning
public $message;     // Toast message text
public $title;       // Optional toast title
public $emoji;       // Emoji next to title
public $icon;        // Font Awesome icon name
public $duration;    // Display duration (e.g., 2s, 500ms, 1m)
public $position;    // Position: top, right
public $pin;         // If true, toast remains until manually closed
public $theme;       // Theme color: success, error, etc.
public $dir;         // Text direction: ltr or rtl
public $confirm;     // Confirm button label
public $cancel;      // Cancel button label
public $actions;     // Array of actions [label + url]
```

### Helper Functions

[](#helper-functions)

#### Standard Toast Helpers (With Titles)

[](#standard-toast-helpers-with-titles)

FunctionDescription`showToast($type, $message)`Create a generic toast`showToastSuccess($message)`Create success toast with title`showToastError($message)`Create error toast with title`showToastDanger($message)`Create danger toast with title`showToastWarning($message)`Create warning toast with title`showToastInfo($message)`Create info toast with title#### Message-Only Helpers (Without Titles)

[](#message-only-helpers-without-titles)

FunctionDescription`showToastSuccessMessage($message)`Success toast without "Success" title`showToastErrorMessage($message)`Error toast without "Error" title`showToastDangerMessage($message)`Danger toast without "Danger" title`showToastWarningMessage($message)`Warning toast without "Warning" title`showToastInfoMessage($message)`Info toast without "Info" title#### Confirmation Helpers

[](#confirmation-helpers)

FunctionDescription`addConfirm($message)`Create confirmation dialog`addConfirmSuccess($message)`Create success confirmation`addConfirmError($message)`Create error confirmation`addConfirmWarning($message)`Create warning confirmation`addConfirmInfo($message)`Create info confirmation**Usage Example:**

```
// With title (default)
showToastSuccess('User created successfully!');
// Output: [✅ Success] User created successfully!

// Without title (message only)
showToastSuccessMessage('User created successfully!');
// Output: [✅] User created successfully!

// Confirmation dialog
addConfirmError('Delete this user?')
    ->link(route('users.destroy', $user->id))
    ->onConfirm('Yes, Delete')
    ->onCancel('Cancel');
```

### Facade Methods

[](#facade-methods)

```
use IslamAlsayed\LaravelToasts\Facades\Toast;

Toast::success($message);
Toast::error($message);
Toast::warning($message);
Toast::info($message);
Toast::confirm($message);
```

### Artisan Commands

[](#artisan-commands)

CommandDescription`toasts:inject`Inject toast references into layout files**Usage Examples:**

```
# Initial setup - inject toasts into layouts
php artisan toasts:inject
```

---

� Future Enhancements
---------------------

[](#-future-enhancements)

- Toast queueing system (stacked notifications)
- Audio alerts on confirmations
- Persistent toasts across page reloads
- Built-in animation presets (slide, fade, bounce, zoom)
- Dark mode support
- Custom toast templates
- WebSocket integration for real-time notifications

---

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

[](#-contributing)

We welcome contributions! Here's how you can help:

1. **Fork the repository**
2. **Create a feature branch**: `git checkout -b feature/amazing-feature`
3. **Commit your changes**: `git commit -m 'Add amazing feature'`
4. **Push to the branch**: `git push origin feature/amazing-feature`
5. **Open a Pull Request**

### Development Setup

[](#development-setup)

```
# Clone the repository
git clone https://github.com/IslamAlsayed/laravel-toasts.git
cd laravel-toasts

# Install dependencies
composer install

# Run tests
composer test
```

### Code Style

[](#code-style)

This project follows PSR-12 coding standards. Please ensure your code adheres to these standards before submitting.

```
# Check code style
composer phpcs

# Fix code style
composer phpcbf
```

---

📄 License
---------

[](#-license)

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

---

📬 Support & Contact
-----------------------

[](#-support--contact)

- 📧 **Email**:
- 💼 **LinkedIn**: [IslamAlsayed](https://www.linkedin.com/in/islam-alsayed7)
- � **Facebook**: [IslamAlsayed](https://www.facebook.com/islamalsayed00)
- 🐛 **Issues**: [GitHub Issues](https://github.com/IslamAlsayed/laravel-toasts/issues)

---

🙏 Acknowledgments
-----------------

[](#-acknowledgments)

- Built with ❤️ for the Laravel community
- Inspired by modern notification libraries
- Font Awesome for the amazing icons

---

📝 Changelog
-----------

[](#-changelog)

See [CHANGELOG.md](CHANGELOG.md) for recent changes.

---

> 🚀 **Built for developers who want elegant, expressive, and flexible notifications in Laravel applications.**

###  Health Score

32

—

LowBetter than 69% of packages

Maintenance62

Regular maintenance activity

Popularity7

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity46

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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 ~0 days

Total

8

Last Release

238d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/fdcf0f31c4ae7e93dcc3e5671c47b35a603063fad2a564645f11ac602691462c?d=identicon)[IslamAlsayed](/maintainers/IslamAlsayed)

---

Top Contributors

[![IslamAlsayed](https://avatars.githubusercontent.com/u/97970601?v=4)](https://github.com/IslamAlsayed "IslamAlsayed (19 commits)")

---

Tags

laravelnotificationlivewireflash messageemojialertconfirmarabictoastdialogrtlnotification-system

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/islamalsayed-laravel-toasts/health.svg)

```
[![Health](https://phpackages.com/badges/islamalsayed-laravel-toasts/health.svg)](https://phpackages.com/packages/islamalsayed-laravel-toasts)
```

PHPackages © 2026

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