🍎Social Login with Firebase

This guide covers how to set up a login page in Bravo using Firebase as the user management service. where users log in with their existing Google/Apple accounts.

What is Firebase? Firebase is a backend-as-a-service (Baas) from Google that provides features for building mobile apps.

1. Setting up the UI

💾 Sample design file

Here is a sample design file that already contain all the necessary tags for the Social logins (Google and Apple). This can also be combined in the same file with email and password login or phone login in case you want to provide all the options.

Bravo Sample: Firebase Google & Apple loginFigma

Sample design for social login

Apple login is only supported on iOS devices.

1.1. Social login page (Google and Apple)

Use the tags below to set up Google and Apple login:

• [action:login:firebase-google]: Performs the Google login action, needs to be added in the Google login button.

• [action:login:firebase-apple]: Performs the Apple login action, needs to be added in the Apple login button. Note that Apple login will only work on iOS devices.

• [ignore:android]: As Apple login is not supported on Android devices, it is recommended to hide the Apple login button there, to provide a good user experience. This tag will hide the UI element attached to it on Android devices.

Social logins will only work on the final apps (test or released), not in Bravo Vision.

For phone and social logins, there's no signup page - the login action will also create new accounts for first-time users.

2. Set up in Firebase

Once you have the UI ready, it's time to manage user authentication in your existing Firebase project.

If you haven't created your Firebase project yet, follow the steps provided here.

2.1. Enable authentication

1. After the project is created, click on Project Overview from the left menu and then select Authentication. Here is where your user accounts will be created and stored.

2. Go to Sign-in method tab, click on Add new provider to activate the Google and/or Apple sign-in.

3. Select your desired provider and toggle the Enable button to activate.

4. Complete the required Public-facing name and Support email fields for project-

5. Finally, click Save.

3. Firebase Configuration in Bravo

To activate the Social login (Google and Apple), you may complete the following:

1. Go to Bravo Studio, select your app and go to Integrations > Login > Enable Firebase > Activate Social Login.

Activate Social Login button from Bravo Studio

2. Now, you need to obtain the Firebase configuration files (GoogleService-Info.plist for iOS and google-services.json for Android) and upload them to Bravo. The purpose of this configuration file is to create a link between our app and this Firebase project. So, if in the future, you want to connect to another Firebase project, you can do it by uploading a new Firebase configuration file in Bravo for each mobile platform (iOS and Android). Depending on your needs, you can either: - Set up your Firebase Login for Bravo Vision (recommended for prototyping and testing) - Set up your Firebase Login for your live or published app (recommended for publishers)

In case you want to configure both Bravo Vision and live app for iOS and Android, you will need 4 apps in Firebase and download 4 files in total:

• The "com.codelesslabs.app" app will provide you the GoogleService-Info.plist for iOS Bravo Vision

• The "com.appfoundry.previewer" app will provide you the google-services.json for Android Bravo Vision

• An app with the bundle ID will provide you the GoogleService-Info.plist for iOS published app.

• An app with the Android package name will provide you the google-services.json for Android published app.

Follow the steps below to see how to configure them in Firebase:

3.1. Firebase Services for Bravo Vision

Here are the steps to follow if you want to get the configuration files for Bravo Vision:

3.1.1. Create an app and download the Config files for Bravo Vision

If you don't have any app created in Firebase yet, follow the next steps as you need to create new Firebase configuration files to upload them to Bravo Studio.

1. Scroll down to Your apps section and click Add app.

2. Choose a platform (iOS or Android) and do the following depending on the platform:

IOS

1. Go to Project Overview (from the left menu), click the iOS symbol.

2. In step 1, fill in the iOS Bundle ID for Bravo Vision: com.codelesslabs.app Leave the rest blank, and click Register app.

2. In step 2, download the file GoogleService-Info.plist and click, Next to continue.

3. The rest of the steps are not needed, so click Next for Steps 3 and 4.

4. To finish, in Step 5, click Continue to the console.

5. To verify that the app has been created, go to your Project Overview > General > Your apps.

Android

1. Go to Project Overview (from the left menu), click the Android symbol or Add an app.

2. In step 1, fill in the Android package name for Bravo Vision: com.appfoundry.previewer Leave the rest blank, and click Register app.

3. In step 2, download the file google-services.json.

