README

Laravel SweetAlert2: popups, toasts and confirm dialogs for Laravel

Show SweetAlert2 popups and toast notifications from your Laravel controllers, Livewire components and Alpine, and put a confirm dialog in front of any delete button with one data attribute. SweetAlert2 11, no jQuery, no npm build step.

Docs and demo: amjad.com.pk/laravel/packages/laravel-sweetalert2

// In a controller
SweetAlert2::success('Invoice sent', 'We emailed it to the client.');

return redirect()->route('invoices.index');

{{-- Once, in your layout --}}
<x-sweetalert2 />

{{-- Anywhere: ask before deleting --}}
<button wire:click="delete({{ $invoice->id }})" data-swal-confirm="Delete this invoice?">Delete</button>

Why this package

SweetAlert2 is the most used popup library on npm (about half a million downloads a week). This package keeps the Laravel side small and safe:

Flash popups like flash messages. Queue one or several from a controller; they show, one after another, on the next page, even after more than one redirect.
Confirm dialogs without JavaScript. data-swal-confirm works on links, buttons, forms, Livewire wire:click and wire:submit.
Livewire and Alpine. $this->swal(...) in a Livewire component, or $dispatch('sweetalert2', {...}) in Alpine, shows a popup without a page load. Works with wire:navigate.
Safe by default. Titles are rendered as text and button labels are escaped, so user input in a popup can't inject HTML. SweetAlert2 loads from a pinned jsDelivr URL with a Subresource Integrity hash, and every script tag carries Laravel's CSP nonce when you use one.

Requirements

PHP 8.3+
Laravel 12 or 13
SweetAlert2 11 (11.26.25 is loaded by default; nothing to install)
Optional: Livewire (tested with 4) and Alpine.js

Installation

composer require amjadiqbal/laravel-sweetalert2

Add the component once to your layout, just before </body>:

<x-sweetalert2 />
{{-- or: @sweetalert2 --}}

That's it. Optionally publish the config:

php artisan vendor:publish --tag=sweetalert2-config

Usage

From a controller (flashed to the next page)

use AmjadIqbal\SweetAlert2\Facades\SweetAlert2;

SweetAlert2::success('Saved', 'Your profile is up to date.');
SweetAlert2::error('Payment failed', 'Your card was declined.');
SweetAlert2::warning('Almost full', 'You have used 90% of your storage.');
SweetAlert2::info('Heads up', 'Maintenance tonight at 22:00 UTC.');
SweetAlert2::question('Did you know?', 'You can drag files onto the page.');

SweetAlert2::toast('Copied to clipboard');            // small, top-right, closes itself
SweetAlert2::toast('Could not save', 'error');

// Or the helper
swal('Saved', 'Your profile is up to date.', 'success');

Every method returns a fluent builder; changes are saved automatically:

SweetAlert2::success('Order placed', 'We will email you a receipt.')
    ->timer(4000)                 // auto-close, with a progress bar
    ->position('top')
    ->confirmButton('Great!')
    ->footer('Order #1042')
    ->theme('dark');

SweetAlert2::fire(['title' => 'Custom', 'icon' => 'info', 'allowOutsideClick' => false]);

Any SweetAlert2 option works through option(), options([...]) or fire([...]). Popups queued in one request show in order on the next page that renders <x-sweetalert2 />, and only once.

Confirm before an action

Add data-swal-confirm to a link, a button or a form. The action only runs if the user confirms.

<form method="POST" action="{{ route('posts.destroy', $post) }}" data-swal-confirm="Delete this post?"
      data-swal-text="This cannot be undone." data-swal-confirm-button="Yes, delete it">
    @csrf @method('DELETE')
    <button>Delete</button>
</form>

<a href="{{ route('logout') }}" data-swal-confirm="Sign out?" data-swal-icon="question">Sign out</a>

{{-- Livewire --}}
<button wire:click="archive" data-swal-confirm="Archive this project?">Archive</button>

Attribute	Default (from `config('sweetalert2.confirm')`)
`data-swal-confirm`	The question (required)
`data-swal-text`	none
`data-swal-icon`	`warning`
`data-swal-confirm-button`	`Yes`
`data-swal-cancel-button`	`Cancel`

From Livewire, without a page load

use AmjadIqbal\SweetAlert2\Livewire\SweetAlerts;

class EditProfile extends Component
{
    use SweetAlerts;

    public function save(): void
    {
        // ...
        $this->swalToast('Profile saved');
        // or $this->swal('Saved', 'Your profile is up to date.', 'success');
        // or $this->swal(['title' => 'Saved', 'icon' => 'success', 'timer' => 2000]);
    }
}

