feat(ui,react): Add shared React variant to reduce bundle size #7601

brkalow · 2026-01-15T04:38:23Z

Summary

Introduces a new ui.shared.browser.js build variant that externalizes React dependencies, allowing the host application's React to be reused instead of bundling a separate copy
Adds @clerk/ui/register module to register React on globalThis.__clerkSharedModules for sharing with @clerk/ui
Adds clerkUiVariant option to explicitly control which variant to use
For @clerk/react users, the shared variant is automatically detected and enabled for compatible React versions
Extracts version checking logic into a testable utility with comprehensive unit tests
Adds development warnings for configuration fallbacks and React version mismatches

fixes USER-4440

Test plan

Unit tests added for version parsing and bounds checking (20 new tests)
All existing tests pass (328 total)
Build succeeds for @clerk/react package
Manual testing: verify bundle size reduction in a sample app using @clerk/react
Manual testing: verify fallback to non-shared variant when React version is incompatible

🤖 Generated with Claude Code

Summary by CodeRabbit

New Features
- Shared React variant for @clerk/ui to reduce bundle size by reusing the host app’s React.
- New "register" module to let host apps register their React before loading the UI bundle.
- New clerkUiVariant option ('shared') with automatic selection when host React is compatible.
Tests
- Added comprehensive tests for React version compatibility and version-range parsing.

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

changeset-bot · 2026-01-15T04:38:27Z

🦋 Changeset detected

Latest commit: 354950d

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

This PR includes changesets to release 20 packages

Name	Type
@clerk/ui	Minor
@clerk/react	Minor
@clerk/shared	Patch
@clerk/astro	Patch
@clerk/chrome-extension	Patch
@clerk/vue	Patch
@clerk/expo	Patch
@clerk/nextjs	Patch
@clerk/react-router	Patch
@clerk/tanstack-react-start	Patch
@clerk/agent-toolkit	Patch
@clerk/backend	Patch
@clerk/clerk-js	Patch
@clerk/expo-passkeys	Patch
@clerk/express	Patch
@clerk/fastify	Patch
@clerk/localizations	Patch
@clerk/msw	Patch
@clerk/nuxt	Patch
@clerk/testing	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-01-15T04:38:28Z

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

Project	Deployment	Review	Updated (UTC)
clerk-js-sandbox	Ready	Preview, Comment	Jan 22, 2026 3:49am

coderabbitai · 2026-01-15T04:41:12Z

📝 Walkthrough

Walkthrough

Adds a shared React build variant that externalizes React into a ui.shared.browser.js bundle and a register entrypoint (@clerk/ui/register) in ESM and CJS which writes host React modules to globalThis.__clerkSharedModules. Introduces version utilities (parseVersion, checkVersionAgainstBounds, isVersionCompatible, IS_REACT_SHARED_VARIANT_COMPATIBLE) and build-time exposure of supported React bounds. @clerk/react auto-selects the shared variant when compatible; IsomorphicClerkOptions and loadClerkJsScript gain clerkUiVariant?: 'shared' | ''. Build configs, package exports, and tests updated to produce, register, and validate the shared variant.

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 66.67% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title accurately describes the main change: introducing a shared React variant feature to reduce bundle size across `@clerk/ui` and `@clerk/react` packages.
Linked Issues check	✅ Passed	The PR fully implements the objective of USER-4440 by detecting compatible React versions, registering host React on globalThis.__clerkSharedModules, and providing both automatic detection for `@clerk/react` and explicit clerkUiVariant control.
Out of Scope Changes check	✅ Passed	All changes directly support the shared React variant feature and are within scope of USER-4440; no unrelated or extraneous modifications were detected.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

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

pkg-pr-new · 2026-01-15T16:05:01Z

Open in StackBlitz

@clerk/agent-toolkit

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

@clerk/astro

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

@clerk/backend

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

@clerk/chrome-extension

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

@clerk/clerk-js

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

@clerk/dev-cli

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

@clerk/expo

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

@clerk/expo-passkeys

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

@clerk/express

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

@clerk/fastify

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

@clerk/localizations

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

@clerk/nextjs

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

@clerk/nuxt

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

@clerk/react

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

@clerk/react-router

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

@clerk/shared

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

@clerk/tanstack-react-start

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

