-
Notifications
You must be signed in to change notification settings - Fork 402
chore(tanstack-start): Add deprecation warning for package renaming #5327
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
chore(tanstack-start): Add deprecation warning for package renaming #5327
Conversation
|
The latest updates on your projects. Learn more about Vercel for Git ↗︎
|
🦋 Changeset detectedLatest commit: 9ab2607 The changes in this PR will be included in the next version bump. This PR includes changesets to release 1 package
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 |
.changeset/cuddly-cups-sip.md
Outdated
| '@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 |
There was a problem hiding this comment.
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
…-package-renaming
|
|
||
| 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.', |
There was a problem hiding this comment.
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:
- Rename the package locally and bump the minor
- Publish this new package locally so that it exists on npm
- Add this warning here with actionable steps for people to migrate (this also includes changing the README of this package
- Publish it
- Rename the package in this repo here
This way people can immediately migrate without having to wait
There was a problem hiding this comment.
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 🫡
There was a problem hiding this comment.
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
…-package-renaming
Description
TanStack Router/Start has renamed its packages from
@tanstack/routerand@tanstack/startto@tanstack/react-routerand@tanstack/react-startfollowing the release of their Solid.js (@tanstack/solid-router) package.We have already migrated internally to using
@tanstack/react-starthere, but to avoid potential confusion, we'd also like to rename our package to@clerk/tanstack-react-startto clearly indicate that this is specifically for the React package.Resolves ECO-502
Checklist
pnpm testruns as expected.pnpm buildruns as expected.Type of change