fix(expo): Resolve Android native modules optionally by wobsoriano · Pull Request #9203 · clerk/javascript

wobsoriano · 2026-07-21T04:06:45Z

Description

On Android, the native module specs used requireNativeModule, which throws at import time. Since ClerkProvider imports that chain unconditionally, every Android app crashed at startup with Cannot find native module 'ClerkExpo' when the module wasn't compiled in (Expo Go), even for JavaScript-only flows.

iOS already used requireOptionalNativeModule. This makes Android match, letting the existing null guard degrade gracefully.

Fixes #9197

Checklist

pnpm test runs as expected.
pnpm build runs as expected.
(If applicable) JSDoc comments have been added or updated for any package exports
(If applicable) Documentation has been updated

Type of change

… crash

changeset-bot · 2026-07-21T04:06:50Z

🦋 Changeset detected

Latest commit: 2881086

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

This PR includes changesets to release 1 package

Name	Type
@clerk/expo	Patch

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-07-21T04:06:51Z

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

Project	Deployment	Actions	Updated (UTC)
clerk-js-sandbox	Ready	Preview, Comment	Jul 21, 2026 4:24am
swingset	Ready	Preview, Comment	Jul 21, 2026 4:24am

pkg-pr-new · 2026-07-21T04:08:46Z

Open in StackBlitz

@clerk/astro

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

@clerk/backend

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

@clerk/chrome-extension

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

@clerk/clerk-js

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

@clerk/electron

npm i https://pkg.pr.new/@clerk/electron@9203

@clerk/electron-passkeys

npm i https://pkg.pr.new/@clerk/electron-passkeys@9203

@clerk/eslint-plugin

npm i https://pkg.pr.new/@clerk/eslint-plugin@9203

@clerk/expo

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

@clerk/expo-passkeys

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

@clerk/express

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

@clerk/fastify

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

@clerk/hono

npm i https://pkg.pr.new/@clerk/hono@9203

@clerk/localizations

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

@clerk/nextjs

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

@clerk/nuxt

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

@clerk/react

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

@clerk/react-router

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

@clerk/shared

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

@clerk/tanstack-react-start

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

@clerk/testing

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

@clerk/ui

npm i https://pkg.pr.new/@clerk/ui@9203

@clerk/upgrade

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

@clerk/vue

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

commit: 2881086

coderabbitai · 2026-07-21T04:09:19Z

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Repository YAML (base), Organization UI (inherited)

Review profile: CHILL

Plan: Pro Plus

Run ID: 98b04413-ec95-46a4-a8dc-176d4870cf4a

📥 Commits

Reviewing files that changed from the base of the PR and between c112e5f and 2881086.

📒 Files selected for processing (2)

packages/expo/src/specs/NativeClerkGoogleSignIn.android.ts
packages/expo/src/specs/__tests__/androidSpecs.test.ts

🔗 Linked repositories identified

CodeRabbit considers these linked repositories for cross-repo context during reviews:

clerk/clerk_go (manual)
clerk/dashboard (manual)
clerk/accounts (manual)
clerk/backoffice (manual)
clerk/clerk (manual)
clerk/clerk-docs (manual)
clerk/cloudflare-workers (manual)

🚧 Files skipped from review as they are similar to previous changes (2)

packages/expo/src/specs/tests/androidSpecs.test.ts
packages/expo/src/specs/NativeClerkGoogleSignIn.android.ts

📝 Walkthrough

Walkthrough

Android Expo native module specs now use optional loading, allowing missing ClerkExpo and ClerkGoogleSignIn modules to resolve to null instead of throwing during import. New tests verify this behavior in Expo Go, and a patch changeset documents the fix for the Android <ClerkProvider> crash.

Estimated code review effort: 2 (Simple) | ~10 minutes

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title is concise and accurately reflects the Android optional native-module change.
Description check	✅ Passed	The description clearly matches the Android Expo Go crash fix and optional module loading change.
Linked Issues check	✅ Passed	The changes satisfy `#9197` by making Android native-module resolution optional and adding coverage for the Expo Go case.
Out of Scope Changes check	✅ Passed	The extra Google SignIn optional-loading update and changelog entry are consistent with the same Expo fix, not unrelated scope.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

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

