Firebase Authentication Setup for iOS & Android

🔧 Skip Auth logic to test app without it

Still setting up Firebase Auth? You can skip the sign-in screen and test your app by setting:

// (mobile)/router.tsx
const isSignedInTest = true;

Create a Firebase project

To set up authorization, start by creating a new project in Firebase:

Go your project on Firebase (opens in a new tab) and create a new project.

Update values in .env.local

Take these Firebase Auth config values and paste them in your .env.local

iOS Setup

1. Register your iOS app

In the Firebase console:

1. Click Add App → Select iOS
2. Enter your iOS Bundle ID (e.g. com.yourcompany.yourapp)
3. (Optional) Add an App nickname
4. Click Register App

2. Download the Firebase config file

Once your iOS app is registered:

1. Click Download GoogleService-Info.plist
2. Save it locally – you'll need it in Xcode

3. Open iOS project in Xcode

Run the following command:

npx cap open ios

4. Add the config to your project

1. Drag & drop the GoogleService-Info.plist into Xcode
2. Select “Copy items if needed”
3. Place it in the root of the app target folder

5. Install Firebase SDK via Swift Package Manager

1. In Xcode: File → Add Packages
2. Paste:

   https://github.com/firebase/firebase-ios-sdk

3. Select only the modules you need (e.g. FirebaseAuth)
4. Click Add Package

6. Enable Google Sign-In

1. Go to Authentication → Sign-in method
2. Enable Google
3. Save

🔁 Re-download GoogleService-Info.plist and replace the old one

7. Enable Apple Sign-In

1. Go to Authentication → Sign-in method
2. Enable Apple
3. Save

8. Configure Custom URL Scheme

1. In Xcode, open project settings
2. Select your app under Targets
3. Go to Info → URL Types
4. Click ➕ and add a new entry
5. In URL Schemes, paste your REVERSED_CLIENT_ID

(found in GoogleService-Info.plist) 6. Leave other fields empty

9. Test Login Flow

You can now call:

import { FirebaseAuthentication } from "@capacitor-firebase/authentication";
 
await FirebaseAuthentication.signInWithGoogle();
// or
await FirebaseAuthentication.signInWithApple();

Sign out:

await FirebaseAuthentication.signOut();

Android Setup

Add a new Android app

In the Firebase console:

1. Click Add App → Select Android
2. Enter your app’s Package name (e.g. com.nextnative.yourapp)
3. (Optional) Add app nickname
4. Click Register app

Download & place config file

1. Download the google-services.json file
2. Place it in:

android/app/google-services.json

Enable Google Sign-In

In Firebase Console:

• Go to Authentication → Sign-in method
• Enable Google
• Save

Sign in with Google

Use the Capacitor plugin to trigger login:

import { FirebaseAuthentication } from "@capacitor-firebase/authentication";
 
await FirebaseAuthentication.signInWithGoogle();

Sign out:

await FirebaseAuthentication.signOut();

Test on real Android device

npx cap open android