Redirecting after the action instead? Use the facade; the popup shows on the page you redirect to, including with $this->redirect(..., navigate: true).

From Alpine or plain JavaScript

<button x-data @click="$dispatch('sweetalert2', { title: 'Hello', icon: 'info' })">Say hello</button>

window.LaravelSweetAlert2.toast({ title: 'Saved', icon: 'success' });
window.Swal.fire('Plain SweetAlert2 works too');

Options sent from the browser are passed to SweetAlert2 as they are, so don't put user input in html.

HTML content

title, button labels and footer are escaped. For trusted HTML use html() or raw(), which pass values through untouched; never put user input in them:

SweetAlert2::info('Release notes')->html('<ul><li>Faster search</li><li>Dark mode</li></ul>');

Configuration

config/sweetalert2.php:

'assets' => [
    'cdn' => true,   // false if you bundle SweetAlert2 yourself
    'js' => 'https://cdn.jsdelivr.net/npm/sweetalert2@11.26.25/dist/sweetalert2.all.min.js',
    'js_integrity' => 'sha384-…',
],
'defaults' => [],           // applied to every popup, e.g. ['theme' => 'auto']
'toast' => [...],           // toast position, timer, progress bar
'confirm' => [...],         // data-swal-confirm dialog defaults

Bundling with Vite instead of the CDN: set 'cdn' => false, run npm i sweetalert2, and in resources/js/app.js:

import Swal from 'sweetalert2';
window.Swal = Swal;

Content Security Policy: with Vite::useCspNonce() every script tag gets the nonce. The SweetAlert2 "all" build injects its CSS in a <style> tag, so a strict style-src needs 'unsafe-inline' or the Vite setup above with import 'sweetalert2/dist/sweetalert2.css' and the sweetalert2.min.js build.

Themes: light, dark and auto are built in (->theme('auto') or 'defaults' => ['theme' => 'auto']).

Upgrading from `amjadiqbal/sweetalert2`

That earlier package was never published. If you used a private copy: the Composer name is now amjadiqbal/laravel-sweetalert2, the helper is swal() instead of alert(), type is now icon (SweetAlert2 9+), and the layout include is <x-sweetalert2 /> instead of @include('sweetalert::alert'). See the changelog.

Testing

composer test
scripts/ci-local.sh   # every PHP 8.3–8.5 × Laravel 12/13 combination, Pint and PHPStan

Need this built into your app, or something custom?

I build Livewire features, admin panels and Laravel packages for teams. If you'd rather have your app's notifications and confirm flows designed and wired up for you, or need something this package doesn't do, get in touch.

Support

🐛 Bug or feature request: open an issue
🔒 Security issue: please report privately via GitHub's security tab

Need this customised, or something built?

I'm available for custom development, package integration, and technical consulting.

More packages

Part of a family of open-source packages. See all of them.


laravel-driver-js	Driver.js product tours and onboarding for Laravel
laravel-rough-notation	Hand-drawn highlights and annotations for Blade
laravel-tiptap	Tiptap editor for Laravel
kiln	Deploy-time OPcache control for Laravel

Credits

SweetAlert2 by Limon Monte and contributors (MIT), which does all the work in the browser. This package is an independent wrapper and is not affiliated with SweetAlert2.
Amjad Iqbal

License

MIT. See LICENSE.md.

amjadiqbal / laravel-sweetalert2

Package info

Security

Statistics

README

Laravel SweetAlert2: popups, toasts and confirm dialogs for Laravel

Why this package

Requirements

Installation

Usage

From a controller (flashed to the next page)

Confirm before an action

From Livewire, without a page load

From Alpine or plain JavaScript

HTML content

Configuration

Upgrading from `amjadiqbal/sweetalert2`

Testing

Need this built into your app, or something custom?

Support

Need this customised, or something built?

More packages

Credits

License

amjadiqbal / laravel-sweetalert2

Package info

Security

Statistics

README

Laravel SweetAlert2: popups, toasts and confirm dialogs for Laravel

Why this package

Requirements

Installation

Usage

From a controller (flashed to the next page)

Confirm before an action

From Livewire, without a page load

From Alpine or plain JavaScript

HTML content

Configuration

Upgrading from amjadiqbal/sweetalert2

Testing

Need this built into your app, or something custom?

Support

Need this customised, or something built?

More packages

Credits

License

Upgrading from `amjadiqbal/sweetalert2`