Skip to content

docs: react native sdk, mobile passkeys and bearer transport - #43

Merged
Bccorb merged 1 commit into
mainfrom
docs/react-native-and-bearer
Sep 13, 2026
Merged

Bccorb merged 1 commit into
mainfrom
docs/react-native-and-bearer

Conversation

@Bccorb

@Bccorb Bccorb commented Sep 13, 2026

Copy link
Copy Markdown
Contributor

Documents the mobile work landing across the ecosystem: fells-code/seamless-auth-server#162 and #164 (bearer guards and transport), fells-code/seamless-auth-js#149, #150 and #151 (@seamless-auth/client, ports, @seamless-auth/react-native), fells-code/seamless-templates#90 and fells-code/seamless-cli#205 (the Expo template and --mobile), and the flow_rate_limits key from fells-code/seamless-auth-api#310. Best merged once those have shipped, so nothing here describes a package that is not yet on npm.

New pages

  • Build / React Native SDK: what differs from the web (bearer transport through the same adapter routes), installation with a development build, AuthProvider and the three ports, reading state, useAuthorizedFetch, the sign-in flows on a phone (passkey, codes, magic link polling and universal links, OAuth through an in-app browser session), passkeys and describeDevice, the keychain-after-reinstall caveat, and the boundary.
  • Build / Mobile Passkeys: the relying party domain, apple-app-site-association and assetlinks.json with the traps (Team ID is the certificate OU, one fingerprint per signing key), the auth server's origins additions with the web origin first, the Expo declaration, how to check each piece (otool for simulator entitlements, pm get-app-links), and carrier NAT against flow_rate_limits.

Updated pages

  • Server SDKs: requireAuth with authServerUrl and audience, a "Bearer Transport For Native Clients" section, coverage mentions React Native and Fastify.
  • How To Secure Routes: Step 6 gains the native variant.
  • React SDK: names @seamless-auth/client, adds "Platform Ports And Transport" with useAuthorizedFetch.
  • Ecosystem: the two new packages in the table and a "mobile app" starting point.
  • System Config: native origins under WebAuthn config.
  • CLI reference and init walkthrough: the mobile prompt and --mobile=expo.
  • Build sidebar renumbered to fit the two pages after React SDK.

Verified

npm run build (35 pages), npm run lint and astro check pass (the pre-commit hook runs all three).

Two new Build pages: the React Native SDK (bearer transport, the ports, the
hooks, the sign-in flows on a phone, calling your own API, the keychain after
a reinstall) and Mobile Passkeys (the associated domain, both association
files, the auth server's origins, the app declaration, how to check it, and
carrier NAT against the flow rate limits). The server SDK page gains the
bearer contract and requireAuth's authServerUrl and audience; secure routes
gains the native variant of calling a protected route; the React SDK page
names the shared client package and the ports and transport options; the
ecosystem, system config and CLI pages pick up the new package and the
mobile template.
@Bccorb
Bccorb merged commit 3fb3cdd into main Sep 13, 2026
1 check passed
@Bccorb
Bccorb deleted the docs/react-native-and-bearer branch September 13, 2026 15:53
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