Skip to main content

Quick Start

Minimal flow — see Usage for the full sign-in cascade.

Required before this flow

Why: Sign-in calls fail without Google Cloud OAuth clients and platform setup (Google Cloud, Android, iOS, or Expo).

1. Configure (once)​

Required for autoDetect

Why: Native code reads Web client ID from google-services.json / GoogleService-Info.plist. Use explicit webClientId only if you skip those files on Android.

import {
  GoogleOneTapSignIn,
  isNoSavedCredentialFoundResponse,
  isSuccessResponse,
} from 'react-native-nitro-google-signin'

// With google-services.json + GoogleService-Info.plist (recommended):
GoogleOneTapSignIn.configure({ webClientId: 'autoDetect' })

// Optional — explicit Web OAuth client ID (no Android JSON / Gradle):
// GoogleOneTapSignIn.configure({ webClientId: 'YOUR_WEB_CLIENT_ID.apps.googleusercontent.com' })

2. Sign-in flow​

Required on Android only

Why: checkPlayServices() validates Google Play services. On iOS it resolves immediately (no-op).

const startSignInFlow = async () => {
  await GoogleOneTapSignIn.checkPlayServices()

  let response = await GoogleOneTapSignIn.signIn()

  if (isNoSavedCredentialFoundResponse(response)) {
    response = await GoogleOneTapSignIn.createAccount()
  }
  if (isNoSavedCredentialFoundResponse(response)) {
    response = await GoogleOneTapSignIn.presentExplicitSignIn()
  }

  if (isSuccessResponse(response)) {
    const { user, idToken } = response.data
    // Send idToken to your backend for verification
    console.log(user.email, idToken)
  }
}

3. Sign out​

await GoogleOneTapSignIn.signOut()

Platform notes​

CallAndroidiOS
checkPlayServices()Validates Google Play servicesResolves immediately (no-op)
signIn()Credential Manager silent / saved credentialrestorePreviousSignIn
createAccount()Account picker (sign-up path)Interactive sign-in
presentExplicitSignIn()Explicit Sign in with Google UIExplicit sign-in UI

Next​