react-native-nitro-google-signin

React Native Nitro Google Sign-In

Agent skill (install first for coding agents)

npx skills add react-native-nitro-google-sign-in/google-signin -g -y

Docs: https://react-native-nitro-google-sign-in.github.io/docs/agents/skill

Package install

bun add react-native-nitro-google-signin react-native-nitro-modules
bundle exec pod install --project-directory="ios"

Requires RN ≥ 0.76. Not Expo Go — use expo-dev-client.

Rules

Topic	Rule
API	GoogleOneTapSignIn from react-native-nitro-google-signin
Configure first	GoogleOneTapSignIn.configure({ webClientId }) before sign-in
serverAuthCode	Requires offlineAccess: true in configure() — otherwise always null. requestScopes() still returns accessToken for on-device APIs without offline access
Backend	Verify every idToken on server (sig, aud, iss, exp); validate JWT hd if using hostedDomain
iOS offline grant	Silent signIn() returns serverAuthCode: null — use createAccount() for initial code
revokeAccess	Android: by email/id. iOS: current session only (throws if id mismatch)
getTokens	After sign-in; throws SIGN_IN_REQUIRED if no session. iOS: call clearCachedAccessToken before retry after 401. Android: works in background tasks (no Activity) while scopes are granted
getCurrentUser	Sync; returns user + scopes or null. Check scopes before requestScopes for existing users
Flow order	checkPlayServices → signIn → createAccount → presentExplicitSignIn
Android autoDetect	Needs google-services.json + com.google.gms.google-services plugin
iOS	GoogleService-Info.plist + REVERSED_CLIENT_ID URL scheme
Expo	Plugin react-native-nitro-google-signin; expo prebuild after native config
After native changes	Rebuild app — Metro alone is insufficient

Sign-in flow

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

GoogleOneTapSignIn.configure({ webClientId: 'autoDetect' })

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
}

Platform quick pick

• Expo → plugin + googleServicesFile in app.config.js → reference.md#expo
• Bare Android → SHA-1 + optional Google Services plugin → reference.md#android
• Bare iOS → plist + URL scheme → reference.md#ios

Troubleshooting

Symptom	Likely fix
DEVELOPER_ERROR (Android)	Wrong SHA-1 or package on OAuth client
type: 'cancelled' after picking account (Android release/Play)	Missing Play App Signing / release SHA-1 on Android OAuth client — troubleshooting
default_web_client_id was not found	Add google-services.json + Gradle plugin
iOS redirect fails	Fix REVERSED_CLIENT_ID URL scheme. On scene lifecycle apps, ensure GIDSignIn.sharedInstance.handle(url) is in SceneDelegate.swift
UIApplicationEvaluateRuntimeIssueForNoSceneLifecycleAdoption crash on launch (iOS 27)	Expo SDK 57: add expo-build-properties with ios: { enableSceneSupport: true } (default in SDK 58+). Bare RN: add UIApplicationSceneManifest + SceneDelegate.swift — troubleshooting
pod install / Expo prebuild — AppCheckCore / RecaptchaInterop (or conflict with Firebase App Check)	Expo: upgrade package + prebuild --clean (plugin adds modular headers, no AppCheckCore < 11.3 pin). Bare: add AppCheckCore/GoogleUtilities/RecaptchaInterop with :modular_headers => true — troubleshooting
Nitro not found	Rebuild dev client / bundle exec pod install --project-directory="ios"
Android button laid out but blank	Upgrade package (in-process branding button) + rebuild native app
Sign-in OK in debug, fails in release	Consumer ProGuard rules ship with library; avoid -keep androidx.**; test assembleRelease. Also check release/Play SHA-1 (see cancelled-after-account-pick above)

More detail

• reference.md — API, Expo/bare setup, errors
• examples.md — copy-paste snippets
• Docs: https://react-native-nitro-google-sign-in.github.io/