Add heading prop support and improve mobile SDK scoping #2992

manovotny · 2026-01-21T04:40:04Z

Warning

Depends on https://github.com/clerk/clerk/pull/2018, which must be merged first.

Previews

What does this solve?

Fixes a copy-paste error in the manifest where Android User Management incorrectly linked to the iOS documentation path
Improves SDK scoping logic to properly handle cases where groups have explicit SDK restrictions (e.g., Mobile Navigation should only appear for ios/android)
Adds support for manifest headings with optional SDK scoping via the new ManifestHeading type

What changed?

docs/manifest.json: Fixed Android link and added Mobile Navigation section for iOS/Android with new heading-based structure
scripts/build-docs.ts: Refined SDK computation to include frontmatter SDK variants and clarified SDK precedence logic
scripts/lib/manifest.ts: Added ManifestHeading type to support section headings with SDK scoping
Docs content: Removed Android-specific passkey references and updated Apple sign-in SDK conditionals to reflect mobile navigation restructure

Adds a new ManifestHeading type to support items with `heading: true` that act as section headers without an href. Also fixes SDK filtering errors by removing android/ios conditionals from pages under the Guides section which doesn't include those SDKs. Co-Authored-By: Claude Opus 4.5 <[email protected]>

- Fix copy-paste error: Android User Management now correctly links to /docs/reference/android/user instead of iOS path - Add frontmatter SDK to SDK computation for manifest items to better reflect document capabilities - Clarify SDK scoping precedence: explicit group SDK restrictions are now preserved even if children support more SDKs - Update comments to explain SDK logic for cases like Mobile Navigation section

vercel · 2026-01-21T04:40:09Z

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

Project	Deployment	Actions	Updated (UTC)
clerk-docs	Ready	Preview	Feb 3, 2026 6:02pm

- Add iOS reference docs from mike/ios-v1-docs branch: auth, clerk, configuration, installation, organizations, user - Add Android auth.mdx from sam/android-v1-auth-reference branch - Create docs/reference/android/todo.mdx placeholder for missing Android docs - Update manifest to point missing Android docs to the todo placeholder

- Add iOS quickstart guide - Update 12 custom flow guides with iOS support - Update reference view docs (auth-view, user-button, user-profile-view) - Update iOS overview and remove deprecated get-token.mdx - Update manifest: remove iOS getToken entry, point Android auth to todo placeholder

- Add installation.mdx with Gradle setup instructions - Add configuration.mdx with Clerk.initialize() pattern - Add clerk.mdx with reactive state flows (Clerk.userFlow, Clerk.isInitialized) - Add user.mdx for user management methods - Add organizations.mdx for organization management - Update auth.mdx to use Clerk.auth (uppercase) consistently - Update manifest.json to point to new Android reference pages Co-Authored-By: Claude Opus 4.5 <[email protected]>

Co-Authored-By: Claude Opus 4.5 <[email protected]>

SarahSoutoul · 2026-02-01T01:09:50Z

@mikepitre @swolfand

Have pushed a final docs review after reviewing more closely the content. That review mostly focuses on consistency when comparing the different variants (iOS vs Android).

One thing I did notice is that for the auth docs, there are inconsistencies around these two sections (android vs iOS). I wanted to double check with you both on whether that is intentional or should be fixed.

Also left a separate comment for you @swolfand here: #2992 (comment).

Tagging you @manovotny @alexisintech for visibility.

docs/guides/ios/watch-connectivity.mdx

docs/reference/native-sdks/configuration.ios.mdx

SarahSoutoul · 2026-01-29T19:26:46Z

docs/guides/configure/auth-strategies/sign-up-sign-in-options.mdx


 **Users can only create passkeys after signing up**, so you'll need to enable another authentication strategy for the sign-up process. After signing in, users can create a passkey.

-<If sdk="android">


Done here @alexisintech: Make android callout a note rather than if component

SarahSoutoul · 2026-01-29T19:36:46Z