@clerk/testing

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

@clerk/ui

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

@clerk/upgrade

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

@clerk/vue

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

commit: 354950d

packages/clerk-js/package.json

Introduces a "shared" variant of @clerk/ui that externalizes React dependencies, allowing the host application's React to be reused instead of bundling a separate copy. Changes: - Add @clerk/ui/register module to register React on globalThis - Add ui.shared.browser.js build variant with externalized React - Add React version compatibility checking in @clerk/react - Add clerkUiVariant option to load the appropriate variant - Make dev server React externalization conditional via --env shared Co-Authored-By: Claude Opus 4.5 <[email protected]>

Co-Authored-By: Claude Opus 4.5 <[email protected]>

- Extract version checking logic into testable utility (versionCheck.ts) - Add comprehensive unit tests for version parsing and bounds checking - Move version compatibility check to module level for better performance - Add dev warning when pnpm-workspace.yaml fallback is used - Add warning for React version mismatch in register modules - Remove redundant clerkUiVariant assignment in isomorphicClerk.ts Co-Authored-By: Claude Opus 4.5 <[email protected]>

The new exports field in clerk-js/package.json blocked deep imports that expo and chrome-extension packages depended on. This adds: - ./internal/fapi export for FapiRequestInit/FapiResponse types (expo) - ./no-rhc export for the no-RHC variant (chrome-extension) Also updates expo to use the new clean import path. Co-Authored-By: Claude Opus 4.5 <[email protected]>

- Rename register/index.js to register/index.cjs to fix module syntax mismatch (package uses "type": "module" but file was CommonJS) - Add register/index.d.cts for CJS type declarations to fix "Masquerading as ESM" attw error - Update exports to point to correct file extensions - Run pnpm dedupe to clean up lockfile Co-Authored-By: Claude Opus 4.5 <[email protected]>

The new exports field introduces ESM entry points (.mjs) with CJS type declarations (.d.ts), which triggers attw's "Masquerading as CJS" warning. This is expected behavior for this package's build setup, so we ignore the false-cjs rule. Co-Authored-By: Claude Opus 4.5 <[email protected]>

This reverts commit 74be850.

…rhc variant" This reverts commit 364059b.

Add required curly braces after if conditions in versionCheck.ts and fix import sorting in index.ts. Co-Authored-By: Claude Opus 4.5 <[email protected]>

bratsos

I haven't run it locally yet, but I did a deep dive in the code and it looks good! That's a great optimization 🚀

I'll run it locally on Monday if it's not merged yet as a sanity check.

jacekradko · 2026-01-16T21:41:45Z

Love it! Are we tracking the routing logic for this variant in the sdk-infra-workers repo?

brkalow · 2026-01-16T21:43:51Z

@jacekradko nope, I'll take a look!

brkalow · 2026-01-17T03:40:47Z

@jacekradko On second thought, I'm not sure we need additional logic in the proxy...we don't need/want the ability to pin specific domains to this variant necessarily, it's something that's internal to the SDK

brkalow · 2026-01-17T03:40:59Z

!snapshot

clerk-cookie · 2026-01-17T03:43:08Z

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

Package	Version
@clerk/agent-toolkit	0.2.9-snapshot.v20260117034135
@clerk/astro	3.0.0-snapshot.v20260117034135
@clerk/backend	3.0.0-snapshot.v20260117034135
@clerk/chrome-extension	3.0.0-snapshot.v20260117034135
@clerk/clerk-js	6.0.0-snapshot.v20260117034135
@clerk/dev-cli	1.0.0-snapshot.v20260117034135
@clerk/expo	3.0.0-snapshot.v20260117034135
@clerk/expo-passkeys	1.0.0-snapshot.v20260117034135
@clerk/express	2.0.0-snapshot.v20260117034135
@clerk/fastify	2.6.9-snapshot.v20260117034135
@clerk/localizations	4.0.0-snapshot.v20260117034135
@clerk/msw	0.0.1-snapshot.v20260117034135
@clerk/nextjs	7.0.0-snapshot.v20260117034135
@clerk/nuxt	2.0.0-snapshot.v20260117034135
@clerk/react	6.0.0-snapshot.v20260117034135
@clerk/react-router	3.0.0-snapshot.v20260117034135
@clerk/shared	4.0.0-snapshot.v20260117034135
@clerk/tanstack-react-start	1.0.0-snapshot.v20260117034135
@clerk/testing	2.0.0-snapshot.v20260117034135
@clerk/ui	1.0.0-snapshot.v20260117034135
@clerk/upgrade	2.0.0-snapshot.v20260117034135
@clerk/vue	2.0.0-snapshot.v20260117034135

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

