SuperAPI AI Directory
Partner with us中文AI newsFavorites
Skillsreact-native-nitro-google-signin

react-native-nitro-google-signin

Coding & development

View repository

Updated 10-15 15:44

About this skill

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

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