README

Toast notification shell component for NativeBlade. Renders outside the WebView — no flicker during page transitions.

Installation

composer require nativeblade/toast

That's it. Run php artisan nativeblade:dev and the component is synced automatically.

Usage

Blade (Livewire directive)

<button wire:nb-bridge="toast" wire:nb-payload='{"message":"Saved!","type":"success"}'>
    Save
</button>

<button wire:nb-bridge="toast" wire:nb-payload='{"message":"Something went wrong","type":"error"}'>
    Delete
</button>

<button wire:nb-bridge="toast" wire:nb-payload='{"message":"Check your input","type":"warning","duration":5000}'>
    Validate
</button>

Inline (onclick)

<button onclick="__nbBridge('toast', { message: 'Saved!', type: 'success' })">
    Save
</button>

From PHP (NativeResponse)

use NativeBlade\Facades\NativeBlade;

// Show toast after a Livewire action
NativeBlade::response()->alert('Saved!')->toResponse();

Types

Options

How It Works

This is a shell component — it renders outside the WebView in the native Tauri shell.

wire:nb-bridge="toast" triggers a click handler that sends a message to the parent shell via postMessage. The bridge looks up the toast component in the registry and calls its render() function. The toast appears as a floating element in the parent window, outside the iframe.

License

MIT