npm i @clerk/[email protected] --save-exact

@clerk/astro

npm i @clerk/[email protected] --save-exact

@clerk/backend

npm i @clerk/[email protected] --save-exact

@clerk/chrome-extension

npm i @clerk/[email protected] --save-exact

@clerk/clerk-js

npm i @clerk/[email protected] --save-exact

@clerk/dev-cli

npm i @clerk/[email protected] --save-exact

@clerk/expo

npm i @clerk/[email protected] --save-exact

@clerk/expo-passkeys

npm i @clerk/[email protected] --save-exact

@clerk/express

npm i @clerk/[email protected] --save-exact

@clerk/fastify

npm i @clerk/[email protected] --save-exact

@clerk/localizations

npm i @clerk/[email protected] --save-exact

@clerk/msw

npm i @clerk/[email protected] --save-exact

@clerk/nextjs

npm i @clerk/[email protected] --save-exact

@clerk/nuxt

npm i @clerk/[email protected] --save-exact

@clerk/react

npm i @clerk/[email protected] --save-exact

@clerk/react-router

npm i @clerk/[email protected] --save-exact

@clerk/shared

npm i @clerk/[email protected] --save-exact

@clerk/tanstack-react-start

npm i @clerk/[email protected] --save-exact

@clerk/testing

npm i @clerk/[email protected] --save-exact

@clerk/ui

npm i @clerk/[email protected] --save-exact

@clerk/upgrade

npm i @clerk/[email protected] --save-exact

@clerk/vue

npm i @clerk/[email protected] --save-exact

jacekradko · 2026-01-17T12:36:21Z

@brkalow https://github.com/clerk/sdk-infra-workers/pull/323

coderabbitai

Actionable comments posted: 1

🤖 Fix all issues with AI agents

In `@packages/ui/rspack.config.js`:
- Around line 20-36: The externals handler sharedReactExternalsHandler currently
externalizes 'react' and 'react-dom' but misses subpaths like 'react-dom/client'
and 'react-dom/server', so update the function (the sharedReactExternalsHandler
that takes ({ request }, callback)) to also detect requests equal to
'react-dom/client' and 'react-dom/server' and call callback(null,
['__clerkSharedModules', 'react-dom/client'], 'root') and callback(null,
['__clerkSharedModules', 'react-dom/server'], 'root') respectively (keeping the
existing branches for 'react' and 'react-dom' and leaving callback() as the
default).

packages/ui/rspack.config.js

Externalize react-dom/client in the shared variant and register it on globalThis.__clerkSharedModules so host apps can share it with @clerk/ui. Co-Authored-By: Claude Opus 4.5 <[email protected]>

Ephem

Really nice work here! I tried the current (outdated) snapshot out with the dashboard a bit and it seems to work well.

ui.browser.js in the dash shrank from 36.1kb to 19.4kb which is a nice win. The rabbit might have a point about react-dom/client though, which might possibly move the needle a bit more?

Update: Oh, I had totally missed this was already addressed and Coderabbit just missed picking up on it. Will do a new snapshot and try it out.

Ephem · 2026-01-21T13:33:45Z

!snapshot

clerk-cookie · 2026-01-21T13:35:59Z

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

