Seller App

Firebase & Push

Sellers get push alerts for new orders, returns, low stock and announcements. Connect the app to your Firebase project.

1. Register the app in Firebase

Add an Android app and an iOS app to your Firebase project, using your seller package name / bundle id.

2. Add the config file

Replace the placeholder android/app/google-services.json with your downloaded file.

🚨

The bundled file is a placeholder (YOUR_FIREBASE_PROJECT_ID). Its package_name must match your seller app's package, or the build/notifications won't work.

3. Push channels

seller_orders

Critical, high-priority new-order alerts.

seller_general

Returns, stock, wallet, announcements.

iOS: add Push + Background Modes capabilities and an APNs key in Firebase (after regenerating the iOS project — see Build iOS). Server-side sending is set up in Push Notifications (FCM).

Test it

Sign in as a seller and place a test order against that store — the device should receive a "New order" alert on the seller_orders channel.

Getting the config file right

This one file causes most "push doesn't work" tickets, so it is worth being precise:

In Firebase → Project settings → Your apps → Add app → Android, enter your application id character for character. A typo here produces a file that fails the build.

Download and replace

Put the downloaded google-services.json at android/app/google-services.json, replacing the placeholder. Do not merge the files by hand.

Add the release SHA-1

Firebase → your Android app → Add fingerprint. Add both your local signing SHA-1 and, once published, the Play App Signing SHA-1 from the Play Console. Missing the Play SHA-1 is why features work in your own build but break for store installs.

Same project as the server

The service-account JSON in your admin panel must come from the same Firebase project as this file, or sends fail with "SenderId mismatch".

Verify before building:

grep package_name android/app/google-services.json
grep applicationId android/app/build.gradle.kts

The two must match. If they do not, the Gradle plugin stops the build with processDebugGoogleServices failing.

Troubleshooting

Build fails on processDebugGoogleServices

The package_name in the JSON does not equal the applicationId. Re-register the correct id in Firebase and download again.

App runs, no notifications at all

Check the server side first — service-account JSON saved, and the queue worker running. See Push Notifications (FCM).

Notifications on Android, nothing on iOS

APNs key not uploaded to Firebase, or the Push capability is missing in Xcode. The Simulator never receives push.

Worked before, stopped after reinstall

Reinstalling issues a new device token. Sign in again so the app re-registers it.

Nothing after the user declined the prompt

On Android 13+ and iOS, notification permission is explicit. Once declined it must be re-enabled in the OS settings for the app.

👉

Next: Build Android (APK/AAB).