feat(upgrade): add --canary flag to target canary SDK versions

[jacekradko]

Summary

• Adds a --canary flag to @clerk/upgrade that installs the latest canary version from npm instead of the stable major version
• When --canary is used, the upgrade proceeds even if the user is already on the target major version (e.g., on stable v7, upgrading to canary v7)
• Works with all package managers (pnpm, yarn, npm, bun) via the canary dist-tag

Usage

npx @clerk/upgrade --canary
npx @clerk/upgrade --canary --dry-run
npx @clerk/upgrade --sdk=nextjs --canary

Test plan

• Existing CLI integration tests pass (23/23)
• New test: --canary --dry-run shows canary version in output
• New test: --canary allows upgrade when already on target major version
• Manual: run npx @clerk/upgrade --canary --dry-run against a project with a Clerk SDK

[vercel]

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

Project	Deployment	Actions	Updated (UTC)
clerk-js-sandbox	Ready	Preview, Comment	Feb 17, 2026 8:17pm

[changeset-bot]

🦋 Changeset detected

Latest commit: 1c11063

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

This PR includes changesets to release 0 packages

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

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

[coderabbitai]

Caution

Review failed

The head commit changed during the review from ac2f48a to 1c11063.

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[pkg-pr-new]

Open in StackBlitz

@clerk/agent-toolkit

npm i https://pkg.pr.new/@clerk/agent-toolkit@7866

@clerk/astro

npm i https://pkg.pr.new/@clerk/astro@7866

@clerk/backend

npm i https://pkg.pr.new/@clerk/backend@7866

@clerk/chrome-extension

npm i https://pkg.pr.new/@clerk/chrome-extension@7866

@clerk/clerk-js

npm i https://pkg.pr.new/@clerk/clerk-js@7866

@clerk/dev-cli

npm i https://pkg.pr.new/@clerk/dev-cli@7866

@clerk/expo

npm i https://pkg.pr.new/@clerk/expo@7866

@clerk/expo-passkeys

npm i https://pkg.pr.new/@clerk/expo-passkeys@7866

@clerk/express

npm i https://pkg.pr.new/@clerk/express@7866

@clerk/fastify

npm i https://pkg.pr.new/@clerk/fastify@7866

@clerk/hono

npm i https://pkg.pr.new/@clerk/hono@7866

@clerk/localizations

npm i https://pkg.pr.new/@clerk/localizations@7866

@clerk/nextjs

npm i https://pkg.pr.new/@clerk/nextjs@7866

@clerk/nuxt

npm i https://pkg.pr.new/@clerk/nuxt@7866

@clerk/react

npm i https://pkg.pr.new/@clerk/react@7866

@clerk/react-router

npm i https://pkg.pr.new/@clerk/react-router@7866

@clerk/shared

npm i https://pkg.pr.new/@clerk/shared@7866

@clerk/tanstack-react-start

npm i https://pkg.pr.new/@clerk/tanstack-react-start@7866

@clerk/testing

npm i https://pkg.pr.new/@clerk/testing@7866

@clerk/ui

npm i https://pkg.pr.new/@clerk/ui@7866

@clerk/upgrade

npm i https://pkg.pr.new/@clerk/upgrade@7866

@clerk/vue

npm i https://pkg.pr.new/@clerk/vue@7866

commit: 1c11063