notifyme/laravel

Official Laravel client for the NotifyMe event → push API

v1.0.0 2026-07-19 11:33 UTC

Requires

• php: ^8.2
• illuminate/http: ^11.0|^12.0|^13.0
• illuminate/support: ^11.0|^12.0|^13.0

Requires (Dev)

• orchestra/testbench: ^9.0|^10.0|^11.0
• phpunit/phpunit: ^11.0|^12.0

MIT

• notifications
• events
• laravel
• push
• notifyme

Published on Packagist.org on 2026-07-19 11:35 UTC

README

Official Laravel client for NotifyMe — send events from your app and deliver them as iOS push notifications.

Packagist: notifyme/laravel
GitHub: vaporinua-vg/notifyme-laravel

Requirements

• PHP 8.2+
• Laravel 11 / 12 / 13

Install

composer require notifyme/laravel
php artisan vendor:publish --tag=notifyme-config

Configure

NOTIFYME_BASE_URL=https://test.upfine.app
NOTIFYME_API_KEY=nm_xxxxxxxx
NOTIFYME_API_SECRET=nms_xxxxxxxx

Get both values in the NotifyMe dashboard → Project. The secret is shown only once.

Usage

use NotifyMe\Laravel\Facades\NotifyMe;

NotifyMe::event('order.created')
    ->title('New order')
    ->message('Order #1234 received')
    ->priority('high')
    ->data([
        'order_id' => ['label' => 'Order number', 'value' => 1234],
        'amount' => ['label' => 'Total', 'value' => '59€'],
    ])
    ->send();

Or with a plain array:

NotifyMe::send([
    'event' => 'order.created',
    'title' => 'New order',
    'message' => 'Order #1234 received',
    'priority' => 'high',
    'data' => [
        'order_id' => 1234,
    ],
]);

Response:

['success' => true, 'event_id' => '...']

On HTTP errors the client throws NotifyMe\Laravel\Exceptions\NotifyMeException.

Security

• Never put NOTIFYME_API_SECRET in the frontend or git.
• Use server-side code only (jobs, listeners, controllers).
• Rotate credentials in the dashboard if leaked.

Auth headers (what the package sends)

Authorization: Bearer <api_key>
X-NotifyMe-Secret: <api_secret>
Content-Type: application/json

License

MIT