Firebase during publishing

When you publish your app and the Firebase module is active, the wizard shows a Firebase step. Here you provide the service account of your Firebase project — this lets BLOCQ set up all Firebase services automatically during publishing.

Only with Firebase active

This step only appears if the Firebase module is enabled in your app. Without Firebase, this part of the publishing process is skipped.

Project & config files were already set up during module setup

Creating the Firebase project, registering the iOS/Android app, and uploading the config files (GoogleService-Info.plist, google-services.json) happens already when you activate the Firebase module — not here in the publish wizard. The publish step is only about the service account.

• Create the project: Create a Firebase project

---

What happens in the publish step

Step	Description	Effort
Set up service account	Create a Google Cloud service account with the required roles	~10 min
Upload service account JSON	Upload the JSON file; the app validates the connection	~2 min

One-time

You only do these steps once. For future updates the existing configuration is reused.

---

The flow

The Firebase step shows a service account card with a status (configured / not configured yet). Tap it to open the guided service account assistant.

1. Create the service account

   Tap the service account card. The guided assistant opens the Google Cloud Console right inside the app and walks you through creating a service account with the required roles.

   Detailed guide: Set up a service account

2. Upload the service account JSON

   Upload the service account’s JSON file. The app validates the connection automatically. Once it’s valid, the card turns green and you can continue.

---

What does this replace?

Previously you had to set up Firebase before activating a module:

Before	Now
Create the Firebase project before the first module	Create the Firebase project during publishing
Copy Firestore rules manually	Rules are deployed automatically
Copy storage rules manually	Rules are deployed automatically
Create indexes manually	Indexes are created automatically
Manual or automatic setup per module	Everything at once, fully automatic

---

After the Firebase setup

Once the Firebase setup is complete, the Auto-Setup Runner starts automatically. It configures all active modules:

• Firestore security rules for all active modules
• Storage security rules
• Firestore indexes
• Auth methods
• Admin account
• Data migration

You don’t need to do anything else — the runner handles everything automatically.

---

Troubleshooting

”Invalid config file”

Problem: The uploaded plist or json file is not accepted.

Solutions:

• Make sure you selected the correct file
• Check that the file belongs to the correct Firebase project
• Download the file again from the Firebase Console

”Service account connection failed”

Problem: The connection to the service account cannot be established.

Solutions:

• Check that all 7 roles were assigned correctly
• Make sure the JSON file was downloaded completely
• Wait a few minutes — new permissions sometimes take time to take effect

---

Related topics

Create a Firebase project Step by step to your own Firebase project

Set up a service account Detailed guide for the service account

Automatic Firebase setup What the Auto-Setup Runner configures

Publish app The entire publishing process