Push Notifications (Firebase) — How It Works

Web backendPOS App

Sellino sends push notifications through Firebase Cloud Messaging (FCM) — order updates, delivery, returns/refunds, payouts and admin announcements. Push is optional: leave it off and everything else keeps working, only the phone-level alerts are missing.

Setup has two halves, and both are needed:

Also worth knowing: in-app notifications (the bell icon and its list) are pulled from the backend over the API and always work with no setup at all. Firebase only affects notifications that reach the phone while the app is closed.

Work through steps 1 → 6 below. Steps 3–5 are iOS only — skip them if you only ship on Android.

1 · Create the Firebase Project

One project covers everything — the backend and the POS App.

1. Open the Firebase console and create a project (or open an existing one).
2. Go to Project settings → Service accounts and click Generate new private key. A .json file downloads — this is the service-account JSON the backend uses in step 6.
3. Inside the same project, register the apps you plan to ship:
   • Android app for the POS App (its applicationId)
   • the matching iOS apps (their bundle ids), if you build for iOS

2 · Android Config File

POS App

In the Firebase console, open the Android app you registered and download google-services.json. Place it in the app's android/app/ folder:

PosAppSourceCode/android/app/google-services.json    <- from the POS App's Firebase Android app

Each app gets its own file — the file is tied to the package id it was generated for. Rebuild the app after adding it.

3 · iOS Config File iOS only

POS App

Download GoogleService-Info.plist from the iOS app you registered in Firebase, then add it to ios/Runner/ through Xcode — open the project, right-click the Runner group, choose Add Files to "Runner", and tick Copy items if needed plus the Runner target.

PosAppSourceCode/ios/Runner/GoogleService-Info.plist

4 · iOS APNs Auth Key iOS only — required

Apple does not let Firebase deliver to iPhones on its own. You create an APNs Auth Key (a .p8 file) in your Apple Developer account and hand it to Firebase. Without this, push on iOS silently never arrives — no error, just nothing.

1. Sign in to the Apple Developer portal and open Certificates, Identifiers & Profiles → Keys:
   https://developer.apple.com/account/resources/authkeys/list
2. Create a new key, tick Apple Push Notifications service (APNs), and download the .p8 file. Note the Key ID shown next to it, and your Team ID (top-right of the portal, or under Membership).
3. In the Firebase console go to Project settings → Cloud Messaging → Apple app configuration → APNs Authentication Key and upload the .p8 together with the Key ID and Team ID.

5 · Xcode Capabilities iOS only

Open the app's ios/Runner.xcworkspace in Xcode, select the Runner target → Signing & Capabilities, and add:

• Push Notifications
• Background Modes → tick Remote notifications

Do this for the iOS app you build. Make sure a valid Team is selected for signing at the same time.

6 · Admin Panel — Settings → Push Notifications

Web backend

The final step, and the one that actually turns sending on. In the admin panel open Settings → Push Notifications:

1. Tick Enable push notifications.
2. Upload the service-account JSON from step 1 — the Project ID fills in automatically.
3. Click Test connection and confirm it succeeds before moving on.

Devices register themselves whenever a user signs in to either app, so notifications reach the right person across all of their devices — nothing to configure per user.

Verify & Troubleshoot

Test on a real device, not an emulator — the iOS simulator cannot receive push at all, and Android emulators need Google Play services.

• Nothing arrives on Android — check google-services.json sits in android/app/, that its package id matches applicationId, and that the app was rebuilt after the file was added.
• Android works, iOS does not — almost always the missing APNs Auth Key in the Firebase console, or the Xcode capabilities from step 5.
• Test connection fails in the admin panel — the uploaded JSON is not a service-account key (it is the wrong file type), or the server cannot reach Google over HTTPS.
• Only some users get notified — devices register on sign-in. A user who has never signed in on that device has no token yet.
• In-app bell works but the phone stays silent — that is exactly the split described above: the API side is fine, the Firebase side is not finished.

API Base URL & HTTPS

POS App

The app is just a client of your backend, and uses one config file per environment:

POS App -> lib/core/env/prod_env.dart   (kBaseUrl)   ← release builds
           lib/core/env/dev_env.dart    (kBaseUrl)   ← debug / profile builds

prod -> 'https://yourdomain.com/api/v10'

Release builds always read prod_env.dart, and refuse to start if the URL still points at a dev host or the App API key is still empty.

Image URLs are resolved from the API origin automatically, so there is no separate media URL to configure. Detailed, app-specific configuration lives in the POS App guide.

Real-time (Reverb)

Web backend

The admin panel's live features run on Laravel Reverb. There are no REVERB_* keys in .env — host, port, scheme and credentials are seeded on install and managed from Dashboard → Settings → Realtime (Websocket). Restart the Reverb daemon after changing them. Server-side installation — daemon, Supervisor, proxy — is covered in Real-time Chat (Reverb).