Firebase Configuration

Follow these steps to wire up Firebase for your Bubbl backend, Android & iOS clients, and ensure all required capabilities are enabled.

Step 1: Navigate to the Firebase Console

• Visit console.firebase.google.com.
• Sign in with your Google account.

Step 2: Select Your Project & Service Accounts

• Choose your project from the selector.
• Click the ⚙️ Settings gear → Project settings.
• Switch to the Service accounts tab.

Step 3: Generate a New Private Key

• Click Generate new private key.
• Confirm by clicking Generate key.
• A JSON file will download—this is your service account. Keep it secret!

Step 4: Upload Service Account Credentials

• In your Bubbl Platform UI → Plugins > Firebase Configuration.
• Upload the downloaded JSON under “Upload Firebase Credentials.”
• Your backend is now authorized to send push notifications.

Step 5: Enable Cloud Messaging

To deliver pushes you must turn on Firebase Cloud Messaging.

Once these are set, Firebase can route notifications to both Android and iOS (FCM) endpoints.

Global Permissions & Capabilities

app/src/main/AndroidManifest.xml

<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>
<uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION"/>
<application>
  <service
    android:name=".MyFirebaseMessagingService"
    android:exported="false">
    <intent-filter>
      <action android:name="com.google.firebase.MESSAGING_EVENT"/>
    </intent-filter>
  </service>
</application>

Mobile App Setup

Register your Android & iOS apps so they can receive notifications & analytics.

1. Android

• Package name (applicationId), e.g.

  com.example.myapp

  .
• App nickname (optional).
• Click Register app.

Download

google-services.json

• Download and place it in

  app/

  .

Add Firebase SDK

// project-level build.gradle
buildscript {
  repositories { google(); mavenCentral() }
  dependencies {
    classpath 'com.google.gms:google-services:4.4.2'
  }
}
allprojects {
  repositories { google(); mavenCentral() }
}

// app-level build.gradle
plugins {
  id 'com.android.application'
  id 'com.google.gms.google-services'
}
dependencies {
//   FIREBASE DEPENDENCIES

}

2. iOS

• Bundle ID (e.g.

  com.example.myapp

  ).
• Nickname (optional).
• App Store ID (optional).
• Click Register app.

Download

GoogleService-Info.plist

• Drag it into your Xcode project (copy items if needed).

Upload APN Certificate for iOS Push Notifications

Step 1: Generate APN Certificate

1. Go to Apple Developer Portal → Certificates
2. Click the "+" button to create a new certificate
3. Select "Apple Push Notification service SSL (Sandbox & Production)"
4. Choose your App ID and follow the CSR upload process
5. Download the generated certificate (.cer file)

Step 2: Convert Certificate to .p12 Format

1. Double-click the .cer file to add it to your Keychain
2. Open Keychain Access → My Certificates
3. Find your certificate, expand it to see the private key
4. Select both the certificate and private key (Cmd+Click)
5. Right-click → Export 2 items → Save as .p12 file
6. Set a password (you'll need this for Firebase)

Step 3: Upload to Firebase

1. In Firebase Console → Project Settings → Cloud Messaging tab
2. Scroll to "Apple app configuration"
3. Click "Upload" next to APNs Certificates
4. Upload your .p12 file and enter the password
5. Save the configuration

Enable iOS Capabilities in Xcode

In your iOS app target → Signing & Capabilities, add:

• Push Notifications - Required for receiving notifications
• Background Modes → Location updates - Required for geofencing

Configuration Summary

Next Steps

Your Firebase configuration is complete! Your mobile apps can now:

• Receive push notifications via Firebase Cloud Messaging
• Generate FCM tokens for the Bubbl SDK to use
• Support geofencing with proper location capabilities

You can now integrate the Bubbl SDK into your apps using the CocoaPods or Manual integration guides.