feat(clerk-expo): Implement Google Sign-In support for Android and iOS (#7208) #7538

chriscanin · 2026-01-05T22:40:11Z

Description

This PR implements native Google Sign-In support for Expo iOS and Android apps using the @react-native-google-signin/google-signin library. This provides a seamless native authentication experience for users signing in with their Google accounts.

What's New

New Hook: useSignInWithGoogle() - Provides native Google Sign-In functionality for iOS and Android
- Platform-specific implementations for iOS (useSignInWithGoogle.ios.ts) and Android (useSignInWithGoogle.android.ts)
- Automatic handling of sign-in/sign-up transfer flow
- Graceful error handling including user cancellation detection
- Support for custom unsafeMetadata during authentication

Key Features

Native UI: Uses platform-native Google Sign-In UI instead of web-based OAuth flow
Automatic Flow Detection: Seamlessly handles both new user sign-up and existing user sign-in
Error Handling: Comprehensive error handling for:
- Missing credentials
- User cancellation (codes SIGN_IN_CANCELLED and -5)
- Play Services availability (Android)
Environment Variable Support: Reads credentials from both Expo config and environment variables
Full Test Coverage: Complete unit tests with 100% coverage for the new hook

Files Changed

packages/expo/src/hooks/useSignInWithGoogle.ts - Cross-platform stub with helpful error message
packages/expo/src/hooks/useSignInWithGoogle.ios.ts - iOS-specific implementation
packages/expo/src/hooks/useSignInWithGoogle.android.ts - Android-specific implementation
packages/expo/src/hooks/__tests__/useSignInWithGoogle.test.ts - Comprehensive unit tests
packages/expo/src/hooks/index.ts - Export new hook
packages/expo/package.json - Add optional peer dependency
packages/expo/vitest.setup.mts - Add test mocks for expo-modules-core

Implementation Details

iOS Implementation:

Uses expo-apple-authentication for native Sign-In
Supports oauth_token_apple strategy
Handles identity token exchange

Android Implementation:

Uses @react-native-google-signin/google-signin library
Configures with Web Client ID and Android Client ID
Checks Google Play Services availability
Handles google_one_tap strategy with ID token

Both implementations:

Automatically handle transfer flow when user doesn't exist
Return consistent API: { createdSessionId, setActive, signIn, signUp }
Support optional unsafeMetadata parameter

Breaking Changes

None - this is a new feature.

Test Plan

Unit tests pass (pnpm test --filter @clerk/clerk-expo)
Build succeeds (pnpm build)
All 9 test cases pass including:
- Successful sign-in for existing users
- Transfer flow for new users
- User cancellation handling (both error codes)
- Play Services availability check (Android)
- Missing ID token validation
- Missing credentials validation
- Clerk not loaded handling

Documentation

Related documentation PR: [Link to clerk-docs PR]

Checklist

pnpm test runs as expected.
pnpm build runs as expected.
JSDoc comments have been added for the new hook and all exported functions
Documentation has been created (see related PR in clerk-docs)

Type of change

🌟 New feature

Summary by CodeRabbit

New Features
- Native Google One Tap Sign-In for iOS and Android: configure, sign-in, create account, explicit sign-in, sign-out; iOS plugin can auto-configure URL scheme.
- Cross-platform useSignInWithGoogle hook with shared flow and platform-specific adapters; JS helpers and public types for One Tap integration.
Tests
- Unit tests covering Android sign-in hook flows and edge cases.
Chores
- Packaging, build and module metadata updates; CocoaPods and Android build config added; .gitignore updated.

_{✏️ Tip: You can customize this high-level summary in your review settings.}

changeset-bot · 2026-01-05T22:40:15Z

🦋 Changeset detected

Latest commit: 668b41b

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
@clerk/clerk-expo	Minor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

vercel · 2026-01-05T22:40:16Z

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Review	Updated (UTC)
clerk-js-sandbox	Ready	Preview, Comment	Jan 9, 2026 7:59pm

coderabbitai · 2026-01-05T22:40:17Z

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

chriscanin · 2026-01-05T22:40:32Z

!snapshot

…S and Android

pkg-pr-new · 2026-01-05T23:42:35Z

Open in StackBlitz

@clerk/agent-toolkit

npm i https://pkg.pr.new/@clerk/agent-toolkit@7538

@clerk/astro

npm i https://pkg.pr.new/@clerk/astro@7538

@clerk/backend

npm i https://pkg.pr.new/@clerk/backend@7538

@clerk/chrome-extension

npm i https://pkg.pr.new/@clerk/chrome-extension@7538

@clerk/clerk-js

npm i https://pkg.pr.new/@clerk/clerk-js@7538

@clerk/dev-cli

npm i https://pkg.pr.new/@clerk/dev-cli@7538

@clerk/elements

npm i https://pkg.pr.new/@clerk/elements@7538

@clerk/clerk-expo

npm i https://pkg.pr.new/@clerk/clerk-expo@7538

@clerk/expo-passkeys

npm i https://pkg.pr.new/@clerk/expo-passkeys@7538

@clerk/express

npm i https://pkg.pr.new/@clerk/express@7538

@clerk/fastify

npm i https://pkg.pr.new/@clerk/fastify@7538

@clerk/localizations

npm i https://pkg.pr.new/@clerk/localizations@7538

@clerk/nextjs

npm i https://pkg.pr.new/@clerk/nextjs@7538

@clerk/nuxt

npm i https://pkg.pr.new/@clerk/nuxt@7538

@clerk/clerk-react

npm i https://pkg.pr.new/@clerk/clerk-react@7538

@clerk/react-router

npm i https://pkg.pr.new/@clerk/react-router@7538

@clerk/remix

npm i https://pkg.pr.new/@clerk/remix@7538

@clerk/shared

npm i https://pkg.pr.new/@clerk/shared@7538

@clerk/tanstack-react-start

npm i https://pkg.pr.new/@clerk/tanstack-react-start@7538

@clerk/testing

npm i https://pkg.pr.new/@clerk/testing@7538

@clerk/themes

npm i https://pkg.pr.new/@clerk/themes@7538

@clerk/types

npm i https://pkg.pr.new/@clerk/types@7538

@clerk/upgrade

npm i https://pkg.pr.new/@clerk/upgrade@7538

@clerk/vue

npm i https://pkg.pr.new/@clerk/vue@7538

commit: 668b41b

chriscanin · 2026-01-06T16:07:42Z

!snapshot

chriscanin · 2026-01-06T16:08:11Z

!snapshot

clerk-cookie · 2026-01-06T16:10:35Z

Hey @chriscanin - the snapshot version command generated the following package versions:

Package	Version
@clerk/chrome-extension	2.8.15-snapshot.v20260106160943
@clerk/clerk-js	5.117.1-snapshot.v20260106160943
@clerk/clerk-expo	2.20.0-snapshot.v20260106160943

Tip: Use the snippet copy button below to quickly install the required packages.
@clerk/chrome-extension

npm i @clerk/chrome-extension@2.8.15-snapshot.v20260106160943 --save-exact

@clerk/clerk-js

npm i @clerk/clerk-js@5.117.1-snapshot.v20260106160943 --save-exact

@clerk/clerk-expo

npm i @clerk/clerk-expo@2.20.0-snapshot.v20260106160943 --save-exact

chriscanin · 2026-01-08T22:05:53Z

!snapshot

clerk-cookie · 2026-01-08T22:08:05Z

Hey @chriscanin - the snapshot version command generated the following package versions:

Package	Version
@clerk/clerk-expo	2.20.0-snapshot.v20260108220629

Tip: Use the snippet copy button below to quickly install the required packages.
@clerk/clerk-expo

npm i @clerk/clerk-expo@2.20.0-snapshot.v20260108220629 --save-exact

feat(expo): Implement Google Sign-In support for Android and iOS (#7208)

3022bf4

chriscanin requested a review from dstaley January 5, 2026 22:40

github-actions bot added expo core-2 labels Jan 5, 2026

chriscanin changed the title ~~feat(expo): Implement Google Sign-In support for Android and iOS (#7208)~~ feat(clerk-expo): Implement Google Sign-In support for Android and iOS (#7208) Jan 5, 2026

fix(changeset): Correct package name for Google Sign-In support in iO…

edf4231

…S and Android

vercel bot deployed to Preview January 5, 2026 22:56 View deployment

pnpm lock resolution

a0738fc

vercel bot deployed to Preview January 5, 2026 23:40 View deployment

chriscanin mentioned this pull request Jan 6, 2026

Add guides for native Sign in with Google in Expo and document useSig… clerk/clerk-docs#2786

Open

2 tasks

Merge branch 'release/core-2' into chris/expo-google-signin-core2

4dd824f

vercel bot deployed to Preview January 8, 2026 22:06 View deployment

Merge branch 'release/core-2' into chris/expo-google-signin-core2

668b41b

vercel bot deployed to Preview January 9, 2026 19:59 View deployment

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

feat(clerk-expo): Implement Google Sign-In support for Android and iOS (#7208) #7538

feat(clerk-expo): Implement Google Sign-In support for Android and iOS (#7208) #7538

Uh oh!

chriscanin commented Jan 5, 2026

Uh oh!

changeset-bot bot commented Jan 5, 2026 •

edited

Loading

Uh oh!

vercel bot commented Jan 5, 2026 •

edited

Loading

Uh oh!

coderabbitai bot commented Jan 5, 2026

Review skipped

Uh oh!

chriscanin commented Jan 5, 2026

Uh oh!

pkg-pr-new bot commented Jan 5, 2026 •

edited

Loading

Uh oh!

chriscanin commented Jan 6, 2026

Uh oh!

chriscanin commented Jan 6, 2026

Uh oh!

clerk-cookie commented Jan 6, 2026

Uh oh!

chriscanin commented Jan 8, 2026

Uh oh!

clerk-cookie commented Jan 8, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

feat(clerk-expo): Implement Google Sign-In support for Android and iOS (#7208) #7538

Are you sure you want to change the base?

feat(clerk-expo): Implement Google Sign-In support for Android and iOS (#7208) #7538

Uh oh!

Conversation

chriscanin commented Jan 5, 2026

Description

What's New

Key Features

Files Changed

Implementation Details

Breaking Changes

Test Plan

Documentation

Checklist

Type of change

Summary by CodeRabbit

Uh oh!

changeset-bot bot commented Jan 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🦋 Changeset detected

Uh oh!

vercel bot commented Jan 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

coderabbitai bot commented Jan 5, 2026

Review skipped

Uh oh!

chriscanin commented Jan 5, 2026

Uh oh!

pkg-pr-new bot commented Jan 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

chriscanin commented Jan 6, 2026

Uh oh!

chriscanin commented Jan 6, 2026

Uh oh!

clerk-cookie commented Jan 6, 2026

Uh oh!

chriscanin commented Jan 8, 2026

Uh oh!

clerk-cookie commented Jan 8, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

changeset-bot bot commented Jan 5, 2026 •

edited

Loading

vercel bot commented Jan 5, 2026 •

edited

Loading

pkg-pr-new bot commented Jan 5, 2026 •

edited

Loading