composer require nativephp/mobile-local-notifications

use NativePHP\LocalNotifications\Facades\LocalNotifications;
 
// Request permission first
LocalNotifications::requestPermission();
 
// Send a notification
LocalNotifications::send('hello')
    ->title('Hello!')
    ->body('World');
 
// Schedule a daily recurring notification
LocalNotifications::schedule('daily-practice')
    ->title('Practice Time')
    ->body('Time for your daily session!')
    ->dailyAt('09:00');

// Simple
LocalNotifications::send('hello')
    ->title('Hello!')->body('World');
 
// With URL navigation on tap
LocalNotifications::send('shipped')
    ->title('Order Shipped')->body('On the way!')
    ->url('/orders/123');
 
// Delayed (fires after N seconds)
LocalNotifications::send('reminder')
    ->title('Meeting Soon')->delay(300);
 
// With action buttons (max 3)
LocalNotifications::send('friend-request')
    ->title('Friend Request')->body('John wants to connect')
    ->action('Accept', '/friends/accept/42')
    ->action('Decline', destructive: true)
    ->action('View Profile', '/users/42');
 
// Silent (no sound or vibration)
LocalNotifications::send('sync')
    ->title('Synced')->body('Data synced')->silent();
 
// Badge (iOS auto-increments, Android managed by OS)
LocalNotifications::send('msg')
    ->title('New Message')->body('You have mail')->badge();
 
// Custom sound
LocalNotifications::send('alert')
    ->title('Alert')->body('Check this out')
    ->sound('mario');
 
// Custom data payload
LocalNotifications::send('order')
    ->title('Order Ready')
    ->data(['order_id' => 55, 'type' => 'pickup']);

resources/
  sounds/
    mario.mp3
    chime.wav
    alert.caf

LocalNotifications::send('alert')
    ->title('Alert')
    ->sound('mario');

// Daily at a specific time
LocalNotifications::schedule('morning')
    ->title('Good Morning')->body('Start your day!')
    ->dailyAt('09:00');
 
// Weekly on specific days
LocalNotifications::schedule('standup')
    ->title('Standup')->body('Starting soon')
    ->weeklyOn([1,2,3,4,5], '09:55');
 
// Monthly
LocalNotifications::schedule('rent')
    ->title('Rent Due')->body('Pay today')
    ->monthlyOn(1, '10:00');

$all = LocalNotifications::scheduled();           // List all
$entries = LocalNotifications::get('morning');     // Get by ID
LocalNotifications::edit('morning')->dailyAt('10:00');  // Edit
LocalNotifications::remove('morning');             // Remove
LocalNotifications::cancel('id');                  // Cancel specific
LocalNotifications::cancelAll();                   // Cancel all
LocalNotifications::clearBadge();                  // Clear badge (iOS)

use Illuminate\Support\Facades\Schedule;
 
Schedule::notification('standup')
    ->title('Standup')->dailyAt('09:55');
 
Schedule::notification('hydrate')
    ->title('Drink Water')->everyThirtyMinutes();

->action(string $label, ?string $url = null, bool $destructive = false, array $data = [])

use Native\Mobile\Attributes\OnNative;
use NativePHP\LocalNotifications\Events\NotificationTapped;
use NativePHP\LocalNotifications\Events\PermissionGranted;
 
#[OnNative(NotificationTapped::class)]
public function handleTap(string $id, ?string $actionIdentifier = null, array $data = [], ?string $url = null)
{
    // Handle notification tap
}
 
#[OnNative(PermissionGranted::class)]
public function handlePermission(bool $granted)
{
    // Handle permission result
}

import { LocalNotifications, Events } from '#local-notifications';
import { On, Off } from '#nativephp';
 
On(Events.NotificationTapped, ({ id, actionIdentifier, data, url }) => {
    console.log('Tapped:', id);
});
 
On(Events.PermissionGranted, ({ granted }) => {
    console.log('Permission:', granted);
});

import { LocalNotifications } from '#local-notifications';
 
// Send
await LocalNotifications.send('hello').title('Hi').body('World');
await LocalNotifications.send('delayed').title('Soon').delay(10);
await LocalNotifications.send('custom').title('Alert').sound('mario');
 
// Schedule
await LocalNotifications.schedule('daily').title('Practice').dailyAt('09:00');
await LocalNotifications.schedule('mwf').title('Gym').weeklyOn([1,3,5], '08:00');
 
// CRUD
const all = await LocalNotifications.scheduled();
await LocalNotifications.remove('daily');
await LocalNotifications.cancel('id');
await LocalNotifications.cancelAll();
await LocalNotifications.clearBadge();
await LocalNotifications.requestPermission();

class OrderShipped extends Notification {
    use HasMobileNotification;
    public function via($notifiable) { return [...$this->viaMobile()]; }
    public function toMobile($notifiable) {
        return MobileMessage::create()
            ->title('Shipped')->body('Your order shipped')
            ->url('/orders/'.$this->order->id)
            ->action('Track', '/orders/track/'.$this->order->id);
    }
}

use Native\Mobile\Testing\Native;
 
it('sends a welcome notification', function () {
    Native::test(Onboarding::class)
        ->tap('Finish')
        ->assertNotificationSent(fn ($n) => $n['id'] === 'welcome');
});
 
it('schedules the daily reminder when reminders are enabled', function () {
    Native::test(ReminderSettings::class)
        ->set('enabled', true)
        ->call('save')
        ->assertScheduled(fn ($n) => $n['id'] === 'daily-practice' && $n['frequency'] === 'daily');
});
 
it('cancels the reminder when disabled', function () {
    Native::test(ReminderSettings::class)
        ->set('enabled', false)
        ->call('save')
        ->assertCancelled('daily-practice');
});
 
it('lists pending notifications', function () {
    Native::fakeBridge()->withPendingNotifications([
        ['id' => 'daily-practice', 'title' => 'Practice time'],
    ]);
 
    // ... exercise a screen that reads LocalNotifications::scheduled()
});