-
Notifications
You must be signed in to change notification settings - Fork 961
feat: Core 3 upgrade guide for all SDKs #2879
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
base: core-3
Are you sure you want to change the base?
Conversation
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
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
| </AccordionPanel> | ||
| </Accordion> | ||
|
|
||
| ## Deprecation Removals |
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.
Why not use the AccordionPanel component for the rest of this as well? @jacekradko
| ```diff | ||
| - experimental__someMethod | ||
| + __experimental_someMethod | ||
|
|
||
| - experimental_someMethod | ||
| + __experimental_someMethod | ||
| ``` |
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.
This feels like a duplication? @jacekradko
|
@jacekradko left a docs review + comments. Let me know thoughts! |
Summary
Structure
Global Sections (apply to all SDKs)
@clerk/types→@clerk/shared/typesshowOptionalFieldsdefault,ClerkAPIError.kindSDK-Specific Tabs
secretKey, ClerkProvider positioningClerkexport removed, min Expo 53getAuth()removed, routing strategy defaultPreview
https://clerk.com/docs/pr/core-3-nextjs-guide-update/guides/development/upgrading/upgrade-guides/core-3