3. Click Next. The rest of the steps are not needed, so click Next for steps 3. In the final step, click Skip this step (or Continue to console if it's enabled).

3.1.2 Upload the Firebase Config files in Bravo

1. Once having the Firebase configuration files, go back to Bravo Studio, open the App project that has the login (or import your design file if you haven't yet) and click on the Integrations tab.

2. Navigate to the Login option in the left-hand sidebar and Enable the Firebase toggle.

3. Once enabled, the Bravo Vision tab will be selected by default. Click on the Configure button to upload the Firebase files in the corresponding fields. It is also possible to do so from Firebase Config.

   

   Enable Firebase Login from the App's Integrations tab

   

   Upload the Firebase files from Firebase Config
4. After uploading the files, do not forget to Save the changes. You must have a green check in order for that integration to work correctly on that platform you're setting up. If you're not setting up Firebase in a certain platform, you can ignore the warning icon.

   

   Completed Firebase Config files for Android and IOS
5. Your app is ready to test! Open Bravo Vision to test out the login pages.

On Bravo Vision, every time the app is opened, login will be required. This won't happen on the published app, where the session will be maintained until the user chooses to log out.

After the user has logged in, a variable will be created: ${user.id}. This built-in variable can be sent as part of an API request, to handle user-specific data in the database.

3.2 Firebase Services for published app

Once you are ready to publish your app to the stores, you need to create new Firebase configuration files with the final bundle ID (for iOS) and package name (for Android) and upload them to Bravo Studio.

Activate Firebase services in your final app

3.2.1. Create an app and download the Config files for the live app

If you don't have any app created in Firebase yet, follow the next steps as you need to create new Firebase configuration files with the final bundle ID (for iOS) and package name (for Android) and upload them to Bravo Studio. Otherwise, add the missing params we mention:

1. Scroll down to Your apps section and click Add app.

2. Select a platform: iOS or Android.

3. Register the app and do the following depending on the platform:

iOS

1. Enter your Bundle ID and App Store ID. Remember you need to complete step 2 of the publishing process to have these parameters ready.

Where do I find the final Bundle ID (for iOS)?

When you have the necessary files for publication, use the same Bundle ID from the Bravo publication form for the final Firebase file. (Check how to set up the Bundle ID on the app publication process)

Register iOS app with iOS bundle ID

2. Additionally on iOS, you also need to set up Apple login in your Developer Console.

   1. Log in to your Apple Developer account at https://developer.apple.com/account/resources/identifiers/list.

   2. Review the existing identifiers or appID for your app.

   3. Locate and select “Sign In with Apple” from the list.

   4. Save the changes.

   5. Visit https://developer.apple.com/account/resources/profiles/list.

   6. Check if your profile(s) are now marked as invalid.

   7. Edit the invalid profile(s) by adding the new identifier or mobileprovisions.

   8. Save the updated profile.

   9. Finally, request a new build of your app using the recently updated profile with the new identifier.

Android

1. Where do I find the final package name (for Android)?

2. To enable Google login on Android final apps (remember Apple login is not supported), do the following:

   • Obtain the first SHA-1 requesting a debug APK. Once requested, go to the bundle history section inside your Bravo project and copy it from there:

   

   Build request history in Bravo Studio

   • Obtain the second SHA-1 code for the published app version, which can only be obtained from Google Play. In order to get this code, you need to submit your app to publication first, and have it approved by Google Play. Copy the SHA-1 code from the section indicated below.

   

   Google Play SHA-1 certificate fingerprint
3. Once copied, go to Firebase and to the corresponding Firebase app inside your project, under SHA certificate fingerprints, click "Add fingerprint" and paste both SHA-1 codes. Make sure that you've added two SHA-1 codes.

Firebase Android app

Once the SHA-1 codes have been copied in the Firebase project, the app will be allowed to log in via Google.

3.2.2. Upload the Firebase Config files in Bravo

1. Once having the Firebase configuration files, go back to Bravo Studio, select the App > Integrations tab > Firebase Config.

2. Under "Activate Firebase services for final app", upload the Firebase files in the corresponding fields and do not forget to Save the changes.

3. Firebase integration has been updated in this app. Please request a new build and upload a new version to ensure your published app continues to work properly.

In case you already have a published app bundle, and you change these Firebase assets, you'll need to generate a new bundle and publish an update to the stores.

Once completed, your app's login is ready to test! 🎉 Open Bravo Vision or your Published app to test out the login pages.