PHPackages                             superbyte23/sileo-livewire - 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. superbyte23/sileo-livewire

ActiveLibrary

superbyte23/sileo-livewire
==========================

Sileo toast notifications for Livewire 4 — beautiful gooey toasts with a simple PHP API.

v1.0.0(2mo ago)10MITPHPPHP ^8.2

Since Mar 7Pushed 2mo agoCompare

[ Source](https://github.com/superbyte23/sileo-livewire)[ Packagist](https://packagist.org/packages/superbyte23/sileo-livewire)[ Docs](https://github.com/superbyte23/sileo-livewire)[ RSS](/packages/superbyte23-sileo-livewire/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (2)Versions (2)Used By (0)

sileo-livewire
==============

[](#sileo-livewire)

[![Latest Version on Packagist](https://camo.githubusercontent.com/074756c175027603dcadd731fe50a4b6d29f8b18c377d639f1968ebb640cd6de/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f73757065726279746532332f73696c656f2d6c697665776972652e737667)](https://packagist.org/packages/superbyte23/sileo-livewire)[![License](https://camo.githubusercontent.com/c5a00fbb91ed98d4861e402b0e6855bbeb839a8ac6a416ce729d279043501f3d/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f73757065726279746532332f73696c656f2d6c697665776972652e737667)](LICENSE.md)

**Sileo toast notifications for Livewire 4.** Beautiful gooey spring-physics toasts with a simple PHP trait API.

> Powered by [Sileo](https://sileo.aaryan.design) — a tiny, opinionated React toast component.

---

Requirements
------------

[](#requirements)

- PHP 8.2+
- Laravel 11 or 12
- Livewire 4
- Node / Vite
- React 18 or 19

---

Installation
------------

[](#installation)

### 1. Install the Composer package

[](#1-install-the-composer-package)

```
composer require superbyte23/sileo-livewire
```

### 2. Install the npm dependencies

[](#2-install-the-npm-dependencies)

```
npm install sileo react react-dom @vitejs/plugin-react
```

### 3. Enable React in Vite

[](#3-enable-react-in-vite)

```
// vite.config.js
import { defineConfig } from 'vite'
import laravel from 'laravel-vite-plugin'
import react from '@vitejs/plugin-react'

export default defineConfig({
    plugins: [
        laravel({
            input: ['resources/css/app.css', 'resources/js/app.js'],
            refresh: true,
        }),
        react(),
    ],
})
```

### 4. Publish the JS bridge

[](#4-publish-the-js-bridge)

```
php artisan vendor:publish --tag=sileo-livewire-js
```

This copies `sileo-bridge.js` into `resources/js/`.

### 5. Add the Toaster to your root layout

[](#5-add-the-toaster-to-your-root-layout)

```
{{-- resources/views/layouts/app.blade.php --}}

```

Available positions: `top-left` `top-center` `top-right` `bottom-left` `bottom-center` `bottom-right`

---

Usage
-----

[](#usage)

Add the `HasSileoToasts` trait to any Livewire component:

```
use Superbyte23\SileoLivewire\Concerns\HasSileoToasts;
use Livewire\Component;

new class extends Component
{
    use HasSileoToasts;

    public function save(): void
    {
        $this->toastSuccess('Saved!', 'Your changes were persisted.');
    }
}
```

### Available Methods

[](#available-methods)

```
// Basic
$this->toastSuccess('Title', 'Description');
$this->toastError('Title', 'Description');
$this->toastWarning('Title', 'Description');
$this->toastInfo('Title', 'Description');

// Action button
$this->toastAction(
    type:         'info',
    title:        'Item deleted',
    description:  'The record has been removed.',
    actionLabel:  'Undo',
    actionEvent:  'undo-delete',   // Livewire event dispatched on click
    actionParams: [42],            // optional params
);

// Promise (loading → success/error)
$this->toastPromise(
    event:   'run-save',
    loading: 'Saving…',
    success: 'All saved!',
    error:   'Save failed.',
);
$this->resolveToastPromise('run-save'); // call when done
$this->rejectToastPromise('run-save');  // call on failure

// Custom position per toast
$this->dispatch('sileo', type: 'success', title: 'Done!', position: 'bottom-center');
```

### Promise Example

[](#promise-example)

```
#[\Livewire\Attributes\On('run-save')]
public function runSave(): void
{
    try {
        // ... your save logic ...
        $this->resolveToastPromise('run-save');
    } catch (\Throwable) {
        $this->rejectToastPromise('run-save');
    }
}
```

---

Theme
-----

[](#theme)

Sileo intentionally **inverts** the theme — dark page shows light toasts, light page shows dark toasts. Theme is detected from the `.dark` class on ``, applied server-side (e.g. Flux, maryUI, Filament).

---

License
-------

[](#license)

MIT — [superbyte23](https://github.com/superbyte23)

###  Health Score

39

—

LowBetter than 85% of packages

Maintenance94

Actively maintained with recent releases

Popularity2

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

Unknown

Total

1

Last Release

62d ago

### Community

Maintainers

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

---

Top Contributors

[![superbyte23](https://avatars.githubusercontent.com/u/50263189?v=4)](https://github.com/superbyte23 "superbyte23 (1 commits)")

---

Tags

laravelnotificationslivewiretoastlivewire4sileo

### Embed Badge

![Health badge](/badges/superbyte23-sileo-livewire/health.svg)

```
[![Health](https://phpackages.com/badges/superbyte23-sileo-livewire/health.svg)](https://phpackages.com/packages/superbyte23-sileo-livewire)
```

###  Alternatives

[livewire/flux

The official UI component library for Livewire.

9385.0M85](/packages/livewire-flux)[masmerise/livewire-toaster

Beautiful toast notifications for Laravel / Livewire.

505550.3k6](/packages/masmerise-livewire-toaster)[ascsoftw/livewire-toast

Livewire Package to display Toast Notifications

48544.2k1](/packages/ascsoftw-livewire-toast)[mati365/ckeditor5-livewire

CKEditor 5 integration for Laravel Livewire

413.9k](/packages/mati365-ckeditor5-livewire)[tomshaw/electricgrid

A feature-rich Livewire package designed for projects that require dynamic, interactive data tables.

116.6k](/packages/tomshaw-electricgrid)[mwguerra/web-terminal

A web-based terminal component for Filament/Laravel with command whitelisting and multiple connection types

251.1k](/packages/mwguerra-web-terminal)

PHPackages © 2026

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