Feat/rn cross platform mobile

.husky/pre-push

@@ -1,3 +1,3 @@
-# Run affected build, test, and lint tasks, excluding docs app
+# Run affected build, test, and lint tasks, excluding docs app and ui-native (peer deps not installed)
 # This compares against the remote branch you're pushing to
-nx affected -t build,test,lint --base=origin/main --head=HEAD --exclude=docs
+nx affected -t build,test,lint --base=origin/main --head=HEAD --exclude=docs,ui-native

.nxignore

@@ -1,2 +1,4 @@
+# Directories to ignore from Nx processing
+playground/demo-native
 # Ignore Foundry git submodule dependencies
 contracts/**/lib/**

apps/docs/docs/pages/account/create.mdx

@@ -26,6 +26,7 @@ Type: `AccountConfig`
 | `chainId` | `number` | Yes | Chain ID for the account |
 | `apiKey` | `string` | Yes | API key for JAW services |
 | `paymasterUrl` | `string` | No | Custom paymaster URL for gas sponsorship |
+| `storage` | `SyncStorage` | No | Custom storage implementation (defaults to localStorage on web, in-memory fallback in React Native) |
 
 ### options
 
@@ -34,8 +35,10 @@ Type: `CreateAccountOptions`
 | Property | Type | Required | Description |
 |----------|------|----------|-------------|
 | `username` | `string` | Yes | Username/display name for the passkey |
-| `rpId` | `string` | No | Relying party identifier (defaults to `window.location.hostname`) |
+| `rpId` | `string` | No | Relying party identifier (defaults to `window.location.hostname`). **Required in React Native.** |
 | `rpName` | `string` | No | Relying party name (defaults to `'JAW'`) |
+| `nativeGetFn` | `NativePasskeyGetFn` | No | Native passkey get function for React Native (e.g. `Passkey.get`). See [React Native Usage](#react-native-usage). |
+| `nativeCreateFn` | `NativePasskeyCreateFn` | No | Native passkey create function for React Native (e.g. `Passkey.create`). See [React Native Usage](#react-native-usage). |
 
 
 ## Returns
@@ -119,6 +122,31 @@ class MyUIHandler implements UIHandler {
 ```
 
 
+## React Native Usage
+
+In React Native, `window` and `navigator.credentials` are unavailable. Pass `Passkey.get` and `Passkey.create` from [`react-native-passkey`](https://github.com/f-23/react-native-passkey) directly — JAW handles all format conversion, challenge generation, and public key extraction internally.
+
+```typescript
+import { Account } from '@jaw.id/core';
+import { Passkey } from 'react-native-passkey';
+import type { SyncStorage } from '@jaw.id/core';
+
+// Your SyncStorage backed by MMKV or similar
+const storage: SyncStorage = { /* ... */ };
+
+const account = await Account.create(
+  { chainId: 8453, apiKey: 'your-api-key', storage },
+  {
+    username: 'alice',
+    rpId: 'myapp.com',
+    rpName: 'My App',
+    nativeGetFn: Passkey.get,
+    nativeCreateFn: Passkey.create,
+  }
+);
+```
+
+
 ## Related
 
 - [Account.get()](/account/get) - Login with existing account

apps/docs/docs/pages/account/get.mdx

@@ -10,7 +10,8 @@ Get an account instance - restores an existing session or triggers WebAuthn logi
 ```typescript
 static async get(
   config: AccountConfig,
-  credentialId?: string
+  credentialId?: string,
+  options?: GetAccountOptions
 ): Promise<Account>
 ```
 
@@ -26,13 +27,23 @@ Type: `AccountConfig`
 | `chainId` | `number` | Yes | Chain ID for the account |
 | `apiKey` | `string` | Yes | API key for JAW services |
 | `paymasterUrl` | `string` | No | Custom paymaster URL for gas sponsorship |
+| `storage` | `SyncStorage` | No | Custom storage implementation (defaults to localStorage on web, in-memory fallback in React Native) |
 
 ### credentialId
 
 Type: `string | undefined`
 
 Optional credential ID to login with. If provided and not already authenticated, triggers WebAuthn authentication.
 
+### options
+
+Type: `GetAccountOptions | undefined`
+
+| Property | Type | Required | Description |
+|----------|------|----------|-------------|
+| `nativeGetFn` | `NativePasskeyGetFn` | No | Native passkey get function for React Native (e.g. `Passkey.get`). |
+| `rpId` | `string` | No | Relying party identifier. **Required in React Native.** |
+
 
 ## Returns
 
@@ -96,6 +107,31 @@ if (accounts.length > 0) {
 ```
 
 