Package	Version
@clerk/agent-toolkit	0.2.9-snapshot.v20260121133427
@clerk/astro	3.0.0-snapshot.v20260121133427
@clerk/backend	3.0.0-snapshot.v20260121133427
@clerk/chrome-extension	3.0.0-snapshot.v20260121133427
@clerk/clerk-js	6.0.0-snapshot.v20260121133427
@clerk/dev-cli	1.0.0-snapshot.v20260121133427
@clerk/expo	3.0.0-snapshot.v20260121133427
@clerk/expo-passkeys	1.0.0-snapshot.v20260121133427
@clerk/express	2.0.0-snapshot.v20260121133427
@clerk/fastify	2.6.9-snapshot.v20260121133427
@clerk/localizations	4.0.0-snapshot.v20260121133427
@clerk/msw	0.0.1-snapshot.v20260121133427
@clerk/nextjs	7.0.0-snapshot.v20260121133427
@clerk/nuxt	2.0.0-snapshot.v20260121133427
@clerk/react	6.0.0-snapshot.v20260121133427
@clerk/react-router	3.0.0-snapshot.v20260121133427
@clerk/shared	4.0.0-snapshot.v20260121133427
@clerk/tanstack-react-start	1.0.0-snapshot.v20260121133427
@clerk/testing	2.0.0-snapshot.v20260121133427
@clerk/ui	1.0.0-snapshot.v20260121133427
@clerk/upgrade	2.0.0-snapshot.v20260121133427
@clerk/vue	2.0.0-snapshot.v20260121133427

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

npm i @clerk/[email protected] --save-exact

@clerk/astro

npm i @clerk/[email protected] --save-exact

@clerk/backend

npm i @clerk/[email protected] --save-exact

@clerk/chrome-extension

npm i @clerk/[email protected] --save-exact

@clerk/clerk-js

npm i @clerk/[email protected] --save-exact

@clerk/dev-cli

npm i @clerk/[email protected] --save-exact

@clerk/expo

npm i @clerk/[email protected] --save-exact

@clerk/expo-passkeys

npm i @clerk/[email protected] --save-exact

@clerk/express

npm i @clerk/[email protected] --save-exact

@clerk/fastify

npm i @clerk/[email protected] --save-exact

@clerk/localizations

npm i @clerk/[email protected] --save-exact

@clerk/msw

npm i @clerk/[email protected] --save-exact

@clerk/nextjs

npm i @clerk/[email protected] --save-exact

@clerk/nuxt

npm i @clerk/[email protected] --save-exact

@clerk/react

npm i @clerk/[email protected] --save-exact

@clerk/react-router

npm i @clerk/[email protected] --save-exact

@clerk/shared

npm i @clerk/[email protected] --save-exact

@clerk/tanstack-react-start

npm i @clerk/[email protected] --save-exact

@clerk/testing

npm i @clerk/[email protected] --save-exact

@clerk/ui

npm i @clerk/[email protected] --save-exact

@clerk/upgrade

npm i @clerk/[email protected] --save-exact

@clerk/vue

npm i @clerk/[email protected] --save-exact

Ephem · 2026-01-21T14:13:42Z

Hmm, trying out this very latest snapshot, I'm not seeing any bundle size gains in a local prod build of the dashboard.

Logging React.version gives 19.3.0-canary-f93b9fd4-20251217 which it seems like the checks should match, I tried doing this in a test to verify, and this does indeed pass:

  // This comes from logging it in the build:
  const bounds: VersionBounds[] = [
    [ 18, 0, -1, 0 ],
    [ 19, 0, 0, 3 ],
    [ 19, 1, 1, 4 ],
    [ 19, 2, 2, 3 ],
    [ 19, 3, 3, 0 ]
  ];

  it('returns true for compatible versions', () => {
    expect(isVersionCompatible('19.3.0-canary-f93b9fd4-20251217', bounds)).toBe(true);
  });

Not sure what's going on, I might very well be doing something wrong. 🤔

brkalow · 2026-01-21T16:25:30Z

packages/react/tsup.config.ts

