composer require nativephp/mobile-firebase

FIREBASE_CREDENTIALS=/path/to/service-account.json

use Native\Mobile\Facades\PushNotifications;
 
// 1. Check current permission status
$status = PushNotifications::checkPermission();
 
// 2. Enroll for push notifications (prompts user if needed)
PushNotifications::enroll();
 
// 3. Handle the token when it arrives

use Native\Mobile\Attributes\OnNative;
use Native\Mobile\Events\PushNotification\TokenGenerated;
 
#[OnNative(TokenGenerated::class)]
public function handleToken(string $token)
{
    // Send token to your server and store it for this user
    $this->user->update(['push_token' => $token]);
}

$status = PushNotifications::checkPermission();
// Returns: "granted", "denied", "not_determined", "provisional", or "ephemeral"

PushNotifications::enroll();

$token = PushNotifications::getToken();

use Native\Mobile\Attributes\OnNative;
use Native\Mobile\Events\PushNotification\TokenGenerated;
 
#[OnNative(TokenGenerated::class)]
public function handleToken(string $token)
{
    // Store token on your server for this user/device
    $this->user->update(['push_token' => $token]);
}

import { On, Off, Events } from '#nativephp';
import { onMounted, onUnmounted } from 'vue';
 
const handleToken = ({ token }) => {
    // Send to your backend
    fetch('/api/push-token', {
        method: 'POST',
        body: JSON.stringify({ token }),
    });
};
 
onMounted(() => On(Events.PushNotification.TokenGenerated, handleToken));
onUnmounted(() => Off(Events.PushNotification.TokenGenerated, handleToken));

import { On, Off, Events } from '#nativephp';
import { useEffect } from 'react';
 
useEffect(() => {
    const handler = On(Events.PushNotification.TokenGenerated, ({ token }) => {
        sendTokenToServer(token);
    });
    return () => Off(Events.PushNotification.TokenGenerated, handler);
}, []);

php artisan fcm:send {token} --data-only \
  --d event="Native\\Mobile\\Events\\PushNotification\\PushNotificationReceived" \
  --d payload='{"foo":"bar"}'

{
    "message": {
        "token": "device-token",
        "data": {
            "event": "Native\\Mobile\\Events\\PushNotification\\PushNotificationReceived",
            "payload": "{\"foo\":\"bar\"}"
        },
        "apns": {
            "payload": { "aps": { "content-available": 1 } }
        }
    }
}

use Illuminate\Support\Facades\Event;
use Native\Mobile\Events\PushNotification\PushNotificationReceived;
 
// In a service provider's boot()
Event::listen(function (PushNotificationReceived $event) {
    // Runs in the ephemeral PHP runtime — works even when app is backgrounded.
    // Persist data, queue work, update local SQLite, etc.
});

use Native\Mobile\Attributes\OnNative;
use Native\Mobile\Events\PushNotification\PushNotificationReceived;
 
#[OnNative(PushNotificationReceived::class)]
public function handlePush($data)
{
    // Only runs when this Livewire component is mounted in the foreground.
}

# Basic notification
php artisan fcm:send {token} --title="Hello" --body="World"
 
# With deep link
php artisan fcm:send {token} --title="New Order" --body="Order #123 ready" --url="/orders/123"
 
# Data-only (silent, triggers background processing)
php artisan fcm:send {token} --data-only --d event=App\\Events\\SyncNeeded --d payload='{"sync_id":42}'
 
# With badge count
php artisan fcm:send {token} --title="Messages" --body="3 unread" --badge=3
 
# Custom data pairs
php artisan fcm:send {token} --title="Update" --d type=order --d order_id=55

use Illuminate\Support\Facades\Http;
 
$response = Http::withToken($accessToken)
    ->post("https://fcm.googleapis.com/v1/projects/{$projectId}/messages:send", [
        'message' => [
            'token' => $deviceToken,
            'notification' => [
                'title' => 'Order Shipped',
                'body' => 'Your order is on the way!',
            ],
            'data' => [
                'url' => '/orders/123',
            ],
        ],
    ]);

{
    "message": {
        "token": "device-token",
        "notification": {
            "title": "New Message",
            "body": "You have a new message"
        },
        "data": {
            "url": "/messages/42"
        }
    }
}

{
    "message": {
        "token": "device-token",
        "data": {
            "event": "App\\Events\\DataSyncRequested",
            "payload": "{\"sync_id\": 42}"
        },
        "apns": {
            "payload": {
                "aps": {
                    "content-available": 1
                }
            }
        }
    }
}

import { PushNotifications, On, Events } from '#nativephp';
 
// Check permission
const { status } = await PushNotifications.checkPermission();
 
// Enroll (prompts if not_determined)
if (status === 'not_determined') {
    await PushNotifications.enroll();
}
 
// Get cached token
const { token } = await PushNotifications.getToken();
 
// Clear badge
await PushNotifications.clearBadge();
 
// Listen for token
On(Events.PushNotification.TokenGenerated, ({ token }) => {
    console.log('Token:', token);
});

public function requestPush()
{
    $status = PushNotifications::checkPermission();
 
    if ($status === 'denied') {
        Dialog::toast('Enable notifications in Settings');
        return;
    }
 
    PushNotifications::enroll();
}