Skip to content

Conversation

@wobsoriano
Copy link
Member

@wobsoriano wobsoriano commented Mar 11, 2025

Description

TanStack Router/Start has renamed its packages from @tanstack/router and @tanstack/start to @tanstack/react-router and @tanstack/react-start following the release of their Solid.js (@tanstack/solid-router) package.

We have already migrated internally to using @tanstack/react-start here, but to avoid potential confusion, we'd also like to rename our package to @clerk/tanstack-react-start to clearly indicate that this is specifically for the React package.

Resolves ECO-502

Checklist

  • pnpm test runs as expected.
  • pnpm build runs as expected.
  • (If applicable) JSDoc comments have been added or updated for any package exports
  • (If applicable) Documentation has been updated

Type of change

  • 🐛 Bug fix
  • 🌟 New feature
  • 🔨 Breaking change
  • 📖 Refactoring / dependency upgrade / documentation
  • other:

@vercel
Copy link

vercel bot commented Mar 11, 2025

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name Status Preview Comments Updated (UTC)
clerk-js-sandbox ✅ Ready (Inspect) Visit Preview 💬 Add feedback Mar 12, 2025 6:52pm

@changeset-bot
Copy link

changeset-bot bot commented Mar 11, 2025

🦋 Changeset detected

Latest commit: 9ab2607

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

This PR includes changesets to release 1 package
Name Type
@clerk/tanstack-start 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

@wobsoriano wobsoriano changed the title chore(tanstack-start): Add console warning for upcoming package renaming chore(tanstack-start): Add warning for upcoming package renaming Mar 11, 2025
'@clerk/tanstack-start': patch
---

Added a warning message to help prepare for an upcoming package rename. We'll be changing from `@clerk/tanstack-start` to `@clerk/tanstack-react-start` in the next minor version to better align with TanStack Start's new package naming convention. No newline at end of file
Copy link
Member Author

Choose a reason for hiding this comment

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

I think we should rename the package now before the stable release to take advantage of the beta period flexibility


export const warnPackageRenaming = () => {
console.warn(
'[@clerk/tanstack-start] Warning: This package will be renamed to @clerk/tanstack-react-start in the next minor version. Please stay tuned for the release to update your imports accordingly.',
Copy link
Contributor

Choose a reason for hiding this comment

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

I don't like that this is not actionable for a user. Here's what I had in mind:

  1. Rename the package locally and bump the minor
  2. Publish this new package locally so that it exists on npm
  3. Add this warning here with actionable steps for people to migrate (this also includes changing the README of this package
  4. Publish it
  5. Rename the package in this repo here

This way people can immediately migrate without having to wait

Copy link
Member Author

@wobsoriano wobsoriano Mar 12, 2025

Choose a reason for hiding this comment

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

Thanks for sharing your idea! I like this, and we just published a snapshot of @clerk/tanstack-react-start to NPM. We can proceed with the updated warning message 🫡

Copy link
Member Author

Choose a reason for hiding this comment

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

After this gets merged and published, I'll open this PR that will add @clerk/tanstack-start to ignored packages of changesets

@wobsoriano wobsoriano marked this pull request as draft March 12, 2025 14:21
@wobsoriano wobsoriano changed the title chore(tanstack-start): Add warning for upcoming package renaming chore(tanstack-start): Add deprecation warning for package renaming Mar 12, 2025
@wobsoriano wobsoriano marked this pull request as ready for review March 12, 2025 18:47
@wobsoriano wobsoriano merged commit 3e8bfa2 into main Mar 13, 2025
30 checks passed
@wobsoriano wobsoriano deleted the rob/eco-502-add-message-warning-for-upcoming-package-renaming branch March 13, 2025 14:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants