Update reverification docs

[alexisintech]

🔎 Previews:

• https://clerk.com/docs/pr/aa-update-reverification/nextjs/reference/hooks/use-reverification
• https://clerk.com/docs/pr/aa-update-reverification/guides/secure/reverification

What does this solve?

While working on the update-password custom flow, I noticed the reverification docs were incorrect. The isReverificationCancelledError was being imported from clerk/shared, which users are advised against doing per this Slack discussion. This was incorrect anyways, because it's re-exported from the appropriate SDK's, so importing from clerk/shared wasn't necessary. Also, drops support for Expo as it does not support the useReverification() hook opening a modal (talked with Mike to add reverification work to the mobile team's radar).

What changed?

docs/reference/hooks/use-reverification.mdx:

• Drops the redundant isClerkRuntimeError(e) && guard from cancellation checks — isReverificationCancelledError already narrows correctly on its own, matching the canonical usage in the useReverification JSDoc in clerk/javascript.
• Switches react-router and tanstack-react-start examples from importing isReverificationCancelledError out of @clerk/shared to the SDK's own /errors subpath (@clerk/react-router/errors, @clerk/tanstack-react-start/errors), aligning them with the react and nextjs examples.
• Removes the cancellation import and catch branch from the chrome-extension examples, since @clerk/chrome-extension does not expose an ./errors subpath export.
• (Collaborated with @mikepitre on this): Removes Expo support since useReverification() doesn't open the modal on native Expo.

docs/guides/secure/reverification.mdx:

• Restructures the "How to require reverification" section in a more guiding manner with setting up the server-side first, then the client-side. It adds notes about adapting to other frameworks, with Ruby branched off via <If sdk="ruby">. It adds an <If sdk="nextjs" wrapper around an example for performing reverification in Server Actions.
• Tightens copy throughout and points readers at the reference doc for the comprehensive useReverification() examples instead of duplicating them.

docs/reference/ruby/overview.mdx:

• Adds a "See the Reverification guide for detailed usage examples" pointer under the reverification section so the Ruby reference cross-links to the rewritten guide.

Deadline

• No rush.

Other resources

Relevant Slack conversation regarding error helpers

[vercel]

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

Project	Deployment	Actions	Updated (UTC)
clerk-docs	Ready	Preview	Jun 11, 2026 9:14pm

[SarahSoutoul]

@alexisintech just checking, this is ready for review? It's still in draft but got a review request email.

[alexisintech]

@alexisintech just checking, this is ready for review? It's still in draft but got a review request email.

i reverted it to draft - its waiting on some expo stuff

[alexisintech]

follow up from the mobile team on the expo stuff:

[alexisintech]

Pushed some changes directly in 51fe646.

• API route example: return new NextResponse({ success: true }) was passing a plain object to the Response constructor (which only accepts BodyInit) — switched to NextResponse.json({ success: true }) so the example actually returns JSON.
• Dropped the unused req: NextRequest parameter and trimmed the matching import.
• Fixed the prose pointing at the route: /reverification-example → /api/reverification-example so it matches the actual served path and what transferMoney fetches.
• Rewrote the Ruby example to use the helpers clerk-sdk-ruby actually exports — require_reverification! with Clerk::StepUp::Preset::MODERATE — instead of clerk_render_reverification / Clerk::StepUp::PRESETS[:moderate], which don't exist on the current SDK. This also brings the constant style in line with the docs/reference/ruby/overview.mdx changes elsewhere in this PR.
• Renamed the Ruby-branch transfer example from src/pages/transfer.tsx + TransferMoney (Pages-Router-looking path with a mismatched component name) to src/components/TransferButton.tsx + TransferButton, so the file path, package (@clerk/react), and export all match.