From 8669054672025248b43694bc0ece08a416e0c759 Mon Sep 17 00:00:00 2001
From: Jacek <jacek@clerk.dev>
Date: Sun, 8 Feb 2026 20:56:45 -0600
Subject: [PATCH 1/3] fix(clerk-js): Restore backwards compat for legacy
 clerkUICtor option

---
 .../clerk-js/src/core/__tests__/clerk.test.ts | 26 +++++++++++++++++++
 packages/clerk-js/src/core/clerk.ts           |  9 +++++++
 2 files changed, 35 insertions(+)

diff --git a/packages/clerk-js/src/core/__tests__/clerk.test.ts b/packages/clerk-js/src/core/__tests__/clerk.test.ts
index fdbad637d16..b467a476cad 100644
--- a/packages/clerk-js/src/core/__tests__/clerk.test.ts
+++ b/packages/clerk-js/src/core/__tests__/clerk.test.ts
@@ -2830,5 +2830,31 @@ describe('Clerk singleton', () => {
 
       expect(mockClerkUICtor).toHaveBeenCalled();
     });
+
+    it('supports legacy clerkUICtor option for backwards compatibility', async () => {
+      const mockClerkUIInstance = { mount: vi.fn() };
+      const mockClerkUICtor = vi.fn(() => mockClerkUIInstance);
+
+      const sut = new Clerk(productionPublishableKey);
+      await sut.load({
+        ...mockedLoadOptions,
+        clerkUICtor: mockClerkUICtor,
+      } as any);
+
+      expect(mockClerkUICtor).toHaveBeenCalled();
+    });
+
+    it('supports legacy clerkUiCtor option for backwards compatibility', async () => {
+      const mockClerkUIInstance = { mount: vi.fn() };
+      const mockClerkUICtor = vi.fn(() => mockClerkUIInstance);
+
+      const sut = new Clerk(productionPublishableKey);
+      await sut.load({
+        ...mockedLoadOptions,
+        clerkUiCtor: mockClerkUICtor,
+      } as any);
+
+      expect(mockClerkUICtor).toHaveBeenCalled();
+    });
   });
 });
diff --git a/packages/clerk-js/src/core/clerk.ts b/packages/clerk-js/src/core/clerk.ts
index b024c7c2a72..0ddb68921bf 100644
--- a/packages/clerk-js/src/core/clerk.ts
+++ b/packages/clerk-js/src/core/clerk.ts
@@ -3277,9 +3277,18 @@ export class Clerk implements ClerkInterface {
   };
 
   #initOptions = (options?: ClerkOptions): ClerkOptions => {
+    // Support legacy clerkUICtor / clerkUiCtor options from older SDK versions.
+    // Convert to the new ui.ClerkUI format so the rest of the codebase only checks one path.
+    const legacy = options as Record<string, unknown> | undefined;
+    const legacyCtor = legacy?.clerkUICtor ?? legacy?.clerkUiCtor;
+    const ui = legacyCtor
+      ? { ...options?.ui, ClerkUI: legacyCtor as NonNullable<ClerkOptions['ui']>['ClerkUI'] }
+      : options?.ui;
+
     return {
       ...defaultOptions,
       ...options,
+      ui,
       allowedRedirectOrigins: createAllowedRedirectOrigins(
         options?.allowedRedirectOrigins,
         this.frontendApi,

From bbac180801bb359484a2952a7fe09e33622e21da Mon Sep 17 00:00:00 2001
From: Jacek <jacek@clerk.dev>
Date: Sun, 8 Feb 2026 20:58:54 -0600
Subject: [PATCH 2/3] fix(clerk-js): Add changeset

---
 .changeset/fix-legacy-clerkuictor-compat.md | 5 +++++
 1 file changed, 5 insertions(+)
 create mode 100644 .changeset/fix-legacy-clerkuictor-compat.md

diff --git a/.changeset/fix-legacy-clerkuictor-compat.md b/.changeset/fix-legacy-clerkuictor-compat.md
new file mode 100644
index 00000000000..097893d55e0
--- /dev/null
+++ b/.changeset/fix-legacy-clerkuictor-compat.md
@@ -0,0 +1,5 @@
+---
+'@clerk/clerk-js': patch
+---
+
+Fix backwards compatibility for legacy `clerkUICtor` option removed in the `ui` prop PR

From 77d6ebacf59c86268000ea7729238c259da52bc9 Mon Sep 17 00:00:00 2001
From: Nikos Douvlis <nikosdouvlis@gmail.com>
Date: Mon, 9 Feb 2026 13:41:56 +0200
Subject: [PATCH 3/3] fix(clerk-js): Bump bundlewatch limit for clerk.js to
 539KB

The legacy clerkUICtor compat code pushed the bundle just over 538KB.
---
 packages/clerk-js/bundlewatch.config.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/clerk-js/bundlewatch.config.json b/packages/clerk-js/bundlewatch.config.json
index 272648511b7..c694488eb56 100644
--- a/packages/clerk-js/bundlewatch.config.json
+++ b/packages/clerk-js/bundlewatch.config.json
@@ -1,6 +1,6 @@
 {
   "files": [
-    { "path": "./dist/clerk.js", "maxSize": "538KB" },
+    { "path": "./dist/clerk.js", "maxSize": "539KB" },
     { "path": "./dist/clerk.browser.js", "maxSize": "66KB" },
     { "path": "./dist/clerk.chips.browser.js", "maxSize": "66KB" },
     { "path": "./dist/clerk.legacy.browser.js", "maxSize": "106KB" },