🛒 Bringo

Customer App

Firebase & Login

This connects the app to your Firebase project (push + phone OTP) and enables Google, Facebook and Apple sign-in. First create a Firebase project — see the Firebase Project guide.

1. Add your Firebase config files

The shipped files are placeholders. Replace them with your own, downloaded from Firebase after registering your app's package name / bundle id:

Android
android/app/google-services.json
iOS
ios/Runner/GoogleService-Info.plist
🚨
The bundled google-services.json / GoogleService-Info.plist contain YOUR_FIREBASE_PROJECT_ID placeholders. The app won't connect to Firebase until you drop in your real files. The package/bundle in those files must match your app's package name.

2. Google Sign-In

  1. Web client id The app reads this from your backend — enter it once in Admin → Settings → Login Setting → Google → Client ID and every installed app picks it up at next launch, no rebuild needed. Use the Firebase Web OAuth client id (the client_type: 3 entry in google-services.json).
    If you'd rather bake it into the build, edit the fallback constant in lib/features/auth/social_auth_service.dart: 
    static const String _fallbackClientId =
    'YOUR_WEB_OAUTH_CLIENT_ID.apps.googleusercontent.com';
    The admin value wins whenever it is set.
  2. SHA fingerprints Add your app's SHA-1 and SHA-256 to the Firebase Android app (required for Google sign-in & phone OTP). Get them with ./gradlew signingReport or from Play Console.
  3. iOS URL scheme In ios/Runner/Info.plist, set the reversed client id (from your GoogleService-Info.plist REVERSED_CLIENT_ID) — replace the com.googleusercontent.apps.YOUR_IOS_CLIENT_ID placeholder.

3. Facebook Login

Create a Facebook app first — see the Facebook App guide. Then replace the placeholders:

Android
android/app/src/main/res/values/strings.xml → facebook_app_id, facebook_client_token, fb_login_protocol_scheme (= fb<APP_ID>)
iOS
ios/Runner/Info.plist → FacebookAppID, FacebookClientToken, and the fb<APP_ID> URL scheme

4. Apple Sign-In (iOS)

In Xcode → Runner target → Signing & Capabilities, add Sign in with Apple. Enable the same capability for your App ID in the Apple Developer portal. (Apple login is iOS-only.)

5. Push notifications

  • Android works once your google-services.json is in place.
  • iOS — in Xcode add the Push Notifications and Background Modes → Remote notifications capabilities, and upload your APNs key in Firebase → Cloud Messaging.

Server-side sending is configured in Push Notifications (FCM).

6. Which login buttons appear?

That's controlled from the admin panel — see Social Login. The app shows a provider's button only when you enable it there and the native keys above are set.

Customer app login
Login screen with the enabled sign-in options.
👉
Next: Build Android (APK/AAB).