Skip to content

Add docs for React Native components release#3137

Merged
chriscanin merged 183 commits intomainfrom
chris/mobile-405-react-native-components-release
Mar 9, 2026
Merged

Add docs for React Native components release#3137
chriscanin merged 183 commits intomainfrom
chris/mobile-405-react-native-components-release

Conversation

@chriscanin
Copy link
Copy Markdown
Member

@chriscanin chriscanin commented Feb 25, 2026

Notion doc with tracking of bugs: https://www.notion.so/clerkdev/Expo-Core-3-reviewing-31a2b9ab44fe8062b4f7e57721dfbe04

🔎 Previews:

What does this solve? What changed?

  • @clerk/expo now supports three integration approaches: JS-only custom flows, JS + native OAuth buttons, and full native SDK components. The docs need to reflect this.
  • Rewrote the Expo quickstart with a three-tab structure (JavaScript / JS + Native Sign-In / Native Components) — each tab has its own setup steps, code examples, and links to the corresponding quickstart repo. All code uses the Core-3 Signal API.
  • Added 4 native component reference docs: <AuthView />, <UserButton /> (Native), <UserProfileView />, and a Native Components Overview page. Verified all documented props match the TypeScript types and added missing props (presentation, onDismiss, style).
  • Cherry-picked Google Sign-In docs (useSignInWithGoogle() reference, example partial, and Expo guide) from chris/mobile-289-expo-google-universal-sign-in-core-3 and added the manifest entry.
  • Reorganized the Expo SDK overview to group resources by approach: Native Components → Native Sign-In Hooks → Expo-specific Hooks → React Hooks → Control Components → Web Components.
  • Added approach-awareness callout notes to 5 existing guides (email-password custom flow, OAuth connections, Sign in with Apple, Sign in with Google, Expo deployment) so users know when native components handle things automatically.
  • Fixed all build warnings — broken hash links, missing partial inlined.
  • Source code PR: feat(expo): Chris/mobile 405 react native components release javascript#7843

Deadline

  • Ships with the @clerk/expo native components release - end of week.

Other resources

dstaley and others added 30 commits November 19, 2025 10:59
Co-authored-by: Sarah Soutoul <sarah@clerk.dev>
Co-authored-by: Alexis Aguilar <98043211+alexisintech@users.noreply.github.com>
)

Co-authored-by: Alexis Aguilar <98043211+alexisintech@users.noreply.github.com>
Co-authored-by: Alexis Aguilar <98043211+alexisintech@users.noreply.github.com>
The default Expo template includes react-native-reanimated which has a
known Android build issue with react-native-worklets. Since the template
doesn't actually use reanimated, instruct users to remove it to avoid
build errors.
The default tabs template includes react-native-reanimated which has
a build ordering bug on Android. Using the blank template avoids this
entirely and is cleaner for a quickstart.
The default Expo template includes react-native-reanimated which has
a known Android build issue. Add instructions to uninstall it and
remove the import during the template cleanup step. Also remove the
unused components/ directory. Revert create-new-expo-app back to the
default template since it includes expo-router.
Add documentation explaining that social connections (Google, Apple)
require native application credentials to work with <AuthView />.
Without these, OAuth buttons appear but fail with an error.

- Add "Configure social connections" step to Native Components quickstart
- Add OAuth configuration section to AuthView reference
- Add social connections note to Native Components overview requirements
Copy link
Copy Markdown
Contributor

@SarahSoutoul SarahSoutoul left a comment

Choose a reason for hiding this comment

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

Alright, I think we're good to go. Before merging this, please make sure the quickstarts are all merged in and linked properly in the docs.

@chriscanin
Copy link
Copy Markdown
Member Author

@SarahSoutoul The links in the docs are now working:
image

@chriscanin chriscanin merged commit feedf7d into main Mar 9, 2026
8 checks passed
@chriscanin chriscanin deleted the chris/mobile-405-react-native-components-release branch March 9, 2026 21:24
SarahSoutoul added a commit to ivancernja/clerk-docs that referenced this pull request Mar 23, 2026
Co-authored-by: Dylan Staley <88163+dstaley@users.noreply.github.com>
Co-authored-by: Sarah Soutoul <sarah@clerk.dev>
Co-authored-by: Jacek <jacek@clerk.dev>
Co-authored-by: Bryce Kalow <bryce@clerk.dev>
Co-authored-by: Alexis Aguilar <98043211+alexisintech@users.noreply.github.com>
Co-authored-by: Alex Carpenter <im.alexcarpenter@gmail.com>
Co-authored-by: Nick Wylynko <nickwylynko@clerk.dev>
Co-authored-by: Nikos Douvlis <nikosdouvlis@gmail.com>
Co-authored-by: Cursor Agent <cursoragent@cursor.com>
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
Co-authored-by: Michael Novotny <manovotny@gmail.com>
Co-authored-by: Alex Carpenter <alex.carpenter@clerk.dev>
Co-authored-by: Vaggelis Yfantis <me@octoper.me>
Co-authored-by: Warp <agent@warp.dev>
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Co-authored-by: Sam Wolfand <sam@clerk.dev>
Co-authored-by: seanperez <sean@clerk.dev>
Co-authored-by: Alex Bratsos <alexisbratsos@gmail.com>
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.