Skip to content

docs: document native v4/v3 adoption — linking, claim validation, build floors - #1648

Draft
NandanPrabhu wants to merge 1 commit into
v6-developmentfrom
docs/native-adoption-docs
Draft

docs: document native v4/v3 adoption — linking, claim validation, build floors#1648
NandanPrabhu wants to merge 1 commit into
v6-developmentfrom
docs/native-adoption-docs

Conversation

@NandanPrabhu

Copy link
Copy Markdown
Contributor

Implements SDK-10615 — the consumer-facing docs carved out of SDK-10039 (Auth0.Android v4) and SDK-10040 (Auth0.swift v3).

What changed (docs only)

README.md

  • iOS deployment-target floor corrected 14.0 → 15.1 (min_ios_version_supported under RN 0.82+). Following the old 14.0 value fails pod install.
  • Android build floors added: minSdkVersion 26 (Android 8.0), compileSdkVersion 36, JDK 17.
  • Expo requirement made consistently SDK 55 for v6 (removed the stale 53-vs-55 inconsistency).
  • New iOS framework linkage section documenting use_frameworks! support.

MIGRATION_GUIDE.md (§9)

  • Added the opt-in ID-token claim-validation state on direct token requests, per flow: passkey signin validates on both platforms; passkey signup, Custom Token Exchange, MFA, and passwordless validate on neither (deliberate iOS/Android parity).

Verification

Cross-checked against the branch, not the upstream migration guides.

Divergences from the ticket (see Jira comment for detail)

  1. Main-thread callbacks item (Authentication API userInfo causes Unexpected token #2) omitted. The installed Auth0.swift 3.0.1 pod does not back the claim — CredentialsManager.swift doesn't wrap callbacks in Task { @MainActor in }, and WebAuthProvider isn't @Sendable @MainActor. That wrapping lives only in the Web Auth async bridge. A React Native consumer only observes a JS promise, so this item was omitted rather than document a guarantee the shipped pod lacks.
  2. Historical "Upgrading from v4 → v5" section left at platform :ios, '14.0' — that value was correct for v5. Current v6 guidance (§4) and the README both state 15.1.

…ld floors

Covers the consumer-facing docs carved out of SDK-10039/SDK-10040 (SDK-10615):

- README: correct iOS floor to 15.1 (min_ios_version_supported), state
  Android minSdk 26 / compileSdk 36 / JDK 17, and make the Expo requirement
  consistently SDK 55 for v6.
- README: add iOS use_frameworks! linkage guidance. Verified by building the
  example app under both USE_FRAMEWORKS=static and =dynamic (pod install + iOS
  simulator build succeeded in each).
- MIGRATION_GUIDE §9: document the opt-in ID-token claim validation state on
  direct token requests, with per-flow accuracy (passkey signin validates on
  both platforms; passkey signup, Custom Token Exchange, MFA, passwordless
  validate on neither — deliberate iOS/Android parity).

SDK-10615
@coderabbitai

coderabbitai Bot commented Aug 25, 2026

Copy link
Copy Markdown

Important

Draft PR not reviewed

Draft PRs are not automatically reviewed by default.

  • Trigger a manual review

To automatically review draft PRs, update your CodeRabbit configuration:

reviews:
  auto_review:
    drafts: true

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

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.

1 participant