Skip to main content

Expo setup

Prepare your Expo project​

warning

This package cannot be used in the "Expo Go" app because it requires custom native code. However, you can add custom native code to expo by following the guide below.

Read Expo's "Adding custom native code" guide for detailed information.

info

With Expo SDK 50, minimum iOS version was bumped to 13.4. If unsure, please consult release notes to determine the right version of this package to install.

npx expo install @react-native-google-signin/google-signin

After installing this npm package, add the provided config plugin to the plugins array of your app.json or app.config.js.

Expo without Firebase​

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

To obtain iosUrlScheme, go to the Google Cloud Console and copy the "iOS URL scheme" from your iOS client in the "OAuth 2.0 Client IDs" section. Note that the config plugin that works without Firebase is only available to sponsors of this module.

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

Expo and Firebase​

With Firebase, obtain the config file and place it into your project. Then specify the path to the file:

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

Ensure compatibility​

If you're using the sponsor package:

If you're using Expo SDK >= 50, you're good to go.

But if you're using Expo 49 or older, you need to either:

  • install version 12.1.0 of the package
  • or install version >= 13 AND specify compileSdkVersion 34 of your project using Expo BuildProperties

Rebuilding the app​

Then run the following to generate the native project directories.

npx expo prebuild --clean

Next, rebuild your app and you're good to go!

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