Skip to content

Conversation

@dstaley
Copy link
Member

@dstaley dstaley commented Nov 17, 2025

🔎 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

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

vercel bot commented Nov 17, 2025

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

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


```npm
npm install @clerk/clerk-expo@latest
npm install @clerk/clerk-expo@^2
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This can be left as latest, right?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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 😅

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.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I like that suggestion.

Similar wording may also be needed in:

bun add @clerk/clerk-expo
bun add @clerk/expo
```
</CodeBlockTabs>
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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

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

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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.

Copy link
Contributor

@SarahSoutoul SarahSoutoul Nov 18, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

PR here: #2809

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

All merged now! @dstaley

@SarahSoutoul
Copy link
Contributor

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.

Screenshot 2025-11-18 at 11 48 21 am

@dstaley
Copy link
Member Author

dstaley commented Nov 18, 2025

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
Copy link
Contributor

⚠️ 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:

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

Thanks for contributing! 🙏

@SarahSoutoul
Copy link
Contributor

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

@SarahSoutoul
Copy link
Contributor

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

@SarahSoutoul
Copy link
Contributor

@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:

@SarahSoutoul
Copy link
Contributor

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.

@dstaley dstaley merged commit 05eff56 into core-3 Nov 19, 2025
1 check passed
@dstaley dstaley deleted the ds.core-3/react-expo-pkg branch November 19, 2025 16:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants