From a450afaf9313c356aad730dfc6b6634b3eb206b8 Mon Sep 17 00:00:00 2001
From: Jacek <jacek@clerk.dev>
Date: Thu, 18 Dec 2025 20:45:59 -0600
Subject: [PATCH 1/2] fix(repo): Use ~ instead of ^ for react peers

---
 pnpm-workspace.yaml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/pnpm-workspace.yaml b/pnpm-workspace.yaml
index 24aec7f11a9..8e3e27f7ebc 100644
--- a/pnpm-workspace.yaml
+++ b/pnpm-workspace.yaml
@@ -3,8 +3,8 @@ packages:
 
 catalogs:
   peer-react:
-    react: ^18.0.0 || ^19.0.3 || ^19.1.4 || ^19.2.3 || ^19.3.0-0
-    react-dom: ^18.0.0 || ^19.0.3 || ^19.1.4 || ^19.2.3 || ^19.3.0-0
+    react: ^18.0.0 || ~19.0.3 || ~19.1.4 || ~19.2.3 || ~19.3.0-0
+    react-dom: ^18.0.0 || ~19.0.3 || ~19.1.4 || ~19.2.3 || ~19.3.0-0
   react:
     '@types/react': 18.3.26
     '@types/react-dom': 18.3.7

From 9ec818e950f12ee1ae742fb3f0ea2dd39d9a152b Mon Sep 17 00:00:00 2001
From: Jacek <jacek@clerk.dev>
Date: Thu, 18 Dec 2025 20:48:12 -0600
Subject: [PATCH 2/2] add changeset

---
 .changeset/fix-react-peer-dependency-ranges.md | 13 +++++++++++++
 1 file changed, 13 insertions(+)
 create mode 100644 .changeset/fix-react-peer-dependency-ranges.md

diff --git a/.changeset/fix-react-peer-dependency-ranges.md b/.changeset/fix-react-peer-dependency-ranges.md
new file mode 100644
index 00000000000..0f1a7641331
--- /dev/null
+++ b/.changeset/fix-react-peer-dependency-ranges.md
@@ -0,0 +1,13 @@
+---
+'@clerk/chrome-extension': patch
+'@clerk/expo': patch
+'@clerk/expo-passkeys': patch
+'@clerk/nextjs': patch
+'@clerk/react': patch
+'@clerk/react-router': patch
+'@clerk/shared': patch
+'@clerk/tanstack-react-start': patch
+'@clerk/ui': patch
+---
+
+Fix React peer dependency version ranges to use `~` instead of `^` for React 19 versions, ensuring non-overlapping version constraints.