feat(expo): Chris/mobile 405 react native components release by chriscanin · Pull Request #7843 · clerk/javascript

chriscanin · 2026-02-13T16:49:20Z

Description

These changes can be tested by using the snapshot that will be commented in this PR discussion, and installing that into the expo quickstart repo on the branch: chris/mobile-343-bridge-android-to-a-native-module-that-is-available-in-the
(same branch name as here).

https://linear.app/clerk/issue/MOBILE-342/bridge-ios-to-a-native-module-that-is-available-in-the-expo-sdk
MOBILE-289
https://linear.app/clerk/issue/MOBILE-289/expo-google-universal-sign-in

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

Summary by CodeRabbit

New Features
- Native Expo UI: AuthView, InlineAuthView, UserButton, UserProfileView (modal & inline) and native plugin support
- Native auth flows: Google Sign‑In and Apple Sign‑In; new native session/events hooks and client token access
Bug Fixes
- More reliable native↔JS session sync, improved lifecycle/unmount guards, and clearer error handling
Documentation
- Native iOS setup guide and native components README
Chores
- Expo plugin, packaging, podspec and package version updates

- Implemented UserButton component to open UserProfileView on press. - Created UserProfile component for comprehensive profile management. - Integrated native ClerkExpo module for iOS functionality. - Updated ClerkProvider to configure Clerk iOS SDK. - Added exports for new components in the native index file. - Adjusted TypeScript configuration to include additional files. - Modified build process to temporarily skip declaration generation. - Updated dependencies in pnpm-lock.yaml for compatibility.

…d ClerkViewFactory

…nent

…ge-ios-to-a-native-module-that-is-available-in-the-expo

…profile management

…ge-android-to-a-native-module-that-is-available-in-the

…erk integration

…ling and UI presentation - Consolidated Clerk SDK initialization and session management in ClerkExpoModule. - Removed ClerkProfileActivity and replaced it with ClerkUserProfileActivity for better clarity and functionality. - Introduced ClerkViewFactory to manage creation of intents for authentication and user profile activities. - Enhanced error handling and promise management for asynchronous operations. - Updated SignIn and UserProfile components to synchronize native and JS session states effectively. - Improved user experience by ensuring the auth modal is always presented, allowing native UI to manage signed-in state. - Added backward-compatible wrappers for SignedIn and SignedOut components.

…and improved session handling

- Updated `clerk-android` versions in `build.gradle` to `0.1.30` for API and `0.1.4` for UI. - Added Kotlin metadata version check skip to address compatibility issues. - Introduced packaging exclusions for duplicate META-INF files in Android. - Enhanced `ClerkAuthActivity` to improve session handling and logging. - Updated `ClerkExpoModule` to include detailed logging for session retrieval. - Improved `ClerkUserProfileActivity` to handle sign-out detection and logging. - Refined `SignIn` and `UserProfile` components to prevent duplicate auth callbacks and improve user state management. - Added packaging exclusions in the Expo config plugin for Android to resolve dependency conflicts.

- Introduced AuthView component to handle sign-in and sign-up using native UI. - Added AuthView types for better type safety. - Removed deprecated SignIn component and its types. - Updated UserButton and UserProfileView components with enhanced documentation. - Refactored ClerkProvider to sync native sessions with JS SDK. - Adjusted TypeScript configurations for improved declaration generation.

…lement crash in React Native

… state management

…roid

- packages/expo/package.json: merge new exports (./types) and file entries (google, apple) - packages/expo/src/hooks/index.ts: use main's standard re-exports for useSignIn/useSignUp/useWaitlist - packages/expo/src/provider/singleton/createClerkInstance.ts: use @clerk/clerk-js import (not headless subpath) - packages/react/src/isomorphicClerk.ts: use main's ClerkUI loading pattern via options.ui

vercel · 2026-02-13T16:49:25Z

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

Project	Deployment	Actions	Updated (UTC)
clerk-js-sandbox	Ready	Preview, Comment	Mar 4, 2026 9:54pm

changeset-bot · 2026-02-13T16:49:26Z

🦋 Changeset detected

Latest commit: 21933a6

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

…ease

brkalow · 2026-03-02T22:26:51Z

