SKILL.md
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 -yDocs: 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 SIGNINREQUIRED if no session. iOS: call clearCachedAccessToken before retry after 401 |
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 + REVERSEDCLIENTID 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 +
googleServicesFileinapp.config.js→ [reference.md#expo](reference.md#expo) - Bare Android → SHA-1 + optional Google Services plugin → [reference.md#android](reference.md#android)
- Bare iOS → plist + URL scheme → [reference.md#ios](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 |
defaultwebclient_id was not found |
Add google-services.json + Gradle plugin |
| iOS redirect fails | Fix REVERSEDCLIENTID URL scheme |
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](reference.md) — API, Expo/bare setup, errors
- [examples.md](examples.md) — copy-paste snippets
- Docs: https://react-native-nitro-google-sign-in.github.io/