Rename Expo and React packages by dstaley · Pull Request #2801 · clerk/clerk-docs

dstaley · 2025-11-17T18:28:44Z

🔎 Previews:

What does this solve?

In Core 3, our React and Expo packages have been renamed to drop the clerk- prefix. This PR replaces instances of the previous package names with their new versions.

What changed?

Replaced @clerk/clerk-expo with @clerk/expo
Replaced @clerk/clerk-react with @clerk/react

Checklist

I have clicked on "Files changed" and performed a thorough self-review
All existing checks pass

vercel · 2025-11-17T18:28:49Z

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

Project	Deployment	Preview	Updated (UTC)
clerk-docs	Ready	Preview	Nov 19, 2025 4:51pm

manovotny · 2025-11-17T23:34:14Z

docs/guides/development/upgrading/upgrade-guides/expo-v2.mdx


  ```npm
-  npm install @clerk/clerk-expo@latest
+  npm install @clerk/clerk-expo@^2


This can be left as latest, right?

This is a guide specifically for upgrading to Expo v2, so I didn't think it made sense to have it upgrade folks to v3. There is a question though of whether it makes sense to retain this guide at all, but that's above my pay grade 😅

manovotny · 2025-11-17T23:39:22Z

docs/guides/development/upgrading/upgrade-guides/url-based-session-syncing.mdx

 1. In the Clerk Dashboard, navigate to your development instance's [**Settings**](https://dashboard.clerk.com/~/settings) page and toggle on **Enable URL-based session syncing**.
   - This toggle is not available in Clerk apps created after December 6th, 2022.
-1. In your codebase, upgrade `@clerk/clerk-react` to v4.4.5 or later. If your are importing `@clerk/clerk-js` to your project, use v4.18.0 or later.
+1. In your codebase, upgrade `@clerk/react` to v4.4.5 or later. If your are importing `@clerk/clerk-js` to your project, use v4.18.0 or later.


Will the package rename be backwards compatible, where it can pick up older versions even though the new package name didn't exist until later?

Yeah this one is tricky. @clerk/clerk-react will cap out in the 5.0.0 version range, and @clerk/react will start with version 6.0.0. Maybe something like this?

In your codebase, upgrade @clerk/clerk-react to v4.4.5 or later, or migrate to @clerk/react.

I like that suggestion.

Similar wording may also be needed in:

docs/_partials/reverification-callout.mdx

docs/guides/development/local-credentials.mdx

manovotny · 2025-11-17T23:45:51Z

docs/getting-started/quickstart.expo.mdx

-    bun add @clerk/clerk-expo
+    bun add @clerk/expo
    ```
  </CodeBlockTabs>


You can replace all of CodeBlockTabs with the following and it will automatically create yarn, pnpm, and bun commands.

```npm npm install @clerk/expo ```

Should I do that refactor in this PR though? It seems like that'd be a bigger docs-wide effort. Happy to update the blocks I'm touching though.

Hmm, just seeing this. I merged this PR recently to update the blocks to the new markdown, but it seems like I missed a couple of ones. I'll make those fixes in a diff PR so don't worry about it @dstaley - we can merge mine first, and then yours.

PR here: #2809

All merged now! @dstaley

docs/getting-started/quickstart.react.mdx

SarahSoutoul · 2025-11-18T17:49:11Z

This looks good to me! Only thing to say is it seems the @clerk/clerk-react package is used a lot in our typedoc output, so we prob need a JS PR accompanying this.

dstaley · 2025-11-18T17:55:27Z

we prob need a JS PR accompanying this

We've made the required changes in the Core 3 branch over in javascript already, but yeah we'll need to coordinate a specific merge order for the various branches to make sure everything settles into the correct state.

github-actions · 2025-11-18T18:44:47Z

⚠️ TypeDoc files detected in this PR

This PR modifies files in the 'clerk-typedoc/' folder. These files are auto-generated from the clerk/javascript repository and should not be edited directly.

To make changes to TypeDoc documentation:

🔄 Make your changes in the appropriate files in the clerk/javascript repository.
🚀 The TypeDoc documentation will be pulled through to this repository via a CI action.

Thanks for contributing! 🙏

SarahSoutoul · 2025-11-18T19:06:15Z

Seems like some clerk-typedoc changes got included by mistake here. Working on fixing this rn.

This reverts commit 1df53b2, reversing changes made to 7158d31.

SarahSoutoul · 2025-11-18T19:50:18Z

