Skip to content

Conversation

@jacekradko
Copy link
Member

@jacekradko jacekradko commented Dec 11, 2025

Summary

  • Adds comprehensive Core 3 upgrade guide covering all 8 SDKs
  • Restructured with global changes outside SDK tabs to eliminate duplication
  • SDK-specific tabs only contain changes unique to each SDK

Structure

Global Sections (apply to all SDKs)

  • Breaking Changes (8 items): Protect→Show, package renames, appearance changes, checkout API, etc.
  • Deprecation Removals (11 items): redirect props, SAML→enterprise_sso renames, etc.
  • Deprecations: @clerk/types@clerk/shared/types
  • Version Requirements: Node.js 20.9.0+
  • Behavior Changes: showOptionalFields default, ClerkAPIError.kind

SDK-Specific Tabs

SDK Changes
Next.js Encryption key for runtime secretKey, ClerkProvider positioning
Expo Package rename, Clerk export removed, min Expo 53
Nuxt getAuth() removed, routing strategy default
React, Vue, Astro, React Router, TanStack Start No SDK-specific changes

Preview

https://clerk.com/docs/pr/core-3-nextjs-guide-update/guides/development/upgrading/upgrade-guides/core-3

@vercel
Copy link

vercel bot commented Dec 11, 2025

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

Project Deployment Review Updated (UTC)
clerk-docs Ready Ready Preview Jan 26, 2026 7:28pm

Request Review

Added placeholder tabs for React, Expo, React Router, TanStack Start,
Astro, Nuxt, and Vue. Each tab includes version info and a note that
the guide is under construction.
- Move all global breaking changes to main section (applies to all SDKs)
- Move deprecation removals, deprecations, version requirements, and
  behavior changes to dedicated sections outside tabs
- Add Protect/SignedIn/SignedOut → Show migration (was missing)
- Add ClerkAPIError.kind behavior change (was missing)
- SDK tabs now only contain SDK-specific changes:
  - Next.js: encryption key, ClerkProvider positioning
  - Expo: package rename, Clerk export removal, min version
  - Nuxt: getAuth removal, routing strategy default
  - React, Vue, Astro, React Router, TanStack Start: no SDK-specific changes
@jacekradko jacekradko changed the title feat: core-3 nextjs guide feat: Core 3 upgrade guide for all SDKs Jan 26, 2026
@jacekradko jacekradko marked this pull request as ready for review January 26, 2026 13:50
@jacekradko jacekradko requested a review from a team as a code owner January 26, 2026 13:50
</AccordionPanel>
</Accordion>

## Deprecation Removals
Copy link
Contributor

Choose a reason for hiding this comment

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

Why not use the AccordionPanel component for the rest of this as well? @jacekradko

Comment on lines +167 to +173
```diff
- experimental__someMethod
+ __experimental_someMethod

- experimental_someMethod
+ __experimental_someMethod
```
Copy link
Contributor

Choose a reason for hiding this comment

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

This feels like a duplication? @jacekradko

@SarahSoutoul
Copy link
Contributor

@jacekradko left a docs review + comments. Let me know thoughts!

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.

3 participants