[juliusmarminge]

🔎 Previews:

• /docs/reference/expo/native-components/auth-view
• /docs/reference/expo/native-components/user-profile-view

What does this solve? What changed?

• On iOS, the host back button on <AuthView /> and <UserProfileView /> now pops the native navigation screen that contains the component, and onHostBack only runs when there is no screen to pop, such as when the component is the stack's root screen or is presented in a modal. Android still always runs onHostBack. Source change: clerk/javascript#10271.
• Updated the "navigation stack" guidance and the onHostBack prop descriptions on both pages to say when the callback runs, and to dismiss a modal (not only pop a route) from it.

Deadline

• No rush. Should ship alongside clerk/javascript#10271.

Other resources

• Requested in CodeRabbit review on clerk/javascript#10271.

Prepared with Claude Opus 5.5 through Claude Code on behalf of @juliusmarminge.

🤖 Generated with Claude Code

[github-actions]

Thanks for contributing! A quick heads-up on how external contributions work: Clerk's docs are maintained in Clerk's internal monorepo, and this public repo is its read-only mirror — nothing merges here directly, and there are no preview deployments on this repo. Nothing is needed from you. A Clerk maintainer will review this PR, and if it's accepted, they'll bring your change into the monorepo with your commits and authorship preserved — it then goes live on clerk.com/docs shortly after. See Contributing to Clerk's documentation for the full picture.

The failing Block merges check on this PR is expected — merging is disabled in this repo on purpose.

[SarahSoutoul]

Thanks for the contribution @juliusmarminge! Converted the PR to draft while waiting on a decision around merging this or not. Our engineers are currently discussing the change and seeing if it's sth they'd want implemented, so this will be reviewed if we do go ahead.