clerk · nikosdouvlis · Oct 17, 2025 · Oct 17, 2025 · Oct 21, 2025 · Oct 21, 2025
diff --git a/.changeset/set-minimum-expo-53.md b/.changeset/set-minimum-expo-53.md
@@ -0,0 +1,37 @@
+---
+'@clerk/expo': major
+'@clerk/expo-passkeys': major
+'@clerk/shared': major
+'@clerk/react': major
+'@clerk/localizations': major
+---
+
+Drop support for Expo 50, 51 and 52. This release includes two breaking changes:
+
+## 1. Updated Expo peer dependency requirements
+
+**@clerk/clerk-expo**
+- **Added** new peer dependency: `expo: >=53 <55`
+  - The core `expo` package is now explicitly required as a peer dependency
+  - This ensures compatibility with the Expo SDK version range that supports the features used by Clerk
+
+**@clerk/expo-passkeys**
+- **Updated** peer dependency: `expo: >=53 <55` (previously `>=50 <55`)
+  - Minimum Expo version increased from 50 to 53
+  - This aligns with the main `@clerk/clerk-expo` package requirements
+
+## 2. Removed legacy subpath exports
+
+The following packages have removed their legacy subpath export mappings:
+- `@clerk/clerk-expo`
+- `@clerk/shared`
+- `@clerk/clerk-react`
+- `@clerk/localizations`
+
+**What changed:**
+Previously, these packages used a workaround to support subpath imports (e.g., `@clerk/shared/react`, `@clerk/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.
+
+
+
diff --git a/integration/templates/expo-web/package.json b/integration/templates/expo-web/package.json
@@ -15,7 +15,7 @@
   "dependencies": {
     "@expo/vector-icons": "^14.0.2",
     "@react-navigation/native": "^6.0.2",
-    "expo": "~51.0.17",
+    "expo": "~53",
     "expo-constants": "~16.0.2",
     "expo-font": "~12.0.7",
     "expo-linking": "~6.3.1",
@@ -24,9 +24,9 @@
     "expo-status-bar": "~1.12.1",
     "expo-system-ui": "~3.0.6",
     "expo-web-browser": "~13.0.3",
-    "react": "18.3.1",
-    "react-dom": "18.3.1",
-    "react-native": "0.74.3",
+    "react": "19.2.0",
+    "react-dom": "19.2.0",
+    "react-native": "0.82.1",
     "react-native-gesture-handler": "~2.16.1",
     "react-native-reanimated": "~3.10.1",
     "react-native-safe-area-context": "4.10.9",

diff --git a/packages/chrome-extension/tsconfig.json b/packages/chrome-extension/tsconfig.json
@@ -9,8 +9,8 @@
     "strict": true,
     "forceConsistentCasingInFileNames": true,
     "noFallthroughCasesInSwitch": true,
-    "module": "esnext",
-    "moduleResolution": "node",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
     "resolveJsonModule": true,
     "isolatedModules": true,
     "jsx": "react-jsx",

diff --git a/packages/expo-passkeys/package.json b/packages/expo-passkeys/package.json
@@ -40,7 +40,7 @@
     "expo": "~52.0.47"
   },
   "peerDependencies": {
-    "expo": ">=50 <55",
+    "expo": ">=53 <55",
     "react": "catalog:peer-react",
     "react-native": "*"
   }

diff --git a/packages/expo/local-credentials/package.json b/packages/expo/local-credentials/package.json
diff --git a/packages/expo/package.json b/packages/expo/package.json
@@ -65,15 +65,7 @@
   "source": "./src/index.ts",
   "types": "./dist/index.d.ts",
   "files": [
-    "dist",
-    "web",
-    "local-credentials",
-    "passkeys",
-    "secure-store",
-    "resource-cache",
-    "token-cache",
-    "experimental",
-    "legacy"
+    "dist"
   ],
   "scripts": {
     "build": "tsup",
@@ -108,6 +100,7 @@
   },
   "peerDependencies": {
     "@clerk/expo-passkeys": ">=0.0.6",
+    "expo": ">=53 <55",
     "expo-auth-session": ">=5",
     "expo-local-authentication": ">=13.5.0",
     "expo-secure-store": ">=12.4.0",

diff --git a/packages/expo/passkeys/package.json b/packages/expo/passkeys/package.json
diff --git a/packages/expo/resource-cache/package.json b/packages/expo/resource-cache/package.json
diff --git a/packages/expo/secure-store/package.json b/packages/expo/secure-store/package.json
diff --git a/packages/expo/token-cache/package.json b/packages/expo/token-cache/package.json
diff --git a/packages/expo/web/package.json b/packages/expo/web/package.json
diff --git a/packages/localizations/package.json b/packages/localizations/package.json
@@ -51,54 +51,10 @@
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "files": [
-    "dist",
-    "ar-SA",
-    "be-BY",
-    "ca-ES",
-    "cs-CZ",
-    "da-DK",
-    "de-DE",
-    "el-GR",
-    "en-GB",
-    "en-US",
-    "es-CR",
-    "es-ES",
-    "fa-IR",
-    "fi-FI",
-    "fr-FR",
-    "he-IL",
-    "id-ID",
-    "is-IS",
-    "it-IT",
-    "ja-JP",
-    "ko-KR",
-    "mn-MN",
-    "nb-NO",
-    "nl-NL",
-    "nl-BE",
-    "pl-PL",
-    "pt-BR",
-    "pt-PT",
-    "ro-RO",
-    "ru-RU",
-    "sk-SK",
-    "sv-SE",
-    "tr-TR",
-    "uk-UA",
-    "vi-VN",
-    "zh-CN",
-    "zh-TW",
-    "es-MX",
-    "bg-BG",
-    "th-TH",
-    "hu-HU",
-    "sr-RS",
-    "hr-HR",
-    "es-UY"
+    "dist"
   ],
   "scripts": {
     "build": "tsup --env.NODE_ENV production",
-    "postbuild": "node ../../scripts/subpath-workaround.mjs localizations",
     "clean": "rimraf ./dist",
     "dev": "tsup --watch",
     "format": "node ../../scripts/format-package.mjs",

diff --git a/packages/localizations/subpaths.mjs b/packages/localizations/subpaths.mjs
diff --git a/packages/nextjs/src/experimental.ts b/packages/nextjs/src/experimental.ts
@@ -1,9 +1,3 @@
 'use client';
 
 export * from '@clerk/react/experimental';
-
-export type {
-  __experimental_CheckoutButtonProps as CheckoutButtonProps,
-  __experimental_SubscriptionDetailsButtonProps as SubscriptionDetailsButtonProps,
-  __experimental_PlanDetailsButtonProps as PlanDetailsButtonProps,
-} from '@clerk/types';
diff --git a/packages/react/package.json b/packages/react/package.json
@@ -77,15 +77,10 @@
   },
   "main": "./dist/index.js",
   "files": [
-    "dist",
-    "internal",
-    "errors",
-    "experimental",
-    "legacy"
+    "dist"
   ],
   "scripts": {
     "build": "tsup",
-    "postbuild": "node ../../scripts/subpath-workaround.mjs react",
     "build:declarations": "tsc -p tsconfig.declarations.json",
     "clean": "rimraf ./dist",
     "dev": "tsup --watch",

diff --git a/packages/react/subpaths.mjs b/packages/react/subpaths.mjs
diff --git a/packages/shared/package.json b/packages/shared/package.json
@@ -82,61 +82,10 @@
   },
   "main": "./dist/index.js",
   "files": [
-    "dist",
-    "scripts",
-    "authorization",
-    "authorization-errors",
-    "browser",
-    "retry",
-    "color",
-    "cookie",
-    "date",
-    "deprecated",
-    "deriveState",
-    "dom",
-    "error",
-    "file",
-    "globs",
-    "handleValueOrFn",
-    "isomorphicAtob",
-    "isomorphicBtoa",
-    "keys",
-    "loadClerkJsScript",
-    "loadScript",
-    "localStorageBroadcastChannel",
-    "poller",
-    "proxy",
-    "underscore",
-    "url",
-    "versionSelector",
-    "react",
-    "constants",
-    "apiUrlFromPublishableKey",
-    "telemetry",
-    "logger",
-    "webauthn",
-    "router",
-    "pathToRegexp",
-    "utils",
-    "workerTimers",
-    "devBrowser",
-    "object",
-    "oauth",
-    "web3",
-    "saml",
-    "getEnvVariable",
-    "pathMatcher",
-    "organization",
-    "jwtPayloadParser",
-    "eventBus",
-    "netlifyCacheHandler",
-    "clerkEventBus",
-    "phoneCodeChannel",
-    "types"
+    "dist"
   ],
   "scripts": {
     "build": "tsup",
-    "postbuild": "node ../../scripts/subpath-workaround.mjs shared",
     "build:declarations": "tsc -p tsconfig.declarations.json",
     "clean": "rimraf ./dist",
     "dev": "tsup --watch",

diff --git a/packages/shared/subpaths.mjs b/packages/shared/subpaths.mjs
diff --git a/packages/tanstack-react-start/src/experimental.ts b/packages/tanstack-react-start/src/experimental.ts
@@ -1 +1 @@
-export { useSignInSignal as useSignIn, useSignUpSignal as useSignUp } from '@clerk/clerk-react/experimental';
+export * from '@clerk/react/experimental';
Original file line number	Diff line number	Diff line change
		@@ -1 +1 @@
		export { useSignInSignal as useSignIn, useSignUpSignal as useSignUp } from '@clerk/clerk-react/experimental';
		export * from '@clerk/react/experimental';