docs/guides/configure/auth-strategies/sign-up-sign-in-options.mdx


 **Users can only create passkeys after signing up**, so you'll need to enable another authentication strategy for the sign-up process. After signing in, users can create a passkey.

-<If sdk="android">


And did the same for the social connections apple guide: Refinements

SarahSoutoul · 2026-01-31T19:10:37Z

docs/reference/native-sdks/installation.mdx

+```kotlin
+dependencies {
+    // For prebuilt UI components (includes API)
+    implementation("com.clerk:clerk-android-ui:1.0.0")
+
+    // Or for API only (no UI)
+    implementation("com.clerk:clerk-android-api:1.0.0")
+}


Two things on this @swolfand:

In the quickstart, we also import the Lifecycle ViewModel Compose Library: implementation("androidx.lifecycle:lifecycle-viewmodel-compose:2.9.2"). Is it needed here too?

The version for both of these imports is 1.0.0, but that might change no? Do we want to have <latest-version> instead like we do in the Quickstart?

for the first I think this is just installation of the clerk sdks, not doing the quickstart,

Yes! will change

For the dependencies change @swolfand, I meant to change the dependency to latest-version on the installation guide. And on the upgrade guide, leave it as 1.0.0 as we're on the v1 upgrade guide. Made a commit to make those changes.

mikepitre · 2026-02-01T17:24:45Z

@mikepitre @swolfand

Have pushed a final docs review after reviewing more closely the content. That review mostly focuses on consistency when comparing the different variants (iOS vs Android).

One thing I did notice is that for the auth docs, there are inconsistencies around these two sections (android vs iOS). I wanted to double check with you both on whether that is intentional or should be fixed.

Also left a separate comment for you @swolfand here: #2992 (comment).

Tagging you @manovotny @alexisintech for visibility.

Ah good catch @SarahSoutoul! Sam's is correct here. I'll get iOS updated to match.

manovotny and others added 2 commits January 20, 2026 16:42

vercel bot had a problem deploying to Preview January 21, 2026 04:40 Failure

vercel bot deployed to Preview January 21, 2026 04:51 View deployment

vercel bot deployed to Preview January 21, 2026 05:02 View deployment

update overview

dc27cf3

vercel bot had a problem deploying to Preview January 21, 2026 23:15 Failure

vercel bot had a problem deploying to Preview January 21, 2026 23:41 Failure

Remove orphaned todo.mdx placeholder file

6d4a01a

Co-Authored-By: Claude Opus 4.5 <[email protected]>

vercel bot deployed to Preview January 22, 2026 00:13 View deployment

docs: add iOS v0→v1 migration guide to ease upgrades

57aa40c

vercel bot deployed to Preview January 22, 2026 18:01 View deployment

update installation

207b1ba

vercel bot deployed to Preview January 22, 2026 18:08 View deployment

docs: simplify Apple sign-in flow to reduce custom setup

b3209db

mikepitre force-pushed the manovotny/manifest-heading-prop branch from 468c363 to b3209db Compare January 22, 2026 18:15

vercel bot deployed to Preview January 22, 2026 18:17 View deployment

swolfand force-pushed the manovotny/manifest-heading-prop branch from 8541e4c to 72a3ea7 Compare January 22, 2026 19:27

vercel bot deployed to Preview January 22, 2026 19:29 View deployment

swolfand force-pushed the manovotny/manifest-heading-prop branch 3 times, most recently from 671ad5c to 5d3aec8 Compare January 22, 2026 19:32

vercel bot deployed to Preview January 22, 2026 19:34 View deployment

docs: add Android v0→v1 migration guide to ease upgrades

1c03464

Co-Authored-By: Claude Opus 4.5 <[email protected]>

swolfand force-pushed the manovotny/manifest-heading-prop branch from 5d3aec8 to 1c03464 Compare January 22, 2026 19:38

vercel bot deployed to Preview January 22, 2026 19:40 View deployment

vercel bot had a problem deploying to Preview January 31, 2026 00:54 Failure

mikepitre force-pushed the manovotny/manifest-heading-prop branch from db2557a to 279aad4 Compare January 31, 2026 00:58

vercel bot had a problem deploying to Preview January 31, 2026 00:59 Failure

mikepitre force-pushed the manovotny/manifest-heading-prop branch from 279aad4 to bd267e6 Compare January 31, 2026 00:59

vercel bot had a problem deploying to Preview January 31, 2026 01:00 Failure

docs: make iOS config options easier to scan and navigate

9f8ee96

mikepitre force-pushed the manovotny/manifest-heading-prop branch from bd267e6 to 9f8ee96 Compare January 31, 2026 01:02

vercel bot had a problem deploying to Preview January 31, 2026 01:03 Failure

docs: fix iOS config anchors to avoid broken navigation

9c1bc22

vercel bot deployed to Preview January 31, 2026 01:08 View deployment

docs: surface ClerkOptions section for easier configuration lookup

02d9855

vercel bot deployed to Preview January 31, 2026 01:13 View deployment

update ClerkOptions type name

226aaf4

vercel bot deployed to Preview January 31, 2026 01:33 View deployment

Final docs review

f065e16

vercel bot deployed to Preview February 1, 2026 01:05 View deployment

SarahSoutoul reviewed Feb 1, 2026

View reviewed changes

docs: clarify iOS sign-in OTP flow and ordering

7fa2952

vercel bot deployed to Preview February 2, 2026 16:27 View deployment

docs: clarify sign-up continuation hierarchy for better navigation

64643c2

vercel bot deployed to Preview February 2, 2026 16:39 View deployment

Update dependency versions to use latest version placeholder

7290e79

vercel bot deployed to Preview February 2, 2026 19:20 View deployment

SarahSoutoul added 2 commits February 3, 2026 10:45

Bring consistency across auth guides

a56cd74

Update dependencies placeholder for Android!

a6953e9

vercel bot deployed to Preview February 3, 2026 17:02 View deployment

Keep one overview

d658d5c

vercel bot deployed to Preview February 3, 2026 18:02 View deployment

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Add heading prop support and improve mobile SDK scoping #2992

Add heading prop support and improve mobile SDK scoping #2992

Uh oh!

manovotny commented Jan 21, 2026 •

edited

Loading

Uh oh!

vercel bot commented Jan 21, 2026 •

edited

Loading

Uh oh!

SarahSoutoul commented Feb 1, 2026 •

edited

Loading

Uh oh!

Uh oh!

Uh oh!

SarahSoutoul Jan 29, 2026

Uh oh!

SarahSoutoul Jan 29, 2026

Uh oh!

SarahSoutoul Jan 31, 2026

Uh oh!

swolfand Feb 2, 2026

Uh oh!

SarahSoutoul Feb 3, 2026

Uh oh!

mikepitre commented Feb 1, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

6 participants


		Users can only create passkeys after signing up, so you'll need to enable another authentication strategy for the sign-up process. After signing in, users can create a passkey.

		<If sdk="android">

Add heading prop support and improve mobile SDK scoping #2992

Are you sure you want to change the base?

Add heading prop support and improve mobile SDK scoping #2992

Uh oh!

Conversation

manovotny commented Jan 21, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Previews

What does this solve?

What changed?

Uh oh!

vercel bot commented Jan 21, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

SarahSoutoul commented Feb 1, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Uh oh!

SarahSoutoul Jan 29, 2026

Choose a reason for hiding this comment

Uh oh!

SarahSoutoul Jan 29, 2026

Choose a reason for hiding this comment

Uh oh!

SarahSoutoul Jan 31, 2026

Choose a reason for hiding this comment

Uh oh!

swolfand Feb 2, 2026

Choose a reason for hiding this comment

Uh oh!

SarahSoutoul Feb 3, 2026

Choose a reason for hiding this comment

Uh oh!

mikepitre commented Feb 1, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

6 participants

manovotny commented Jan 21, 2026 •

edited

Loading

vercel bot commented Jan 21, 2026 •

edited

Loading

SarahSoutoul commented Feb 1, 2026 •

edited

Loading