andriichuk/pushbox

Laravel developer tool: preview FCM push payloads from notifications in the browser—Mailbook-style registry (add, to, category, variants, locales), optional DB rollback, and gated test sends.

v1.0.0 2026-04-11 17:19 UTC

Requires

• php: ^8.4
• illuminate/contracts: ^11.0|^12.0
• illuminate/database: ^11.0|^12.0
• illuminate/http: ^11.0|^12.0
• illuminate/log: ^11.0|^12.0
• illuminate/notifications: ^11.0|^12.0
• illuminate/routing: ^11.0|^12.0
• illuminate/support: ^11.0|^12.0
• illuminate/view: ^11.0|^12.0

Requires (Dev)

• laravel-notification-channels/fcm: ^5.0
• laravel/pint: ^1.0
• orchestra/testbench: ^9.0|^10.0
• phpunit/phpunit: ^11.0

Suggests

• laravel-notification-channels/fcm: Preview notifications that implement toFcm() with FcmMessage (Firebase / FCM).

MIT

• Serhii Andriichuk

• testing
• notifications
• laravel
• preview
• pushbox
• FCM
• laravel-package
• developer-tools
• push-notifications
• firebase-cloud-messaging
• mailbook

README

Pushbox is a Laravel package inspired by Mailbook: it lets you preview FCM push payloads for Notification classes in the browser, without wiring a one-off controller in your app.

Requirements: PHP 8.4+, Laravel 11 or 12.

Installation

composer require --dev andriichuk/pushbox

Register the service provider and facade (Laravel 11+ auto-discovers them; otherwise add Andriichuk\Pushbox\PushboxServiceProvider to config/app.php).

Publish configuration (optional):

php artisan vendor:publish --tag="pushbox-config"

Scaffold the registration file:

php artisan pushbox:install

This creates routes/pushbox.php where you register notifications (same idea as Mailbook’s routes/mailbook.php).

Usage

Open /pushbox (or your configured pushbox.path) when the app runs with routes enabled (by default: local only — see Security).

Registering notifications

// routes/pushbox.php
use Andriichuk\Pushbox\Facades\Pushbox;
use App\Notifications\OrderShippedNotification;

Pushbox::add(OrderShippedNotification::class);

Pushbox::add(function (): OrderShippedNotification {
    $order = Order::factory()->create();

    return new OrderShippedNotification($order);
});

Notifiable (to())

Many notifications expect a notifiable user. Mirror Mailbook’s API:

Pushbox::to(User::factory()->make())->add(WelcomeNotification::class);

You can also scope several registrations:

Pushbox::to(User::factory()->make())->group(function () {
    Pushbox::add(WelcomeNotification::class);
    Pushbox::add(TrialEndedNotification::class);
});

Categories & groups

Pushbox::category('Orders')->group(function () {
    Pushbox::add(OrderCreatedNotification::class);
    Pushbox::add(OrderShippedNotification::class);
});

Variants

Pushbox::add(OrderCreatedNotification::class)
    ->variant('1 item', fn () => new OrderCreatedNotification(Order::factory()->withOneProduct()->create()))
    ->variant('2 items', fn () => new OrderCreatedNotification(Order::factory()->withTwoProducts()->create()));

Localization

Add locales to config/pushbox.php (locales array). The UI shows a dropdown; the preview resolver sets app()->setLocale() while resolving payloads.

Database rollback

When pushbox.database_rollback is true, previews run inside a DB transaction that is rolled back after rendering (handy when factories persist models), similar to Mailbook.

FCM (push)

Install the channel package (suggested):

composer require laravel-notification-channels/fcm

Implement toFcm($notifiable) on your notification as documented by that package. Pushbox serializes the returned FcmMessage via toArray() for the UI — no Firebase HTTP request happens during preview.

Test sending (optional)

Dangerous: sends a real notification through your configured FCM driver.

• PUSHBOX_ALLOW_SEND=true
• pushbox.send.fcm.token / PUSHBOX_FCM_TOKEN for test sends
• By default, sends are only reasonable in local; set PUSHBOX_SEND_NON_LOCAL=true (and pushbox.send_allow_non_local) only if you explicitly need staging.

Every send is logged under the pushbox.sent / pushbox.send_failed context.

Security

• Routes register when pushbox.enabled is true and either pushbox.local_only is false or the environment is local / testing.
• Optional IP allowlist: PUSHBOX_ALLOWED_IPS (comma-separated).
• Keep the package in require-dev if you only need previews locally.

Mailbook parity (overview)

Mailbook	Pushbox
routes/mailbook.php	routes/pushbox.php
Mailbook::add()	Pushbox::add()
Mailbook::to() / group() / category() / variant()	Same fluent ideas
Preview HTML mail	Preview FCM JSON
Optional send	Optional FCM send (gated)

Testing

composer test
# or
./vendor/bin/phpunit

License

The MIT License. See LICENSE.md.