Skip to main content

Expo setup

Prepare your Expo project​

note

This package cannot be used in Expo Go because it uses native code. This applies to both the Original and Universal modules.

However, you can add custom native code to an Expo app by using a development build. That is the recommended approach for production apps, and is documented in this guide.

Add config plugin​

After installing the npm package, add a config plugin (read more details below) to the plugins array of your app.json or app.config.js. There are 2 config plugins available: for projects with Firebase, and without Firebase.

Expo without Firebase​

If you're not using Firebase, provide the iosUrlScheme option to the config plugin.

To obtain iosUrlScheme, follow these instructions.

app.json | js
{
  "expo": {
    "plugins": [
      [
        "@react-native-google-signin/google-signin",
        {
          "iosUrlScheme": "com.googleusercontent.apps._some_id_here_"
        }
      ]
    ]
  }
}

Expo and Firebase Authentication​

If you are using Firebase Authentication, follow these instructions to get google-services.json file for Android and these instructions) to get GoogleService-Info.plist for iOS.

Place them into your project and specify the paths to the files:

app.json | js
{
  "expo": {
    "plugins": ["@react-native-google-signin/google-signin"],
    "android": {
      "googleServicesFile": "./google-services.json"
    },
    "ios": {
      "googleServicesFile": "./GoogleService-Info.plist"
    }
  }
}

Swift Package Manager (beta)​

Universal Sign In (premium) supports using Swift Package Manager (SPM) for iOS SDK dependencies through CocoaPods. CocoaPods remains the default; SPM is selected automatically when RNFirebase 26.x is autolinked on iOS and Firebase SPM is enabled. RNFirebase 27+ or failed detection requires an explicit override.

To choose SPM explicitly, add iosDependencyManager to your existing Google Sign-In config plugin options and enable dynamic frameworks with expo-build-properties:

app.json | js
{
  "expo": {
    "plugins": [
      [
        "@react-native-google-signin/google-signin",
        {
          "iosUrlScheme": "com.googleusercontent.apps._some_id_here_",
          "iosDependencyManager": "spm"
        }
      ],
      [
        "expo-build-properties",
        {
          "ios": {
            "useFrameworks": "dynamic"
          }
        }
      ]
    ]
  }
}

Install expo-build-properties with npx expo install expo-build-properties if it is not already installed, then rerun prebuild. For Firebase projects, keep the googleServicesFile configuration above; iosUrlScheme is only required for projects without Firebase.

The iosDependencyManager option accepts "auto" (default), "cocoapods", or "spm". If you use Firebase, keep both SDKs on the same dependency manager. To switch back to CocoaPods, set iosDependencyManager to "cocoapods" and set ios.disableSPM to true in the @react-native-firebase/app config plugin options. A $RNGoogleSigninDependencyManager assignment in ios/Podfile takes precedence over the Expo setting.

Full Expo SwiftPM currently requires upstream packaging fixes. See the iOS guide for the full SwiftPM preview for bare React Native apps.

Build the native app​

Run the following to generate the native project directories.

npx expo prebuild --clean

Rebuild your app and read the config guide!

npx expo run:android && npx expo run:ios