+## React Native Usage
+
+Pass `Passkey.get` from [`react-native-passkey`](https://github.com/f-23/react-native-passkey) as `nativeGetFn` and an explicit `rpId`. JAW handles all base64url ↔ ArrayBuffer conversion internally.
+
+```typescript
+import { Account } from '@jaw.id/core';
+import { Passkey } from 'react-native-passkey';
+
+// Restore existing session (no passkey prompt)
+const account = await Account.get(
+  { chainId: 8453, apiKey: 'your-api-key', storage },
+  undefined,
+  { nativeGetFn: Passkey.get, rpId: 'myapp.com' }
+);
+
+// Login with specific credential (triggers native passkey prompt)
+const stored = Account.getStoredAccounts('your-api-key', storage);
+const account = await Account.get(
+  { chainId: 8453, apiKey: 'your-api-key', storage },
+  stored[0].credentialId,
+  { nativeGetFn: Passkey.get, rpId: 'myapp.com' }
+);
+```
+
+
 ## Related
 
 - [Account.create()](/account/create) - Create a new account

apps/docs/docs/pages/account/import.mdx

@@ -8,7 +8,10 @@ Import a passkey from cloud backup.
 ## Signature
 
 ```typescript
-static async import(config: AccountConfig): Promise<Account>
+static async import(
+  config: AccountConfig,
+  options?: ImportAccountOptions
+): Promise<Account>
 ```
 
 
@@ -23,6 +26,16 @@ Type: `AccountConfig`
 | `chainId` | `number` | Yes | Chain ID for the account |
 | `apiKey` | `string` | Yes | API key for JAW services |
 | `paymasterUrl` | `string` | No | Custom paymaster URL for gas sponsorship |
+| `storage` | `SyncStorage` | No | Custom storage implementation (defaults to localStorage on web, in-memory fallback in React Native) |
+
+### options
+
+Type: `ImportAccountOptions | undefined`
+
+| Property | Type | Required | Description |
+|----------|------|----------|-------------|
+| `nativeGetFn` | `NativePasskeyGetFn` | No | Native passkey get function for React Native (e.g. `Passkey.get`). |
+| `rpId` | `string` | No | Relying party identifier. **Required in React Native.** |
 
 
 ## Returns
@@ -105,6 +118,21 @@ Passkeys can be synced via:
 The import flow allows users to access their JAW account on any device where their passkeys are synced.
 
 
+## React Native Usage
+
+Pass `Passkey.get` from [`react-native-passkey`](https://github.com/f-23/react-native-passkey) as `nativeGetFn` and an explicit `rpId`. JAW handles all base64url ↔ ArrayBuffer conversion internally.
+
+```typescript
+import { Account } from '@jaw.id/core';
+import { Passkey } from 'react-native-passkey';
+
+const account = await Account.import(
+  { chainId: 8453, apiKey: 'your-api-key', storage },
+  { nativeGetFn: Passkey.get, rpId: 'myapp.com' }
+);
+```
+
+
 ## Related
 
 - [Account.create()](/account/create) - Create a new account

apps/docs/docs/pages/account/index.mdx

@@ -11,6 +11,7 @@ The `Account` class is ideal for:
 
 - **AI Agents** - Issue programmable smart wallets for AI agents
 - **Headless Integration** - No UI required, direct programmatic access
+- **React Native** - Native mobile passkey support via `nativeGetFn` and `nativeCreateFn`
 - **Server-side Applications** - Using `fromLocalAccount()` with embedded wallets (Privy, Dynamic, Turnkey)
 - **Custom UI Handlers** - When implementing your own `UIHandler` for app-specific mode
 - **Direct Integration** - When you need fine-grained control over account operations
@@ -46,6 +47,9 @@ The `Account` class is exported from `@jaw.id/core`:
 
 ```typescript
 import { Account } from '@jaw.id/core';
+
+// React Native: also import adapter types
+import type { NativePasskeyGetFn, NativePasskeyCreateFn, SyncStorage } from '@jaw.id/core';
 ```
 
 
@@ -130,6 +134,8 @@ interface AccountConfig {
   paymasterUrl?: string;
   /** Custom paymaster context for gas sponsorship */
   paymasterContext?: Record<string, unknown>;
+  /** Custom storage implementation (defaults to localStorage on web, in-memory fallback in React Native) */
+  storage?: SyncStorage;
 }
 ```
 
@@ -141,10 +147,27 @@ Options for creating a new account:
 interface CreateAccountOptions {
   /** Username/display name for the passkey */
   username: string;
-  /** Relying party identifier (defaults to window.location.hostname) */
+  /** Relying party identifier (defaults to window.location.hostname). Required in React Native. */
   rpId?: string;
   /** Relying party name (defaults to 'JAW') */
   rpName?: string;
+  /** Native passkey get function for React Native (e.g. Passkey.get) */
+  nativeGetFn?: NativePasskeyGetFn;
+  /** Native passkey create function for React Native (e.g. Passkey.create) */
+  nativeCreateFn?: NativePasskeyCreateFn;
+}
+```
+
+### GetAccountOptions / ImportAccountOptions / RestoreAccountOptions
+
+Options for `get()`, `import()`, and `restore()`:
+
+```typescript
+interface GetAccountOptions {
+  /** Native passkey get function for React Native (e.g. Passkey.get) */
+  nativeGetFn?: NativePasskeyGetFn;
+  /** Relying party identifier. Required in React Native. */
+  rpId?: string;
 }
 ```
 

apps/docs/docs/pages/account/restore.mdx

@@ -11,7 +11,8 @@ Restore an account from existing credential data without triggering a WebAuthn p
 static async restore(
   config: AccountConfig,
   credentialId: string,
-  publicKey: `0x${string}`
+  publicKey: `0x${string}`,
+  options?: RestoreAccountOptions
 ): Promise<Account>
 ```
 
@@ -28,6 +29,7 @@ Type: `AccountConfig`
 | `apiKey` | `string` | Yes | API key for JAW services |
 | `paymasterUrl` | `string` | No | Custom paymaster URL for gas sponsorship |
 | `paymasterContext` | `Record<string, unknown>` | No | Custom paymaster context |
+| `storage` | `SyncStorage` | No | Custom storage implementation (defaults to localStorage on web, in-memory fallback in React Native) |
 
 ### credentialId
 
@@ -41,6 +43,15 @@ Type: `` `0x${string}` ``
 
 The public key of the passkey (hex encoded).
 
+### options
+
+Type: `RestoreAccountOptions | undefined`
+
+| Property | Type | Required | Description |
+|----------|------|----------|-------------|
+| `nativeGetFn` | `NativePasskeyGetFn` | No | Native passkey get function for React Native (e.g. `Passkey.get`). |
+| `rpId` | `string` | No | Relying party identifier. **Required in React Native.** |
+
 
 ## Returns
 
@@ -100,6 +111,26 @@ async function handleSignRequest(credentialId: string, publicKey: `0x${string}`)
 ```
 
 
+## React Native Usage
+
+Pass `Passkey.get` from [`react-native-passkey`](https://github.com/f-23/react-native-passkey) as `nativeGetFn` and an explicit `rpId` so signing operations use the native passkey prompt. JAW handles all base64url ↔ ArrayBuffer conversion internally.
+
+```typescript
+import { Account } from '@jaw.id/core';
+import { Passkey } from 'react-native-passkey';
+
+const account = await Account.restore(
+  { chainId: 8453, apiKey: 'your-api-key', storage },
+  credentialId,
+  publicKey,
+  { nativeGetFn: Passkey.get, rpId: 'myapp.com' }
+);
+
+// Signing triggers the native passkey prompt via nativeGetFn
+const signature = await account.signMessage('Hello');
+```
+
+
 ## Related
 
 - [Account.get()](/account/get) - Get account with optional WebAuthn prompt

apps/keys-jaw-id/next.config.js

@@ -1,6 +1,5 @@
 //@ts-check
 
-const path = require('path');
 const { composePlugins, withNx } = require('@nx/next');
 
 
@@ -11,32 +10,24 @@ const nextConfig = {
   // Use this to set Nx-specific options
   // See: https://nx.dev/recipes/next/next-config-setup
   nx: {},
-  poweredByHeader: false,
-  productionBrowserSourceMaps: false,
-  compiler: {
-    removeConsole: process.env.NODE_ENV === 'production'
-      ? { exclude: ['error', 'warn'] }
-      : false,
-  },
-  transpilePackages: ['@jaw.id/ui'],
-  experimental: {
+    transpilePackages: ['@jaw.id/ui', '@jaw.id/core'],
+    experimental: {
     optimizePackageImports: ['lucide-react'],
   },
-  webpack: (config) => {
-    // Replace the UI package's CSS with an empty override to prevent
-    // conflicting oklch CSS variables and duplicate Tailwind utility classes.
-    // The UI package's CSS uses oklch color values and var(--color) directly,
-    // while this app uses HSL params with hsl(var(--color) / <alpha-value>)
-    // for opacity modifier support. This app's own Tailwind config generates
-    // all needed utilities from the UI package's source files.
-    const overrideCss = path.resolve(__dirname, 'src/app/ui-overrides.css');
-    config.resolve.alias[
-      path.resolve(__dirname, '../../packages/ui/src/styles.css')
-    ] = overrideCss;
-    config.resolve.alias[
-      path.resolve(__dirname, '../../packages/ui/dist/index.css')
-    ] = overrideCss;
-    return config;
+
+  // Serve AASA file with correct content-type for iOS passkeys
+  async headers() {
+    return [
+      {
+        source: '/.well-known/apple-app-site-association',
+        headers: [
+          {
+            key: 'Content-Type',
+            value: 'application/json',
+          },
+        ],
+      },
+    ];
   },
 };
 

apps/keys-jaw-id/package.json

@@ -5,11 +5,13 @@
   "dependencies": {
     "@jaw.id/core": "workspace:*",
     "@jaw.id/ui": "workspace:*",
+    "@justaname.id/sdk": "^0.2.204",
     "@tanstack/react-query": "^5.62.16",
-    "next": "~15.5.10",
+    "next": "~15.2.6",
     "react": "19.0.1",
     "react-dom": "19.0.1",
     "tailwindcss-animate": "^1.0.7",
     "viem": "^2.38.2"
-  }
+  },
+  "devDependencies": {}
 }

apps/keys-jaw-id/public/.well-known/apple-app-site-association

@@ -0,0 +1,7 @@
+{
+  "webcredentials": {
+    "apps": [
+      "9234ZPYS2R.id.jaw.demo.native"
+    ]
+  }
+}