react-native-nitro-google-signin

---
name: react-native-nitro-google-signin
description: >-
license: MIT
---

# React Native Nitro Google Sign-In

## Agent skill (install first for coding agents)

```bash
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

```bash
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 |
| `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

```ts
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](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](https://react-native-nitro-google-sign-in.github.io/docs/guide/troubleshooting#cancelled-after-account-pick) |
| `default_web_client_id was not found` | Add `google-services.json` + Gradle plugin |
| iOS redirect fails | Fix `REVERSED_CLIENT_ID` 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](https://react-native-nitro-google-sign-in.github.io/docs/guide/troubleshooting#ios-pod-install-fails--appcheckcore--recaptchainterop-expo-56) |
| 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/