Push Direct — $49, one-time
Push notifications without Firebase on iOS.
Apple already runs a push service. This plugin talks to it directly with a .p8 key — no Firebase SDK, no GoogleService-Info.plist, no Google dependency on the Apple side. Android uses FCM, because on Android there is nothing else.
The push plugins listed on the NativePHP marketplace today, free and paid, link Firebase's iOS SDK to do this.
Why this one
There are other push plugins for NativePHP Mobile, and some are free. The ones listed on the marketplace today — free and paid — link Firebase's iOS SDK. This one does not.
| No Firebase project for iOS | Apple already runs a push service. The others make you stand up and maintain a Firebase project to reach it. Here you generate a .p8 key in the account you already have, and that is the whole setup. |
|---|---|
| No Google SDK in an Apple app | FirebaseMessaging arrives with its own initialisation, its own disk footprint and its own entries in your privacy manifest — for a platform that needs none of it. |
| One less vendor | Your iOS dependency graph stays between you and Apple. Nothing to audit, nothing to explain in review, nothing to migrate when someone else's SDK changes. |
| The whole surface | Taps including cold start, unenrolment at logout, the badge, and the payload of a message while the app is open. Free options stop at the device token and a single delivery event. |
If Firebase on iOS is fine by you, take a free plugin — it will work. This one exists for teams for whom it is not fine.
Between your app and Apple: nothing
- No third party in the iOS appNo Firebase SDK and no relay service. Your server talks to Apple, and Apple talks to the phone.
- Your keys stay yoursThe
.p8key and the FCM credentials live on your server, not with us. - Source includedPHP, Swift and Kotlin you can read, patch and debug against your own build.
- No call homeThe licence key only unlocks Composer. Nothing in the app checks it or talks to us.
What it adds
- The payload, not just the token. The core tells your app that a push arrived. This tells it what the push said — title, body and your own data — while the app is open.
- Notification taps, including cold start. The user taps, your app opens on the right screen. Android carries the payload on the launch intent, iOS through the notification delegate. On Android, send data-only messages: a message with a
notificationblock is drawn by Android itself, and the tap reaches your app only if it cold-starts it. - Unenrolment. The call you need at logout. Without it a signed-out device keeps receiving the previous user's notifications until the token rotates, which may never happen.
- Badge control. Set and clear the number on the app icon.
- Deep links. Configure which payload keys carry a URL; the tap event hands it back to you already resolved.
- Pictures and action buttons. An https
imagein the payload shows on the notification, on iOS through a notification extension the plugin adds to your build. Declare categories of buttons — "Track order", "Cancel" — and the tap event says which one was pressed. - Silent pushes. Data with nothing on screen still reaches your PHP, flagged as silent, so the app can refresh before the user looks.
- Permission changes. When the user turns notifications off or back on in Settings, your app hears about it the next time it comes to the front. After a refusal,
enroll()opens Settings instead of doing nothing, so your "Enable" button never goes dead, which App Review rejects. - Sounds, groups and urgency. Your own sounds from
resources/sounds. Notifications that stack by conversation or order. Time-sensitive alerts that break through Focus on iOS, opt-in. - Topics on Android. Subscribe a device to an FCM topic and reach everyone in it with one send.
- Delivered once, provably. Every event carries a delivery id, so an app that must act exactly once — create a record, charge a card — can drop a repeat.
- Same contract on both platforms. One set of events, one set of permission states.
How it works
composer require guppylab/push-direct. The key from your purchase email unlocks the private repository.
PushNotifications::enroll() asks for permission and hands you the token: raw APNs on iPhone, FCM on Android, plus the APNs environment to store next to it.
Your Laravel backend posts to APNs with your .p8 key, or to FCM. NotificationTapped brings the link back, even when the tap started the app.
Where it fits
- Orders and deliveries"Out for delivery", with a picture and a Track order button that opens the order.
- Email and messagingNew mail arrives with sound, grouped per account, and a tap opens that message. KeepMail runs on it.
- Appointments and remindersTime-sensitive alerts on iOS break through Focus when they should.
- Background syncSilent pushes wake the app so PHP can refresh data without showing anything.
How it looks
use Guppylab\Push\Events\NotificationTapped;
use Native\Mobile\Attributes\OnNative;
#[OnNative(NotificationTapped::class)]
public function onTap(string $payload = '{}', ?string $link = null): void
{
$this->redirect($link ?? route('inbox'));
}
Requirements
| NativePHP Mobile | 3.x and 4.x |
|---|---|
| iOS | 15+. An APNs authentication key (.p8) from your Apple Developer account. Pictures need one more App ID and provisioning profile, for the notification extension; php artisan push:export-ios exports the build with both. |
| Android | API 21+. A Firebase project and its google-services.json — FCM is the push transport on Android devices with Google Play services. Send data-only messages if you rely on taps or deep links. |
| Your backend | Sends the notifications. The plugin is the device half; it does not send pushes for you. |
It does not send push notifications. It receives them. Your server still talks to APNs and FCM, and you still own those credentials — which is the point: no third party sits between your app and Apple.
Licence and delivery
- One-time payment of $49. No subscription.
- One legal entity, unlimited applications, distributed in compiled form.
- Installed with Composer from a private repository; credentials arrive with your purchase.
- Full source — PHP, Swift, Kotlin.
Questions first? suporte@guppylab.com.br