Connecting Firebase

Before you start

• A Firebase project
• A Firebase Android app whose package name matches this app
• A restricted service account JSON
• google-services.json from Firebase

Configure and verify

1. Create or open Firebase

   In Firebase Console, create a project or open the project used by this app.

2. Register the Android app

   Add an Android app using the exact package name from General Information, then download google-services.json.

3. Create backend credentials

   Create a Google Cloud service account with permission to send Firebase Cloud Messaging messages and download its JSON key. Keep it private.

4. Upload configuration

   Open Firebase in the app dashboard, enter the project ID, upload service account JSON and google-services.json, then optionally store GoogleService-Info.plist for iOS.

5. Choose permission timing

   First launch requests Android 13+ notification permission automatically. Manual bridge waits for webtoapp.requestPermissions().

6. Enable push and rebuild

   Turn on push, save, create a fresh APK, install it, grant notification permission, and check subscriber status.

Which file goes where

Service account JSON

Backend only; used to sign Firebase HTTP v1 requests

google-services.json

Bundled into Android builds; package name must match

GoogleService-Info.plist

Stored for a future iOS worker

Device registration

The Android app obtains an FCM token and registers it with the WebToAppMaker backend. Your website can attach a stable identity after login.

Credential security

Test before release

• Project ID matches the JSON files
• Android package name matches
• Push is enabled
• A rebuilt APK registers a subscriber
• A direct-token test succeeds