Sorry about that @dstaley - a bit of a messy git issue. But all fixed now.

…o-pkg

SarahSoutoul · 2025-11-19T15:27:35Z

@dstaley I merged this PR: #2649, which involved bringing in code examples for all hooks, so have pushed two commits here to make the changes on those:

Make the change on the new hooks code examples - for react
Make the change on the new hooks code examples for expo - for expo

SarahSoutoul · 2025-11-19T15:30:15Z

we prob need a JS PR accompanying this

We've made the required changes in the Core 3 branch over in javascript already, but yeah we'll need to coordinate a specific merge order for the various branches to make sure everything settles into the correct state.

Actually, the code examples are now written directly into the docs for hooks, so there might be less changes involved on the javascript repo than expected.

Co-authored-by: Sarah Soutoul <sarah@clerk.dev>

dstaley requested a review from a team as a code owner November 17, 2025 18:28

manovotny reviewed Nov 17, 2025

View reviewed changes

docs/getting-started/quickstart.react.mdx Outdated Show resolved Hide resolved

vercel bot deployed to Preview November 18, 2025 18:45 View deployment

vercel bot deployed to Preview November 18, 2025 19:17 View deployment

SarahSoutoul and others added 4 commits November 18, 2025 13:22

Rename @clerk/clerk-expo to @clerk/expo

7f05dae

Rename @clerk/clerk-react to @clerk/react

98e8b7a

Revert "Merge branch 'main' into ds.core-3/react-expo-pkg"

c344ab4

This reverts commit 1df53b2, reversing changes made to 7158d31.

Fix: restore typedoc shared files from core-3

2289c6a

SarahSoutoul force-pushed the ds.core-3/react-expo-pkg branch from 2d10f0c to 2289c6a Compare November 18, 2025 19:28

vercel bot deployed to Preview November 18, 2025 19:29 View deployment

Remove unwanted changes

7b83355

vercel bot deployed to Preview November 18, 2025 19:36 View deployment

Remove unwanted changes

76987d3

vercel bot deployed to Preview November 18, 2025 19:39 View deployment

Cleaning up

c96661f

vercel bot deployed to Preview November 18, 2025 19:41 View deployment

Cleaning up

17c8bf8

vercel bot deployed to Preview November 18, 2025 19:44 View deployment

Bring back quickstart expo and react changes

d68e731

vercel bot deployed to Preview November 18, 2025 19:50 View deployment

SarahSoutoul approved these changes Nov 18, 2025

View reviewed changes

Merge remote-tracking branch 'origin/core-3' into ds.core-3/react-exp…

578bde0

…o-pkg

vercel bot had a problem deploying to Preview November 19, 2025 15:20 Failure

SarahSoutoul added 2 commits November 19, 2025 09:24

Make the change on the new hooks code examples

97ea06d

Make the change on the new hooks code examples for expo

65917a4

vercel bot deployed to Preview November 19, 2025 15:38 View deployment

Be more explicit about versions

3cee6d0

vercel bot deployed to Preview November 19, 2025 16:48 View deployment

Fix package name

8c0b029

vercel bot deployed to Preview November 19, 2025 16:50 View deployment

Fix package name

2aa0b3b

vercel bot deployed to Preview November 19, 2025 16:51 View deployment

dstaley merged commit 05eff56 into core-3 Nov 19, 2025
1 check passed

dstaley deleted the ds.core-3/react-expo-pkg branch November 19, 2025 16:59

alexcarpenter pushed a commit that referenced this pull request Jan 20, 2026

Rename Expo and React packages (#2801)

a41b6cb

Co-authored-by: Sarah Soutoul <sarah@clerk.dev>

Conversation

dstaley commented Nov 17, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🔎 Previews:

What does this solve?

What changed?

Checklist

Uh oh!

vercel bot commented Nov 17, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

SarahSoutoul Nov 18, 2025 • 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!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

SarahSoutoul commented Nov 18, 2025

Uh oh!

dstaley commented Nov 18, 2025

Uh oh!

github-actions bot commented Nov 18, 2025

Uh oh!

SarahSoutoul commented Nov 18, 2025

Uh oh!

SarahSoutoul commented Nov 18, 2025

Uh oh!

SarahSoutoul commented Nov 19, 2025

Uh oh!

SarahSoutoul commented Nov 19, 2025

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

dstaley commented Nov 17, 2025 •

edited

Loading

vercel bot commented Nov 17, 2025 •

edited

Loading

SarahSoutoul Nov 18, 2025 •

edited

Loading