+type VersionBounds = [major: number, minMinor: number, maxMinor: number, minPatch: number];
+
+// Read supported React range from pnpm-workspace.yaml catalogs and parse into bounds
+function getClerkUiSupportedReactBounds(): VersionBounds[] {


I don't love the logic here, doing some iteration...

…pendencies - Remove hardcoded fallback version range in tsup.config.ts - Start from package.json peerDependencies.react to determine version range - If it's a catalog reference (catalog:XXX), resolve it from pnpm-workspace.yaml - If it's already a version range, parse it directly - Extract parseRangeToBounds to build-utils/ for testability - Add comprehensive tests for version range parsing Co-Authored-By: Claude Opus 4.5 <[email protected]>

The ClerkScripts component was not passing clerkUiVariant to clerkUiScriptUrl(), causing ui.browser.js to load instead of ui.shared.browser.js in Next.js apps. - Export IS_REACT_SHARED_VARIANT_COMPATIBLE from @clerk/react/internal - Use React version compatibility to determine default UI variant in Next.js - Pass clerkUiVariant to opts, allowing user override via provider props Co-Authored-By: Claude Opus 4.5 <[email protected]>

brkalow · 2026-01-22T04:01:11Z

!snapshot

clerk-cookie · 2026-01-22T04:03:20Z

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

Package	Version
@clerk/agent-toolkit	0.2.9-snapshot.v20260122040150
@clerk/astro	3.0.0-snapshot.v20260122040150
@clerk/backend	3.0.0-snapshot.v20260122040150
@clerk/chrome-extension	3.0.0-snapshot.v20260122040150
@clerk/clerk-js	6.0.0-snapshot.v20260122040150
@clerk/dev-cli	1.0.0-snapshot.v20260122040150
@clerk/expo	3.0.0-snapshot.v20260122040150
@clerk/expo-passkeys	1.0.0-snapshot.v20260122040150
@clerk/express	2.0.0-snapshot.v20260122040150
@clerk/fastify	2.6.9-snapshot.v20260122040150
@clerk/localizations	4.0.0-snapshot.v20260122040150
@clerk/msw	0.0.1-snapshot.v20260122040150
@clerk/nextjs	7.0.0-snapshot.v20260122040150
@clerk/nuxt	2.0.0-snapshot.v20260122040150
@clerk/react	6.0.0-snapshot.v20260122040150
@clerk/react-router	3.0.0-snapshot.v20260122040150
@clerk/shared	4.0.0-snapshot.v20260122040150
@clerk/tanstack-react-start	1.0.0-snapshot.v20260122040150
@clerk/testing	2.0.0-snapshot.v20260122040150
@clerk/ui	1.0.0-snapshot.v20260122040150
@clerk/upgrade	2.0.0-snapshot.v20260122040150
@clerk/vue	2.0.0-snapshot.v20260122040150

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

npm i @clerk/[email protected] --save-exact

@clerk/astro

npm i @clerk/[email protected] --save-exact

@clerk/backend

npm i @clerk/[email protected] --save-exact

@clerk/chrome-extension

npm i @clerk/[email protected] --save-exact

@clerk/clerk-js

npm i @clerk/[email protected] --save-exact

@clerk/dev-cli

npm i @clerk/[email protected] --save-exact

@clerk/expo

npm i @clerk/[email protected] --save-exact

@clerk/expo-passkeys

npm i @clerk/[email protected] --save-exact

@clerk/express

npm i @clerk/[email protected] --save-exact

@clerk/fastify

npm i @clerk/[email protected] --save-exact

@clerk/localizations

npm i @clerk/[email protected] --save-exact

@clerk/msw

npm i @clerk/[email protected] --save-exact

@clerk/nextjs

npm i @clerk/[email protected] --save-exact

@clerk/nuxt

npm i @clerk/[email protected] --save-exact

@clerk/react

npm i @clerk/[email protected] --save-exact

@clerk/react-router

npm i @clerk/[email protected] --save-exact

@clerk/shared

npm i @clerk/[email protected] --save-exact

@clerk/tanstack-react-start

npm i @clerk/[email protected] --save-exact

@clerk/testing

npm i @clerk/[email protected] --save-exact

@clerk/ui

npm i @clerk/[email protected] --save-exact

@clerk/upgrade

npm i @clerk/[email protected] --save-exact

@clerk/vue

npm i @clerk/[email protected] --save-exact

brkalow · 2026-01-22T04:25:05Z

!snapshot

clerk-cookie · 2026-01-22T04:27:16Z

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

Package	Version
@clerk/agent-toolkit	0.2.9-snapshot.v20260122042543
@clerk/astro	3.0.0-snapshot.v20260122042543
@clerk/backend	3.0.0-snapshot.v20260122042543
@clerk/chrome-extension	3.0.0-snapshot.v20260122042543
@clerk/clerk-js	6.0.0-snapshot.v20260122042543
@clerk/dev-cli	1.0.0-snapshot.v20260122042543
@clerk/expo	3.0.0-snapshot.v20260122042543
@clerk/expo-passkeys	1.0.0-snapshot.v20260122042543
@clerk/express	2.0.0-snapshot.v20260122042543
@clerk/fastify	2.6.9-snapshot.v20260122042543
@clerk/localizations	4.0.0-snapshot.v20260122042543
@clerk/msw	0.0.1-snapshot.v20260122042543
@clerk/nextjs	7.0.0-snapshot.v20260122042543
@clerk/nuxt	2.0.0-snapshot.v20260122042543
@clerk/react	6.0.0-snapshot.v20260122042543
@clerk/react-router	3.0.0-snapshot.v20260122042543
@clerk/shared	4.0.0-snapshot.v20260122042543
@clerk/tanstack-react-start	1.0.0-snapshot.v20260122042543
@clerk/testing	2.0.0-snapshot.v20260122042543
@clerk/ui	1.0.0-snapshot.v20260122042543
@clerk/upgrade	2.0.0-snapshot.v20260122042543
@clerk/vue	2.0.0-snapshot.v20260122042543

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

npm i @clerk/[email protected] --save-exact

@clerk/astro

npm i @clerk/[email protected] --save-exact

@clerk/backend

npm i @clerk/[email protected] --save-exact

@clerk/chrome-extension

npm i @clerk/[email protected] --save-exact

@clerk/clerk-js

npm i @clerk/[email protected] --save-exact

@clerk/dev-cli

npm i @clerk/[email protected] --save-exact

@clerk/expo

npm i @clerk/[email protected] --save-exact

@clerk/expo-passkeys

npm i @clerk/[email protected] --save-exact

@clerk/express

npm i @clerk/[email protected] --save-exact

@clerk/fastify

npm i @clerk/[email protected] --save-exact

@clerk/localizations

npm i @clerk/[email protected] --save-exact

@clerk/msw

npm i @clerk/[email protected] --save-exact

@clerk/nextjs

npm i @clerk/[email protected] --save-exact

@clerk/nuxt

npm i @clerk/[email protected] --save-exact

@clerk/react

npm i @clerk/[email protected] --save-exact

@clerk/react-router

npm i @clerk/[email protected] --save-exact

@clerk/shared

npm i @clerk/[email protected] --save-exact

@clerk/tanstack-react-start

npm i @clerk/[email protected] --save-exact

@clerk/testing

npm i @clerk/[email protected] --save-exact

@clerk/ui

npm i @clerk/[email protected] --save-exact

@clerk/upgrade

npm i @clerk/[email protected] --save-exact

@clerk/vue

npm i @clerk/[email protected] --save-exact

brkalow · 2026-01-22T05:05:36Z

@Ephem I think that was because react-dom/client wasn't being included, in addition to what looks like some change in chunking behavior.

Even with that smaller entry chunk, the total size was about the same. Here is a comparison, loading the sign in component:

Section 1 (canary):
- 1.0 + 36.1 + 44.0 + 114 + 63.7 + 5.2 + 11.2 + 5.7 + 3.0 + 15.8 = 299.7 kB
 
Section 2 (19kb entry):
- 19.4 + 44.0 + 123 + 70.1 + 5.2 + 11.2 + 5.6 + 3.0 + 15.8 = 297.3 kB
  
Section 3 (latest snapshot):
- 33.9 + 114 + 63.8 + 11.2 + 5.6 + 3.0 + 15.8 + 5.2 = 252.5 kB (-15%)

Ephem · 2026-01-22T08:51:57Z

Trying the latest snapshot seems to work! I am now getting the ui.shared.browser.js which I don't think I was getting yesterday.

I was trying the snapshot after the client-fix yesterday, so not sure if something changed since then or if I just missed something when testing. 😄

github-actions bot added clerk-js react core-3 labels Jan 15, 2026

vercel bot deployed to Preview January 15, 2026 04:39 View deployment

github-actions bot added the expo label Jan 15, 2026

vercel bot deployed to Preview January 15, 2026 16:01 View deployment

vercel bot deployed to Preview January 15, 2026 18:20 View deployment

vercel bot deployed to Preview January 15, 2026 18:55 View deployment

vercel bot deployed to Preview January 15, 2026 18:58 View deployment

brkalow commented Jan 15, 2026

View reviewed changes

packages/clerk-js/package.json Outdated Show resolved Hide resolved

brkalow commented Jan 15, 2026

View reviewed changes

packages/clerk-js/package.json Outdated Show resolved Hide resolved

vercel bot had a problem deploying to Preview January 15, 2026 19:07 Failure

brkalow commented Jan 15, 2026

View reviewed changes

packages/clerk-js/package.json Outdated Show resolved Hide resolved

vercel bot had a problem deploying to Preview January 15, 2026 19:07 Failure

vercel bot temporarily deployed to Preview January 15, 2026 20:59 Inactive

brkalow and others added 11 commits January 15, 2026 22:54

docs: Add changeset for shared React variant feature

41e808c

Co-Authored-By: Claude Opus 4.5 <[email protected]>

Revert "fix(clerk-js): Add false-cjs to attw ignore rules"

c083f34

This reverts commit 74be850.

Revert "fix(clerk-js): Add missing exports for internal types and no-…

6755c82

…rhc variant" This reverts commit 364059b.

Apply suggestion from @brkalow

55f725b

Apply suggestion from @brkalow

0c4718f

Apply suggestion from @brkalow

3a7d6b3

fix(react): Fix ESLint curly brace and import sort errors

6818b53

Add required curly braces after if conditions in versionCheck.ts and fix import sorting in index.ts. Co-Authored-By: Claude Opus 4.5 <[email protected]>

vercel bot deployed to Preview January 16, 2026 05:00 View deployment

bratsos approved these changes Jan 16, 2026

View reviewed changes

Merge branch 'main' into brkalow/sacramento

0826067

vercel bot deployed to Preview January 20, 2026 22:26 View deployment

coderabbitai bot reviewed Jan 20, 2026

View reviewed changes

packages/ui/rspack.config.js Show resolved Hide resolved

feat(ui): Add react-dom/client to shared modules registry

83fc89f

Externalize react-dom/client in the shared variant and register it on globalThis.__clerkSharedModules so host apps can share it with @clerk/ui. Co-Authored-By: Claude Opus 4.5 <[email protected]>

vercel bot deployed to Preview January 21, 2026 04:44 View deployment

Ephem approved these changes Jan 21, 2026

View reviewed changes

brkalow commented Jan 21, 2026

View reviewed changes

vercel bot deployed to Preview January 21, 2026 17:01 View deployment

github-actions bot added the nextjs label Jan 22, 2026

vercel bot deployed to Preview January 22, 2026 03:49 View deployment

feat(ui,react): Add shared React variant to reduce bundle size #7601

Are you sure you want to change the base?

feat(ui,react): Add shared React variant to reduce bundle size #7601

Conversation

brkalow commented Jan 15, 2026 • edited by coderabbitai bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Test plan

Summary by CodeRabbit

Uh oh!

changeset-bot bot commented Jan 15, 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 15, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

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

Uh oh!

Walkthrough

Uh oh!

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

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

bratsos left a comment

Choose a reason for hiding this comment

Uh oh!

jacekradko commented Jan 16, 2026

Uh oh!

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

Uh oh!

Uh oh!

brkalow commented Jan 17, 2026

Uh oh!

brkalow commented Jan 17, 2026

Uh oh!

clerk-cookie commented Jan 17, 2026

Uh oh!

jacekradko commented Jan 17, 2026

Uh oh!

coderabbitai bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Ephem left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Ephem commented Jan 21, 2026

Uh oh!

clerk-cookie commented Jan 21, 2026

Uh oh!

Ephem commented Jan 21, 2026

Uh oh!

brkalow Jan 21, 2026

Choose a reason for hiding this comment

Uh oh!

brkalow commented Jan 22, 2026

Uh oh!

clerk-cookie commented Jan 22, 2026

Uh oh!

brkalow commented Jan 22, 2026

Uh oh!

clerk-cookie commented Jan 22, 2026

Uh oh!

brkalow commented Jan 22, 2026

Uh oh!

Ephem commented Jan 22, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

6 participants

brkalow commented Jan 15, 2026 •

edited by coderabbitai bot

Loading

changeset-bot bot commented Jan 15, 2026 •

edited

Loading

vercel bot commented Jan 15, 2026 •

edited

Loading

coderabbitai bot commented Jan 15, 2026 •

edited

Loading

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

edited

Loading

brkalow commented Jan 16, 2026 •

edited

Loading

Ephem left a comment •

edited

Loading