clerk · nikosdouvlis · Oct 30, 2025 · Oct 17, 2025 · Oct 17, 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/.github/workflows/ci.yml b/.github/workflows/ci.yml
@@ -117,7 +117,7 @@ jobs:
           turbo-token: ${{ secrets.TURBO_TOKEN }}
 
       - name: Turbo Build
-        run: pnpm turbo build $TURBO_ARGS --only
+        run: pnpm turbo build $TURBO_ARGS --only --filter=!@clerk/elements
 
       - name: Upload Turbo Summary
         uses: actions/upload-artifact@v4
@@ -245,7 +245,7 @@ jobs:
         run: |
           # Only run Typedoc tests for one matrix version
           if [ "${{ matrix.node-version }}" == "22" ]; then
-            pnpm test:typedoc
+            pnpm turbo run //#test:typedoc
           fi
         env:
           NODE_VERSION: ${{ matrix.node-version }}
@@ -280,14 +280,12 @@ jobs:
             "generic",
             "express",
             "ap-flows",
-            "elements",
             "localhost",
             "sessions",
             "sessions:staging",
             "handshake",
             "handshake:staging",
             "astro",
-            "expo-web",
             "tanstack-react-start",
             "vue",
             "nuxt",

diff --git a/integration/README.md b/integration/README.md
@@ -368,7 +368,6 @@ Assuming you have a `react-parcel` template defined in `integration/templates`,
    ```
 
    Here's what each thing is doing:
-
    - `setName`: Set internal name
    - `useTemplate`: Define which template inside `integration/templates` to use
    - `setEnvFormatter`: Define how environment variables should be formatted. The first argument accepts `'public'` and `'private'`. Inside [`envs.ts`](./presets/envs.ts) the environment variables you can use through [`withEnv`](#environment-configs) are defined. Since different frameworks require environment variables to be in different formats (e.g. Next.js wants public env vars to be prefixed with `NEXT_PUBLIC_`) you can use this formatter to change that.

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/package.json b/package.json
@@ -4,7 +4,7 @@
   "private": true,
   "license": "MIT",
   "scripts": {
-    "build": "FORCE_COLOR=1 turbo build --concurrency=${TURBO_CONCURRENCY:-80%}",
+    "build": "FORCE_COLOR=1 turbo build --concurrency=${TURBO_CONCURRENCY:-80%} --filter=!@clerk/elements",
     "build:declarations": "FORCE_COLOR=1 turbo build:declarations --concurrency=${TURBO_CONCURRENCY:-80%} --filter=@clerk/nextjs --filter=@clerk/react --filter=@clerk/shared --filter=@clerk/types",
     "bundlewatch": "turbo bundlewatch",
     "changeset": "changeset",
@@ -38,7 +38,7 @@
     "test:integration:custom": "pnpm test:integration:base --grep @custom",
     "test:integration:deployment:nextjs": "pnpm playwright test --config integration/playwright.deployments.config.ts",
     "test:integration:elements": "E2E_APP_ID=elements.* pnpm test:integration:base --grep @elements",
-    "test:integration:expo-web": "E2E_APP_ID=expo.expo-web pnpm test:integration:base --grep @expo-web",
+    "test:integration:expo-web:disabled": "E2E_APP_ID=expo.expo-web pnpm test:integration:base --grep @expo-web",
     "test:integration:express": "E2E_APP_ID=express.* pnpm test:integration:base --grep @express",
     "test:integration:generic": "E2E_APP_ID=react.vite.*,next.appRouter.withEmailCodes* pnpm test:integration:base --grep @generic",
     "test:integration:handshake": "DISABLE_WEB_SECURITY=true E2E_APP_1_ENV_KEY=sessions-prod-1 E2E_SESSIONS_APP_1_HOST=multiple-apps-e2e.clerk.app pnpm test:integration:base --grep @handshake",
@@ -55,7 +55,7 @@
     "test:integration:vue": "E2E_APP_ID=vue.vite pnpm test:integration:base --grep @vue",
     "test:typedoc": "pnpm typedoc:generate && cd ./.typedoc && vitest run",
     "turbo:clean": "turbo daemon clean",
-    "typedoc:generate": "pnpm build:declarations && pnpm typedoc:generate:skip-build",
+    "typedoc:generate": "pnpm build && pnpm typedoc:generate:skip-build",
     "typedoc:generate:skip-build": "typedoc --tsconfig tsconfig.typedoc.json && rm -rf .typedoc/docs && mv .typedoc/temp-docs .typedoc/docs",
     "version-packages": "changeset version && pnpm install --lockfile-only --engine-strict=false",
     "version-packages:canary": "./scripts/canary.mjs",

diff --git a/packages/clerk-js/src/core/auth/cookies/devBrowser.ts b/packages/clerk-js/src/core/auth/cookies/devBrowser.ts
@@ -12,10 +12,10 @@ export type DevBrowserCookieHandler = {
   remove: () => void;
 };
 
-const getCookieAttributes = (): { sameSite: string; secure: boolean } => {
+const getCookieAttributes = () => {
   const sameSite = inCrossOriginIframe() ? 'None' : 'Lax';
   const secure = getSecureAttribute(sameSite);
-  return { sameSite, secure };
+  return { sameSite, secure } as const;
 };
 
 /**

diff --git a/packages/clerk-js/src/core/auth/cookies/session.ts b/packages/clerk-js/src/core/auth/cookies/session.ts
@@ -13,11 +13,11 @@ export type SessionCookieHandler = {
   get: () => string | undefined;
 };
 
-const getCookieAttributes = (): { sameSite: string; secure: boolean; partitioned: boolean } => {
+const getCookieAttributes = () => {
   const sameSite = __BUILD_VARIANT_CHIPS__ ? 'None' : inCrossOriginIframe() ? 'None' : 'Lax';
   const secure = getSecureAttribute(sameSite);
   const partitioned = __BUILD_VARIANT_CHIPS__ && secure;
-  return { sameSite, secure, partitioned };
+  return { sameSite, secure, partitioned } as const;
 };
 
 /**

diff --git a/packages/elements/package.json b/packages/elements/package.json
@@ -58,9 +58,9 @@
     "app:dev:debug:ui": "(cd examples/nextjs && NEXT_PUBLIC_CLERK_ELEMENTS_DEBUG_UI=true pnpm dev)",
     "app:e2e": "(cd examples/nextjs && pnpm e2e)",
     "app:lint": "(cd examples/nextjs && pnpm lint)",
-    "build": "tsup --env.NODE_ENV production",
     "build:analyze": "tsup --env.NODE_ENV production --metafile; open https://esbuild.github.io/analyze/",
     "build:declarations": "tsc -p tsconfig.declarations.json",
+    "build:disable": "tsup --env.NODE_ENV production",
     "dev": "tsup --env.NODE_ENV development --watch",
     "dev:example": "concurrently \"pnpm dev\" \"pnpm app:dev\"",
     "format": "node ../../scripts/format-package.mjs",

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/README.md b/packages/localizations/README.md
@@ -66,7 +66,6 @@ We're open to all community contributions! If you'd like to contribute in any wa
 1. Open the [`localizations/src/en-US.ts`](https://github.com/clerk/javascript/blob/main/packages/localizations/src/en-US.ts) file and add your new key to the object. `en-US` is the default language. If you feel comfortable adding your message in another language than English, feel free to also edit other files.
 
 1. Use the new localization key inside the component. There are two ways:
-
    - The string is inside a component like `<Text>`:
 
      ```diff

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/nuxt/src/runtime/plugin.ts b/packages/nuxt/src/runtime/plugin.ts
@@ -18,7 +18,7 @@ export default defineNuxtPlugin(nuxtApp => {
 
   const runtimeConfig = useRuntimeConfig();
 
-  nuxtApp.vueApp.use(clerkPlugin, {
+  nuxtApp.vueApp.use(clerkPlugin as any, {
     ...(runtimeConfig.public.clerk ?? {}),
     sdkMetadata: {
       name: PACKAGE_NAME,

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
-Original file line number
+Diff line change
@@ Expand Up @@
 . Open the [`localizations/src/en-US.ts`](https://github.com/clerk/javascript/blob/main/packages/localizations/src/en-US.ts) file and add your new key to the object. `en-US` is the default language. If you feel comfortable adding your message in another language than English, feel free to also edit other files.
 . Use the new localization key inside the component. There are two ways:
        - The string is inside a component like `<Text>`:
          ```diff
@@ Expand Down @@