coderabbitai

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@packages/expo/src/specs/__tests__/androidSpecs.test.ts`:
- Around line 8-22: The android native module specs tests only cover missing
modules; extend the mocked requireOptionalNativeModule path to return fake
modules for each expected module name and assert ClerkExpoSpec and
ClerkGoogleSignInSpec preserve those modules. Keep the existing null/error
tests, and ensure the name-sensitive mock also catches incorrect native module
identifiers.

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

Push a commit to this branch (recommended)
Create a new PR with the fixes

ℹ️ Review info

⚙️ Run configuration

Configuration used: Repository YAML (base), Organization UI (inherited)

Review profile: CHILL

Plan: Pro Plus

Run ID: be63474d-8af5-4729-9b28-a11e3edab236

📥 Commits

Reviewing files that changed from the base of the PR and between c904fb4 and c112e5f.

📒 Files selected for processing (4)

.changeset/fix-android-optional-native-module.md
packages/expo/src/specs/NativeClerkGoogleSignIn.android.ts
packages/expo/src/specs/NativeClerkModule.android.ts
packages/expo/src/specs/__tests__/androidSpecs.test.ts

🔗 Linked repositories identified

CodeRabbit considers these linked repositories for cross-repo context during reviews:

clerk/clerk_go (manual)
clerk/dashboard (manual)
clerk/accounts (manual)
clerk/backoffice (manual)
clerk/clerk (manual)
clerk/clerk-docs (manual)
clerk/cloudflare-workers (manual)

github-actions · 2026-07-21T04:10:21Z

API Changes Report

Generated by Break Check on 2026-07-21T04:24:51.102Z

Summary

Metric	Count
Packages analyzed	19
Packages with changes	0
🔴 Breaking changes	0
🟡 Non-breaking changes	0
🟢 Additions	0

No API Changes Detected

All packages have stable APIs with no detected changes.

Report generated by Break Check

_{Last ran on 2881086.}

fix(expo): Resolve Android native modules optionally to avoid Expo Go…

c112e5f

… crash

github-actions Bot added the expo label Jul 21, 2026

vercel Bot deployed to Preview – swingset July 21, 2026 04:07 View deployment

coderabbitai Bot reviewed Jul 21, 2026

View reviewed changes

Comment thread packages/expo/src/specs/__tests__/androidSpecs.test.ts

chore: address coderabbit comment and clean up comments

2881086

vercel Bot deployed to Preview – clerk-js-sandbox July 21, 2026 04:22 View deployment

vercel Bot deployed to Preview – swingset July 21, 2026 04:24 View deployment

wobsoriano requested a review from a team July 21, 2026 05:52

mikepitre approved these changes Jul 21, 2026

View reviewed changes

wobsoriano merged commit 854bd52 into main Jul 21, 2026
59 checks passed

wobsoriano deleted the rob/fix-js-issue-9197 branch July 21, 2026 14:08

clerk-cookie mentioned this pull request Jul 21, 2026

ci(repo): Version packages #9195

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

fix(expo): Resolve Android native modules optionally#9203

fix(expo): Resolve Android native modules optionally#9203
wobsoriano merged 2 commits into
mainfrom
rob/fix-js-issue-9197

wobsoriano commented Jul 21, 2026

Uh oh!

changeset-bot Bot commented Jul 21, 2026 •

edited

Loading

Uh oh!

vercel Bot commented Jul 21, 2026 •

edited

Loading

Uh oh!

pkg-pr-new Bot commented Jul 21, 2026 •

edited

Loading

Uh oh!

coderabbitai Bot commented Jul 21, 2026 •

edited

Loading

Walkthrough

Uh oh!

coderabbitai Bot left a comment

Uh oh!

Uh oh!

github-actions Bot commented Jul 21, 2026 •

edited

Loading

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Uh oh!

Conversation

wobsoriano commented Jul 21, 2026

Description

Checklist

Type of change

Uh oh!

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

Uh oh!

🦋 Changeset detected

Uh oh!

vercel Bot commented Jul 21, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

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

Uh oh!

Uh oh!

coderabbitai Bot commented Jul 21, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Walkthrough

Uh oh!

coderabbitai Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

github-actions Bot commented Jul 21, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

API Changes Report

Summary

No API Changes Detected

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

changeset-bot Bot commented Jul 21, 2026 •

edited

Loading

vercel Bot commented Jul 21, 2026 •

edited

Loading

pkg-pr-new Bot commented Jul 21, 2026 •

edited

Loading

coderabbitai Bot commented Jul 21, 2026 •

edited

Loading

github-actions Bot commented Jul 21, 2026 •

edited

Loading