fix(upgrade): Add missing Core 3 upgrade guide entries

[jacekradko]

Summary

• Cross-referenced all 43 changeset files containing major version bumps against the 35 existing Core 3 upgrade guide entries
• Added 7 missing upgrade guide entries for breaking changes that had no corresponding documentation:
  • gettoken-ssr-throws.md — useAuth().getToken no longer undefined during SSR, now throws
  • react-router-require-middleware.md — rootAuthLoader requires clerkMiddleware() installed
  • expo-publishable-key-required.md — publishableKey prop now required in Expo ClerkProvider
  • astro-as-prop-removed.md — as prop removed from Astro button components, use asChild
  • simple-theme-usage-changed.md — simple theme no longer exported from @clerk/ui
  • react-router-api-server-removed.md — @clerk/react-router/api.server removed
  • nextjs-min-version.md — Next.js 13/14 support dropped, requires >=15.2.3

Test plan

• pnpm --filter @clerk/upgrade build passes
• pnpm --filter @clerk/upgrade test passes (231 tests)
• Verify entries render correctly in the upgrade CLI via npx @clerk/upgrade --release core-3

Summary by CodeRabbit

• Documentation

  • Added comprehensive Core 3 upgrade guides documenting breaking changes across Astro, Expo, getToken SSR behavior, Next.js minimum version requirements, React Router APIs, middleware requirements, and theme usage.

• Chores

  • Added changeset for patch release preparation.

[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 19, 2026 8:14pm

[changeset-bot]

🦋 Changeset detected

Latest commit: bbf5208

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

This PR includes changesets to release 1 package

Name	Type
@clerk/upgrade	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

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

---

📝 Walkthrough

Walkthrough

This pull request adds documentation files for the Clerk Core 3 upgrade guide, including a changeset file and seven breaking-change guides covering: Astro component prop removal, Expo publishable key requirement, getToken SSR behavior changes, Next.js minimum version bump to 15.2.3, React Router API path consolidation, React Router middleware requirement, and simple theme export changes. These are declarative, documentation-only updates with no code modifications to the main package logic.

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly and specifically describes the main change: adding missing Core 3 upgrade guide documentation entries.
Linked Issues check	✅ Passed	The PR adds seven missing Core 3 upgrade guide entries documenting intentional breaking changes, aligning with the CORE-3 issue objective to document that changes are intentional.
Out of Scope Changes check	✅ Passed	All changes are within scope: the PR adds documentation files for Core 3 breaking changes with no unrelated modifications.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

---

_{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@7888

@clerk/astro

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

@clerk/backend

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

@clerk/chrome-extension

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

@clerk/clerk-js

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

@clerk/dev-cli

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

@clerk/expo

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

@clerk/expo-passkeys

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

@clerk/express

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

@clerk/fastify

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

@clerk/hono

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

@clerk/localizations

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

@clerk/nextjs

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

@clerk/nuxt

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

@clerk/react

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

@clerk/react-router

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

@clerk/shared

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

@clerk/tanstack-react-start

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

@clerk/testing

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

@clerk/ui

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

@clerk/upgrade

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

@clerk/vue

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

commit: bbf5208