packages/expo/src/specs/NativeClerkUserProfileView.ts

@@ -0,0 +1,14 @@
+// eslint-disable-next-line simple-import-sort/imports, import/namespace, import/default, import/no-named-as-default, import/no-named-as-default-member


ditto, is the order important here to warrant the disables?

brkalow · 2026-03-02T22:32:29Z

packages/expo/src/native/InlineAuthView.tsx

+      if (ClerkExpoModule?.getClientToken) {
+        const nativeClientToken = await ClerkExpoModule.getClientToken();
+        if (nativeClientToken) {
+          await SecureStore.setItemAsync(CLERK_CLIENT_JWT_KEY, nativeClientToken, {


consider using existing TokenCache if possible, or make it clear why we can't

brkalow · 2026-03-02T22:33:38Z

packages/expo/src/components/controlComponents.tsx

+/**
+ * Render children only when the user is signed in.
+ * A convenience wrapper around `<Show when="signed-in">`.
+ */
+export function SignedIn({ children }: PropsWithChildren): ReactNode {
+  return <Show when='signed-in'>{children}</Show>;
+}
+
+/**
+ * Render children only when the user is signed out.
+ * A convenience wrapper around `<Show when="signed-out">`.
+ */
+export function SignedOut({ children }: PropsWithChildren): ReactNode {
+  return <Show when='signed-out'>{children}</Show>;
+}


Do we need to diverge from the other SDKs here and continue exporting these?

brkalow · 2026-03-02T22:34:39Z

packages/expo/src/google-one-tap/ClerkGoogleOneTapSignIn.ts

  async signIn(params?: SignInParams): Promise<OneTapResponse> {
    try {
-      return await getNativeModule().signIn(params ?? {});
+      return (await getNativeModule().signIn((params as any) ?? null)) as unknown as OneTapResponse;


why the need for type casting now?

brkalow · 2026-03-02T22:39:34Z

What integration testing tools are available for react native / expo? Would be great to start seeing those get built out.

Maestro seems popular? https://docs.expo.dev/eas/workflows/examples/e2e-tests/

jacekradko · 2026-03-03T02:07:09Z

.changeset/set-minimum-expo-53.md

+## 2. Removed legacy subpath exports
+
+The following packages have removed their legacy subpath export mappings:
+- `@clerk/expo`
+- `@clerk/shared`
+- `@clerk/react`
+- `@clerk/localizations`
+
+**What changed:**
+Previously, these packages used a workaround to support subpath imports (e.g., `@clerk/shared/react`, `@clerk/expo/web`). These legacy exports have been removed in favor of modern package.json `exports` field configuration.
+
+All public APIs remain available through the main package entry points.


I think this should be split up into its own changeset so we don't have contaminate changelogs

…ease

jacekradko · 2026-03-03T03:01:12Z

Code review

Found 5 issues:

Changeset set-minimum-expo-53.md lists packages with no code changes as major bumps. @clerk/shared, @clerk/localizations, and @clerk/expo-passkeys are declared as major but have zero file changes in this PR. The changeset body describes "Removed legacy subpath exports" for these packages, but no such removals exist in the diff. This will cause incorrect major version releases for unchanged packages when changesets runs.

javascript/.changeset/set-minimum-expo-53.md

Lines 1 to 6 in 5f3be94

    
           --- 
        
           '@clerk/expo': major 
        
           '@clerk/shared': major 
        
           '@clerk/react': major 
        
           '@clerk/localizations': major 
        
           '@clerk/expo-passkeys': major

Manual version bump in packages/expo/package.json conflicts with changeset automation. The version was manually set to 2.19.24 (from 2.19.10 on main), skipping 14 patch versions. This repo uses changesets to manage versions; manual bumps in package.json will conflict with the automated release pipeline.

javascript/packages/expo/package.json

Lines 2 to 4 in 5f3be94

    
           "name": "@clerk/expo", 
        
           "version": "2.19.24", 
        
           "description": "Clerk React Native/Expo library",

app.plugin.js is now 581 lines of standalone JavaScript, diverging from the TypeScript source. Previously this was a one-line shim (module.exports = require('./dist/plugin/withClerkExpo')). It now contains a full standalone implementation of withClerkExpo, withClerkIOS, withClerkAndroid, and withClerkGoogleSignIn while src/plugin/withClerkExpo.ts also exists and is modified. This creates two diverging implementations -- one type-checked and tested, one not.

javascript/packages/expo/app.plugin.js

Lines 1 to 10 in 5f3be94

    
           /** 
        
            * Expo config plugin for @clerk/clerk-expo 
        
            * Automatically configures iOS and Android to work with Clerk native components 
        
            * 
        
            * When this plugin is used: 
        
            * 1. iOS is configured with Swift Package Manager dependency for clerk-ios 
        
            * 2. Android is configured with packaging exclusions for dependencies 
        
            * 
        
            * Native modules are registered via react-native.config.js and standard 
        
            * React Native autolinking (RCTViewManager / ReactPackage).

Generated build artifacts committed to source control. app.plugin.d.ts and app.plugin.d.ts.map are generated TypeScript declaration files that should not be in source control. These are non-standard for this repo where build output goes to dist/.

javascript/packages/expo/app.plugin.d.ts

Lines 1 to 6 in 5f3be94

    
           export = withClerkExpo; 
        
           /** 
        
            * Combined Clerk Expo plugin 
        
            */ 
        
           declare function withClerkExpo(config: any): any; 
        
           //# sourceMappingURL=app.plugin.d.ts.map

fraudProtection.ts React Native bypass creates an infinite retry loop. When document is undefined, managedChallenge returns { captchaError: 'modal_component_not_ready' }. In execute(), this causes __internal_sendCaptchaToken to be skipped (line 72), but captchaRetryCount is only incremented in the inner catch (line 77) -- which is never hit since managedChallenge resolves successfully. The code then calls return await cb() (line 85) which re-throws requires_captcha, re-enters the outer catch, and the cycle repeats indefinitely. The captchaAttemptsExceeded() guard at line 30 is only checked on fresh execute() calls, not within the loop.

javascript/packages/clerk-js/src/core/fraudProtection.ts

Lines 69 to 95 in 5f3be94

    
               try { 
        
                 const captchaParams: any = await this.managedChallenge(clerk); 
        
                 if (captchaParams?.captchaError !== 'modal_component_not_ready') { 
        
                   await this.client.getOrCreateInstance().__internal_sendCaptchaToken(captchaParams); 
        
                   this.captchaRetryCount = 0; // Reset the retry count on success 
        
                 } 
        
               } catch (err) { 
        
                 this.captchaRetryCount++; 
        
                 throw err; 
        
               } finally { 
        
                 // Resolve the exception placeholder promise so that other exceptions can be handled 
        
                 resolve(); 
        
                 this.inflightException = null; 
        
               } 
        
               return await cb(); 
        
             } 
        
           } 
        
           public managedChallenge(clerk: Clerk) { 
        
             // In React Native environments, DOM-based captcha challenges are not supported. 
        
             // Return a no-op result to avoid hanging on DOM APIs that don't exist. 
        
             if (typeof document === 'undefined') { 
        
               return Promise.resolve({ captchaError: 'modal_component_not_ready' }); 
        
             } 
        
             return new this.CaptchaChallengeImpl(clerk).managedInModal({ action: 'verify' });

Additionally, several issues scored just below the threshold (75/100) that may warrant attention: initStartedRef not reset on unmount blocking StrictMode re-initialization, waitForLoad calling addOnLoaded which only exists on IsomorphicClerk (not the HeadlessBrowserClerk returned by createClerkInstance), static import of optional expo-secure-store, TurboModuleRegistry.getEnforcing crashing at import time for optional Google Sign-In, sessionSyncedRef set before setActive succeeds permanently blocking retries, silent error swallowing in useUserProfileModal/UserButton, and unconditional console.log calls in production code (useNativeAuthEvents.ts).

🤖 Generated with Claude Code

_{- If this code review was useful, please react with 👍. Otherwise, react with 👎.}

…e module Move captcha document guard from fraudProtection to CaptchaChallenge. Add ClerkKeychainService Info.plist support for extension apps. Use non-enforcing TurboModuleRegistry.get for ClerkGoogleSignIn.

…t-native-components-release # Conflicts: # .changeset/set-minimum-expo-53.md # packages/clerk-js/src/utils/captcha/CaptchaChallenge.ts # packages/expo/package.json # packages/expo/src/components/controlComponents.tsx

The '__clerk_client_jwt' string was duplicated across 4 files. Extract to a single constant in src/constants.ts.

…ore calls Replace direct expo-secure-store imports in AuthView, InlineAuthView, and ClerkProvider with the existing tokenCache from @clerk/expo/token-cache. This consolidates SecureStore options (AFTER_FIRST_UNLOCK) and error handling in one place.

Replace plain Error throws with ClerkRuntimeError from @clerk/shared/error, providing a unique error code (clerk_instance_not_available) and actionable debugging message.

Prevent unbounded polling in AuthView and InlineAuthView. Caps at 40 polls (60s at 1.5s intervals) before stopping gracefully.

Stop swallowing all errors in presentUserProfile catch blocks. Now only silences expected dismissal/cancellation errors from the native module and logs unexpected errors for debugging.

Modal dismissal resolves with { dismissed: true } on the native side, it does not reject. So the catch block only fires on real errors (E_NOT_INITIALIZED, E_CREATE_FAILED, E_NO_ROOT_VC). Log them properly instead of silencing or string-matching.

Log native module errors (E_NOT_INITIALIZED, E_CREATE_FAILED, etc.) only in development. These are configuration errors actionable during dev, not runtime errors to surface to end users.

…rename Move isClerkNetworkError above the createResourceCache block for visibility. Remove the unnecessary const clerk = __internal_clerk alias and use __internal_clerk directly.

chriscanin added 22 commits December 3, 2025 13:37

feat(clerk): add getSession and signOut methods to ClerkExpoModule an…

39fb327

…d ClerkViewFactory

feat(user-button): fetch and display user details in UserButton compo…

6d393b8

…nent

Refactor code structure for improved readability and maintainability

96dcbbc

Merge remote-tracking branch 'origin/main' into chris/mobile-342-brid…

9962fdc

…ge-ios-to-a-native-module-that-is-available-in-the-expo

feat(clerk): integrate Clerk SDK for Android with authentication and …

82edb61

…profile management

Merge remote-tracking branch 'origin/main' into chris/mobile-343-brid…

13f7a46

…ge-android-to-a-native-module-that-is-available-in-the

feat(clerk): enhance error handling and user session management in Cl…

b2b12c2

…erk integration

feat(clerk): iOS bridging is working. Only minor debugging left to do.

638887d

feat(clerk): update Android integration with new dependency versions …

36780e7

…and improved session handling

feat(clerk): enable native module support and fix module config

d7d2300

feat(expo): add .md suggestion

7a295ab

fix(react): conditionally load UI scripts to prevent document.createE…

d5408eb

…lement crash in React Native

feat: enhance native module support for core-3 and add hooks for auth…

184feae

… state management

clean up images from maestro testing, should not have been commited.

21945eb

Fix android build for core-3 components release.

cfc635d

Continued fixes for android build for core-3 components release.

73a0f6d

fix: improve native bridge quality and prevent coroutine leaks in And…

956cdc9

…roid

Merge branch 'main' into chris/mobile-405-react-native-components-rel…

519479b

…ease

github-actions bot added react expo core-3 labels Feb 13, 2026

Delete .changeset/modern-hornets-fold.md

2283b41

vercel bot deployed to Preview February 13, 2026 16:50 View deployment

brkalow reviewed Mar 2, 2026

View reviewed changes

jacekradko reviewed Mar 3, 2026

View reviewed changes

Merge branch 'main' into chris/mobile-405-react-native-components-rel…

5f3be94

…ease

vercel bot deployed to Preview March 3, 2026 02:19 View deployment

chriscanin mentioned this pull request Mar 3, 2026

Chris/core 3 expo docs fixes clerk/clerk-docs#3168

Merged

fix(expo): captcha guard, keychain customization, non-enforcing nativ…

0d6afa8

…e module Move captcha document guard from fraudProtection to CaptchaChallenge. Add ClerkKeychainService Info.plist support for extension apps. Use non-enforcing TurboModuleRegistry.get for ClerkGoogleSignIn.

vercel bot deployed to Preview March 4, 2026 16:52 View deployment

vercel bot deployed to Preview March 4, 2026 16:55 View deployment

refactor(expo): consolidate CLERK_CLIENT_JWT_KEY into shared constant

5485e1d

The '__clerk_client_jwt' string was duplicated across 4 files. Extract to a single constant in src/constants.ts.

vercel bot deployed to Preview March 4, 2026 18:44 View deployment

vercel bot deployed to Preview March 4, 2026 19:27 View deployment

fix(expo): use ClerkRuntimeError with error codes in native views

b12c46f

Replace plain Error throws with ClerkRuntimeError from @clerk/shared/error, providing a unique error code (clerk_instance_not_available) and actionable debugging message.

vercel bot deployed to Preview March 4, 2026 19:39 View deployment

fix(expo): add max poll limit to native session fallback polling

37d0dbc

Prevent unbounded polling in AuthView and InlineAuthView. Caps at 40 polls (60s at 1.5s intervals) before stopping gracefully.

vercel bot deployed to Preview March 4, 2026 19:45 View deployment

fix(expo): distinguish modal dismissal from unexpected errors

4f48db6

Stop swallowing all errors in presentUserProfile catch blocks. Now only silences expected dismissal/cancellation errors from the native module and logs unexpected errors for debugging.

vercel bot deployed to Preview March 4, 2026 20:06 View deployment

vercel bot deployed to Preview March 4, 2026 20:37 View deployment

fix(expo): guard presentUserProfile error logging with __DEV__

2d87892

Log native module errors (E_NOT_INITIALIZED, E_CREATE_FAILED, etc.) only in development. These are configuration errors actionable during dev, not runtime errors to surface to end users.

vercel bot deployed to Preview March 4, 2026 21:10 View deployment

refactor(expo): hoist isClerkNetworkError helper, remove unnecessary …

21933a6

…rename Move isClerkNetworkError above the createResourceCache block for visibility. Remove the unnecessary const clerk = __internal_clerk alias and use __internal_clerk directly.

vercel bot deployed to Preview March 4, 2026 21:54 View deployment

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat(expo): Chris/mobile 405 react native components release#7843

feat(expo): Chris/mobile 405 react native components release#7843
chriscanin wants to merge 66 commits intomainfrom
chris/mobile-405-react-native-components-release

chriscanin commented Feb 13, 2026 •

edited by coderabbitai bot

Loading

Uh oh!

vercel bot commented Feb 13, 2026 •

edited

Loading

Uh oh!

changeset-bot bot commented Feb 13, 2026 •

edited

Loading

Uh oh!

brkalow Mar 2, 2026

Uh oh!

brkalow Mar 2, 2026

Uh oh!

brkalow Mar 2, 2026

Uh oh!

brkalow Mar 2, 2026

Uh oh!

brkalow commented Mar 2, 2026

Uh oh!

jacekradko Mar 3, 2026

Uh oh!

jacekradko commented Mar 3, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

		@@ -0,0 +1,14 @@
		// eslint-disable-next-line simple-import-sort/imports, import/namespace, import/default, import/no-named-as-default, import/no-named-as-default-member

Conversation

chriscanin commented Feb 13, 2026 • edited by coderabbitai bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Checklist

Type of change

Summary by CodeRabbit

Uh oh!

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

Uh oh!

Uh oh!

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

Uh oh!

🦋 Changeset detected

Uh oh!

brkalow Mar 2, 2026

Choose a reason for hiding this comment

Uh oh!

brkalow Mar 2, 2026

Choose a reason for hiding this comment

Uh oh!

brkalow Mar 2, 2026

Choose a reason for hiding this comment

Uh oh!

brkalow Mar 2, 2026

Choose a reason for hiding this comment

Uh oh!

brkalow commented Mar 2, 2026

Uh oh!

jacekradko Mar 3, 2026

Choose a reason for hiding this comment

Uh oh!

jacekradko commented Mar 3, 2026

Code review

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

chriscanin commented Feb 13, 2026 •

edited by coderabbitai bot

Loading

vercel bot commented Feb 13, 2026 •

edited

Loading

changeset-bot bot commented Feb 13, 2026 •

edited

Loading