Skip to content

Open-source platform for 3D AI agents. Turn text or a photo into a rigged, animated GLB avatar, give it an LLM brain, memory and a wallet, and embed it anywhere with one web component. Remote MCP server, x402 payments, Three.js, browser-native.

feat(ios): ship three.ws to the App Store as a Capacitor shell over the live site

nirholas7fa363c33162
diff --git a/STRUCTURE.md b/STRUCTURE.md
index 91b5bcf32..a73dc4ff9 100644
--- a/STRUCTURE.md
+++ b/STRUCTURE.md
@@ -216,6 +216,7 @@ bottom.
| BNB Chain live block race | [pages/bnb-latency.html](pages/bnb-latency.html) + [src/bnb-latency.js](src/bnb-latency.js) `→ /bnb-latency`, pure helpers [src/bnb-latency-helpers.js](src/bnb-latency-helpers.js), live multi-chain API [api/bnb/latency.js](api/bnb/latency.js) over [api/_lib/bnb/latency-lanes.js](api/_lib/bnb/latency-lanes.js) (reuses `probeBlockTime` from [api/_lib/bnb/chains.js](api/_lib/bnb/chains.js) for BNB, adds Base/Ethereum/Solana lanes) | In-repo · shipped | Standalone, shareable proof page: four lanes (BNB Chain, Base, Ethereum, Solana) polled every 5s, each showing a freshly measured average block/slot time and a rolling sparkline — no hardcoded numbers, a down RPC shows "reconnecting" on just that lane. Headline strip shows BNB's live average plus its honest measured-vs-measured speedup over Base/Ethereum. Linked from the [/bnb](pages/bnb.html) hub's "real-time on-chain world" card, which auto-lights-up now that this route resolves. |
| BNB Chain payments (MPP, x402↔MPP bridge, gasless) | Accept [api/_lib/bnb/mpp-server.js](api/_lib/bnb/mpp-server.js) (`mppRequirements`/`mppChallenge`/`mppVerify`/`mppSettle`), pay [api/_lib/bnb/mpp-buyer.js](api/_lib/bnb/mpp-buyer.js) (`mppFetch`, re-exported from [api/_lib/x402-buyer-fetch.js](api/_lib/x402-buyer-fetch.js)), gasless rail [api/_lib/bnb/megafuel.js](api/_lib/bnb/megafuel.js), pilot dual-protocol endpoint [api/x402/three-intel.js](api/x402/three-intel.js) | In-repo · shipped, settlement needs merchant creds | three.ws speaks MPP (BNB Chain's Machine Payments Protocol) additively alongside x402: MPP's `b402` layer is x402 v2 byte-for-byte (same `X-PAYMENT`/`X-PAYMENT-RESPONSE`, same EIP-3009 credential), so a dual-protocol endpoint just advertises an extra BNB (`eip155:56`/`97`) accept entry and routes BNB-network payments to the b402 facilitator while Solana/Base traffic stays on the untouched x402 path. Verify (off-chain, free, replay-guarded via Redis `SET NX PX`) always runs before settle; without `B402_*` merchant credentials, settle fails closed with `mpp_not_configured` (503) rather than fabricating a receipt. Guide: [docs/bnb-payments.md](docs/bnb-payments.md). Wire contract: [specs/x402-mpp-bridge.md](specs/x402-mpp-bridge.md). Tests: [tests/bnb-mpp-server.test.js](tests/bnb-mpp-server.test.js), [tests/bnb-mpp-buyer.test.js](tests/bnb-mpp-buyer.test.js). |
| Seeker / Saga dApp Store app | [solana-mobile/](solana-mobile): TWA wrapper [solana-mobile/twa/](solana-mobile/twa), Publisher Portal listing copy [solana-mobile/publish/](solana-mobile/publish), MWA wallet + Seeker detection [solana-mobile/src/](solana-mobile/src) | In-repo · signed APK + assetlinks live · awaiting owner's Publisher Portal submission | Everything needed to package three.ws as a Solana Mobile app and publish it to the on-chain dApp Store. Targets Seeker first; compatible with Saga Gen 1 and Gen 2. Docs: [solana-mobile/README.md](solana-mobile/README.md) |
+| iOS App Store app | [ios/](ios): Capacitor shell + config [ios/capacitor.config.ts](ios/capacitor.config.ts), Xcode project [ios/native/App/](ios/native/App), web-side native bridge [ios/src/native-bridge.js](ios/src/native-bridge.js), offline shell [ios/shell/](ios/shell), listing copy [ios/publish/](ios/publish), app association handler in [api/wk.js](api/wk.js) | In-repo · project builds and the web half ships on every deploy · awaiting an Apple Developer organization account | three.ws as a native iOS app (`ws.three.app`). A Capacitor 8 shell whose WKWebView runs the live `https://three.ws`, so the app is never a version behind the site; what makes it an app is the native layer around it. `ios/src/native-bridge.js` ships with the SITE, not the .ipa (Capacitor injects its bridge into the remote page, so `window.Capacitor` exists on three.ws only inside the app): it supplies the `navigator.share` WKWebView does not have, routes off-site links to an in-app Safari sheet instead of stranding the app's only WebView, handles universal links and `threews://` wallet returns, holds the launch screen until the first real frame, and marks `html.ios-app`. The `three-ws-ios-native-bridge` plugin in [vite.config.js](vite.config.js) copies it into `dist/` content-hashed and injects it into every built page except the third-party embed entries (671 pages, `/viewer` and `/ar` included, which a `transformIndexHtml` could not reach because they are copied verbatim from `public/`). `GET /.well-known/apple-app-site-association` is served from the API rather than a static file because Apple demands an exact path, a JSON content type and no redirect; it answers `503 not_configured` until `APPLE_TEAM_ID` is set rather than publishing an association that would fail silently on device. Docs: [ios/README.md](ios/README.md), [docs/ios-app.md](docs/ios-app.md), App Review posture [ios/docs/REVIEW-RISK.md](ios/docs/REVIEW-RISK.md), submission [ios/docs/SUBMISSION.md](ios/docs/SUBMISSION.md). |
| Walk Avatar browser extension | [extensions/walk-avatar/](extensions/walk-avatar) — MV3 `manifest.json`, `background.js` | In-repo · Chrome Web Store release checklist staged ([RELEASE.md](extensions/walk-avatar/RELEASE.md)) | Walks your three.ws avatar across any site and reads pages aloud — a browsing companion built on the same rig as the [walk-sdk](walk-sdk). Ships its own store-required [PRIVACY.md](extensions/walk-avatar/PRIVACY.md), [PERMISSIONS.md](extensions/walk-avatar/PERMISSIONS.md), and [TERMS.md](extensions/walk-avatar/TERMS.md). |
| DCC tool integrations (Blender, ComfyUI) | [integrations/](integrations) — [integrations/blender/](integrations/blender), [integrations/comfyui/](integrations/comfyui), shared Python client [integrations/_pyclient/](integrations/_pyclient) | In-repo | First-party plugins that drive the public Forge pipeline (`/api/forge`) from inside the tools artists already use, so a model is generated without leaving the DCC. Docs: [integrations/README.md](integrations/README.md) |
| Base58 difficulty model (the honest math) | [src/solana/vanity/base58-distribution.js](src/solana/vanity/base58-distribution.js), dispatch in [src/solana/vanity/validation.js](src/solana/vanity/validation.js); ported copies in [solana-agent-sdk/src/vanity/verify.ts](solana-agent-sdk/src/vanity/verify.ts) and [mcp-server/src/lib/base58-distribution.js](mcp-server/src/lib/base58-distribution.js), held in agreement by [tests/vanity-model-parity.test.js](tests/vanity-model-parity.test.js) | In-repo | The exact probability that a random Solana address matches a vanity pattern, and the single source of truth behind every quote, price, rarity tier, bounty payout and signed receipt. Base58 is a positional encoding of a 256-bit integer, so the *leading* character is not uniform: the 40 symbols `K`-`z` are 17.2x harder to lead with than `5`-`H`, a 58x spread the old flat 58ⁿ model erased. Models are versioned (`base58-exact/v2`, superseding `58^effectiveLength`) and receipts name theirs, so attestations issued before the correction still verify. Spec: [docs/PROTOCOL-vanity.md](docs/PROTOCOL-vanity.md#41-difficulty-model-versioning) |
diff --git a/api/_lib/env.js b/api/_lib/env.js
index d7b29d069..fd41d704e 100644
--- a/api/_lib/env.js
+++ b/api/_lib/env.js
@@ -241,6 +241,17 @@ export const env = {
return normalizeAppOrigin(opt('PUBLIC_APP_ORIGIN'));
},
+ // Apple Developer Team ID (10 chars, e.g. "A1B2C3D4E5"). Prefixed onto the iOS
+ // bundle id to form the app identifier in /.well-known/apple-app-site-association,
+ // which is what lets a three.ws link open the iOS app instead of Safari. Unset
+ // everywhere until the Apple Developer account exists; the handler answers 503
+ // rather than publishing an association nobody can sign against. Trimmed because
+ // a Team ID copied out of the developer portal frequently carries whitespace,
+ // and a padded value produces an appID that silently matches nothing on device.
+ get APPLE_TEAM_ID() {
+ return (opt('APPLE_TEAM_ID') ?? '').trim();
+ },
+
// Runtime environment signals. NODE_ENV is set to 'production' by Vercel's
// build/runtime; VERCEL_ENV is 'production' | 'preview' | 'development' on
// Vercel deployments. Tests and local dev leave both unset, so prod-only
diff --git a/api/wk.js b/api/wk.js
index 74f9d9f77..d3d71ac94 100644
--- a/api/wk.js
+++ b/api/wk.js
@@ -1953,6 +1953,66 @@ async function handleThreeVanity(req, res) {
);
}
+// ── apple-app-site-association (/.well-known/apple-app-site-association) ──────
+//
+// The file iOS fetches to decide whether a https://three.ws link opens the app
+// instead of Safari (universal links) and whether the login form in the app's
+// WebView may offer a saved three.ws password (webcredentials). Apple's CDN
+// requires it over TLS at exactly this path, with no redirect, no .json
+// extension, and a JSON content type; every one of those is why it is served
+// from here rather than dropped in public/.well-known/ next to assetlinks.json,
+// which the static route would hand back with the wrong headers.
+//
+// The app identifier is "<TeamID>.<bundle id>" and the Team ID is only knowable
+// once the Apple Developer account exists, so it comes from APPLE_TEAM_ID on the
+// Cloud Run service. Until that is set the endpoint answers 503 rather than
+// publishing an association for a team that cannot sign anything: a wrong
+// appIDs entry fails silently on device (links just keep opening in Safari),
+// and an honest 503 is the only version of this that is debuggable.
+const IOS_BUNDLE_ID = 'ws.three.app';
+
+function handleAppleAppSiteAssociation(req, res) {
+ const teamId = env.APPLE_TEAM_ID;
+ if (!teamId) {
+ return error(
+ res,
+ 503,
+ 'not_configured',
+ 'APPLE_TEAM_ID is not set on this deployment, so no app association can be published',
+ );
+ }
+ const appId = `${teamId}.${IOS_BUNDLE_ID}`;
+ return json(
+ res,
+ 200,
+ {
+ applinks: {
+ details: [
+ {
+ appIDs: [appId],
+ components: [
+ // The API is data, not a screen. Handing /api/* to the app
+ // would swallow OAuth redirects and x402 callbacks that have
+ // to complete in the browser that started them.
+ { '/': '/api/*', exclude: true, comment: 'API surface stays in the browser' },
+ // Embeds are meant to render inside someone else's page.
+ { '/': '/embed*', exclude: true, comment: 'third-party embeds stay on the web' },
+ { '/': '/widget*', exclude: true, comment: 'third-party embeds stay on the web' },
+ { '/': '/*' },
+ ],
+ },
+ ],
+ },
+ webcredentials: { apps: [appId] },
+ },
+ {
+ // Apple caches this aggressively at the CDN either way; a short TTL keeps
+ // a Team ID correction from taking a day to reach devices.
+ 'cache-control': 'public, max-age=300',
+ },
+ );
+}
+
const DISPATCH = {
'agent-attestation-schemas': handleAttestationSchemas,
'three-vanity': handleThreeVanity,
@@ -1962,6 +2022,7 @@ const DISPATCH = {
'oauth-protected-resource': handleOauthProtectedResource,
x402: handleX402,
'x402-discovery': handleX402Discovery,
+ 'apple-app-site-association': handleAppleAppSiteAssociation,
};
// Public discovery docs (x402, x402-discovery, chat-plugin, agent-attestation-schemas)
diff --git a/docs/ios-app.md b/docs/ios-app.md
new file mode 100644
index 000000000..d8bd2f085
--- /dev/null
+++ b/docs/ios-app.md
@@ -0,0 +1,86 @@
+# three.ws on iOS
+
+three.ws ships to the App Store as a native iOS app (`ws.three.app`). Like the
+[Seeker app](./seeker-app.md), it is a shell around the live web product rather
+than a second implementation of it: a Capacitor 8 container whose WKWebView runs
+`https://three.ws`, wrapped in the native layer a website cannot have. For a
+WebGL product that is the right shape, and it means the app is never a version
+behind the site. What makes it an app is everything around that shell.
+
+This page is the user-facing map. Packaging, signing, App Review posture and the
+submission checklist live in [`ios/README.md`](../ios/README.md).
+
+**Status: in-repo, not yet submitted.** The Xcode project builds and the web
+side is live in every deploy. What is outstanding is an Apple Developer
+organization account, app icons, and push. See "What is missing" below.
+
+## What the app does differently from the website
+
+| Surface | In the iOS app | Where it lives |
+|---|---|---|
+| Sharing | The system share sheet, with AR captures attached as real image files | `ios/src/native-bridge.js` (`navigator.share` shim) |
+| Deep links | Any `https://three.ws/...` link opens in the app once the app association is live | `ios/native/App/App/App.entitlements`, `api/wk.js` |
+| Wallet returns | A wallet or OAuth redirect comes back to the exact page that started it, over `threews://` | `ios/src/native-bridge.js` (`appUrlOpen`), `Info.plist` URL types |
+| Off-site links | Open in an in-app Safari sheet and return, instead of navigating the app away with no way back | `ios/src/native-bridge.js` |
+| Offline | A designed screen that polls `/api/healthz` and recovers on its own, instead of the WebKit error page | `ios/shell/offline.html`, `server.errorPath` |
+| Camera, mic, photos, location, motion | Real iOS permission prompts with real usage strings, which is what `/create/selfie`, `/ar/studio` and `/irl` need on iOS | `ios/native/App/App/Info.plist` |
+| Launch | The launch screen holds until the first real frame, so a three.js scene never opens onto a black void | `ios/src/native-bridge.js`, `SplashScreen` config |
+| Haptics | A tick on primary actions | `ios/src/native-bridge.js` (`[data-haptic]`) |
+
+## How the web half reaches the app
+
+Capacitor injects its native bridge into the remote page at document start, so
+`window.Capacitor` exists on `https://three.ws` whenever the site is being
+viewed inside the app, and nowhere else. `ios/src/native-bridge.js` keys every
+behaviour above off that, and ships with the **site**: the
+`three-ws-ios-native-bridge` plugin in [`vite.config.js`](../vite.config.js)
+copies it into `dist/` under a content-hashed name and injects a script tag into
+every built page except the third-party embed entries.
+
+Two consequences worth knowing:
+
+- **App behaviour ships on a web deploy, not an App Store release.** Fixing the
+ share sheet or adding a deep-link route is a normal deploy.
+- **An old web deploy means an app with no native behaviour.** The app degrades
+ to a plain WebView rather than breaking, but the shims are simply absent.
+
+## The app association
+
+`GET /.well-known/apple-app-site-association` ([`api/wk.js`](../api/wk.js)) is
+what tells iOS that three.ws links belong to the app, and that the login form
+inside the app may offer a saved three.ws password. It is served from the API
+rather than `public/.well-known/` because Apple requires an exact path, a JSON
+content type, and no redirect.
+
+The app identifier is `<Team ID>.ws.three.app`, and the Team ID comes from
+`APPLE_TEAM_ID` on the Cloud Run service. Until that is set the endpoint answers
+`503 not_configured` on purpose: publishing an association for a team that
+cannot sign anything fails silently on device, where links just keep opening in
+Safari and nothing errors.
+
+```bash
+curl -sS -D- https://three.ws/.well-known/apple-app-site-association
+```
+
+The `applinks` components hand every path to the app except `/api/*` (OAuth and
+x402 callbacks must finish in the browser that started them) and the `/embed*`
+and `/widget*` entries (they exist to render inside someone else's page).
+
+## What is missing
+
+- **`APPLE_TEAM_ID`**, which needs an Apple Developer Program account enrolled
+ as an organization. Apple only permits wallet functionality from organization
+ accounts, and that enrollment needs a legal entity and a D-U-N-S number.
+- **Push notifications.** The entitlement, background mode and plugin are in
+ place; the APNs key, device-token endpoint and send path are not, and are
+ absent rather than stubbed.
+- **App icons and launch screen art**, currently Capacitor's template.
+- **The App Review posture on crypto surfaces**, which is a product decision
+ and not a code one. It is written up in
+ [`ios/docs/REVIEW-RISK.md`](../ios/docs/REVIEW-RISK.md).
+
+## Related
+
+- [three.ws on Solana Seeker](./seeker-app.md): the Android app
+- [`ios/README.md`](../ios/README.md): building and shipping this one
+- [`STRUCTURE.md`](../STRUCTURE.md): where every surface lives
diff --git a/ios/.gitignore b/ios/.gitignore
new file mode 100644
index 000000000..8492deaf9
--- /dev/null
+++ b/ios/.gitignore
@@ -0,0 +1,26 @@
+# Capacitor workspace deps. The generated Xcode project resolves its Swift
+# packages from ios/native/App/CapApp-SPM, which is committed; this is only the
+# CLI + plugin JS used by `cap sync`.
+node_modules/
+
+# Xcode build state. DerivedData is machine-local and enormous; xcuserdata holds
+# one developer's window layout and breakpoints.
+native/App/build/
+native/App/DerivedData/
+**/xcuserdata/
+*.xcworkspace/xcuserdata/
+
+# Signing material never belongs in the repo.
+*.mobileprovision
+*.p12
+*.cer
+*.certSigningRequest
+AuthKey_*.p8
+
+# Archives and uploads.
+*.ipa
+*.dSYM.zip
+*.xcarchive/
+
+# `cap copy` writes the shell bundle in here; it is generated from ios/shell/.
+native/App/App/public/
diff --git a/ios/README.md b/ios/README.md
new file mode 100644
index 000000000..bd2568592
--- /dev/null
+++ b/ios/README.md
@@ -0,0 +1,112 @@
+# `ios/`: the three.ws iOS app
+
+The App Store build of three.ws. A Capacitor 8 shell whose WKWebView runs the
+live product at `https://three.ws`, wrapped in the native layer an app needs and
+a website cannot have: universal links, the system share sheet, deep links back
+from wallets, haptics, a real launch screen, and the camera / location / motion
+permissions the AR and IRL surfaces depend on.
+
+The Android counterpart is [`../solana-mobile/`](../solana-mobile), which
+packages the same product as a Trusted Web Activity for the Solana dApp Store.
+This directory follows its shape on purpose: detection and shims in `src/`, the
+native project under a single directory, listing copy in `publish/`, and a
+submission checklist in `docs/`.
+
+## Layout
+
+```
+ios/
+├── capacitor.config.ts # appId, server URL, iOS behaviour, plugin config
+├── shell/ # local bundle: bootstrap + the designed offline screen
+├── src/native-bridge.js # web-side half; ships with the SITE, not the .ipa
+├── native/App/ # the generated Xcode project (committed)
+│ ├── App.xcodeproj
+│ ├── App/Info.plist # usage strings, URL scheme, orientations
+│ ├── App/App.entitlements # associated domains + APNs
+│ └── CapApp-SPM/ # Swift Package Manager plugin graph
+└── docs/ # SUBMISSION.md, REVIEW-RISK.md, ASSETS.md
+```
+
+## Why the WebView loads the live site
+
+The alternative is baking `dist/` into the `.ipa` and serving it from
+`capacitor://localhost`. That breaks the product: 733 call sites in `src/` fetch
+same-origin `/api/...`, and the session cookie, the OAuth callbacks and the x402
+payment headers are all issued for the `three.ws` origin. Rewriting every one of
+them behind an API base is a larger and riskier change than shipping the app,
+and it would fork the web and app code paths permanently.
+
+What keeps this from being a bookmark (and from failing App Review guideline
+4.2) is the native layer in `src/native-bridge.js` and the entitlements: share
+sheet, universal links, wallet deep links, haptics, offline screen, and the
+native permission prompts. Read [`docs/REVIEW-RISK.md`](docs/REVIEW-RISK.md)
+before changing any of it; the crypto surfaces carry real rejection risk and
+that document is where the reasoning lives.
+
+`shell/` is still a real bundle: `shell/offline.html` is wired as
+`server.errorPath`, so a launch with no network gets a designed screen that
+polls `/api/healthz` and recovers on its own instead of the WebKit error page.
+
+## The web-side half
+
+`src/native-bridge.js` is loaded by the **site**, not the app: Capacitor injects
+its bridge into the remote page at document start, so `window.Capacitor` exists
+on `https://three.ws` whenever it is being viewed inside the app. The
+`three-ws-ios-native-bridge` plugin in [`../vite.config.js`](../vite.config.js)
+injects the module into every built page except the embed entries. It is a no-op
+in every browser.
+
+What it installs, and the breakage each one fixes:
+
+| Shim | Without it |
+|---|---|
+| `navigator.share` / `canShare` over the native sheet | WKWebView has no Web Share API, so every share button on the platform silently does nothing |
+| Off-site links to an in-app Safari sheet | A tap on an explorer link navigates the app's only WebView away from three.ws with no back button |
+| `appUrlOpen` routing (universal links + `threews://`) | A wallet or OAuth redirect reopens the app on whatever page it was last showing |
+| Splash hide on first paint | `launchAutoHide` fires on WebView load, minutes before a three.js scene renders |
+| `html.ios-app` + safe-area custom properties | Install prompts render inside the installed app; bottom controls sit under the home indicator |
+| Haptics on `[data-haptic]` | No tactile feedback anywhere |
+
+## Working on it
+
+```bash
+cd ios
+npm install # Capacitor CLI + plugins
+npm run sync # copy shell/ into the Xcode project, resolve plugins
+npm run open # open App.xcworkspace in Xcode (macOS only)
+```
+
+`npm run sync` works on Linux: Capacitor 8 resolves plugins through Swift Package
+Manager, so there is no CocoaPods step and no macOS requirement for anything
+except compiling, signing and uploading.
+
+From the repo root:
+
+```bash
+npm run ios:sync # same as the above, without changing directory
+```
+
+## What is not wired yet
+
+Everything here builds and runs; these are the pieces that need an Apple
+Developer account before they can exist at all, listed so nobody rediscovers
+them at submission time:
+
+- **`APPLE_TEAM_ID`** on the Cloud Run service. `/.well-known/apple-app-site-association`
+ ([`../api/wk.js`](../api/wk.js)) answers `503 not_configured` until it is set,
+ and universal links keep opening in Safari until it serves a real association.
+ Set it with `gcloud run services update three-ws-api --region us-central1 --update-env-vars APPLE_TEAM_ID=<id>`.
+- **Push notifications.** The plugin, the `remote-notification` background mode
+ and the `aps-environment` entitlement are in place; the APNs key, the device
+ token endpoint and the send path are not, and are deliberately absent rather
+ than stubbed.
+- **App icons and launch screen art.** `native/App/App/Assets.xcassets` still
+ holds Capacitor's template. Specs in [`docs/ASSETS.md`](docs/ASSETS.md).
+- **Signing.** No team, no provisioning profile, no `ExportOptions.plist`. See
+ [`docs/SUBMISSION.md`](docs/SUBMISSION.md).
+
+## Related
+
+- Product doc: [`../docs/ios-app.md`](../docs/ios-app.md)
+- Android / Seeker app: [`../solana-mobile/README.md`](../solana-mobile/README.md)
+- Where everything lives: [`../STRUCTURE.md`](../STRUCTURE.md)
diff --git a/ios/capacitor.config.ts b/ios/capacitor.config.ts
new file mode 100644
index 000000000..2cbc96249
--- /dev/null
+++ b/ios/capacitor.config.ts
@@ -0,0 +1,66 @@
+import type { CapacitorConfig } from '@capacitor/cli';
+
+// The WebView loads the live product at https://three.ws rather than a copy of
+// dist/ baked into the .ipa. That is deliberate and load-bearing, not laziness:
+// 733 call sites in src/ fetch same-origin '/api/...', and the session cookie,
+// the OAuth callbacks and the x402 payment headers are all issued for the
+// three.ws origin. Serving the bundle from capacitor://localhost would break
+// every one of them, and rewriting all of them behind an API base is a far
+// larger and far riskier change than shipping the app.
+//
+// What keeps this from being a bookmark (App Review guideline 4.2) is the
+// native layer around it: push notifications, the share extension, WidgetKit,
+// App Intents, ARKit Quick Look, and the camera/location bridges in src/.
+// See docs/REVIEW-RISK.md before touching any of it.
+const config: CapacitorConfig = {
+ appId: 'ws.three.app',
+ appName: 'three.ws',
+ // Capacitor still needs a local bundle: it backs errorPath (the offline
+ // screen) and is what the WebView falls back to with no network at launch.
+ webDir: 'shell',
+ loggingBehavior: 'production',
+ server: {
+ url: 'https://three.ws',
+ hostname: 'three.ws',
+ iosScheme: 'https',
+ // Everything the product legitimately navigates to in-WebView. Anything
+ // not listed here opens in the system browser via the App plugin's
+ // urlOpen handler (src/native-bridge.js), which is both the correct UX
+ // and what keeps third-party auth out of an embedded WebView.
+ allowNavigation: [
+ 'three.ws',
+ '*.three.ws',
+ 'api.three.ws',
+ ],
+ // Shipped in shell/. Loaded when the initial navigation fails, so a
+ // launch on the subway shows a designed screen instead of the WebKit
+ // "cannot open page" error.
+ errorPath: 'offline.html',
+ },
+ ios: {
+ // The generated Xcode project lives at ios/native/App rather than the
+ // default ios/ios/App, which would read as a typo in the repo tree.
+ path: 'native',
+ // The WebGL surfaces (/create, /ar/studio, /walk, /play) all render into
+ // full-bleed canvases and paint their own safe-area padding; letting the
+ // WebView run under the status bar is what makes them look native.
+ contentInset: 'never',
+ // three.ws is a dark product. A white flash between splash and first
+ // paint is the single most obvious "this is a website" tell.
+ backgroundColor: '#080814',
+ scrollEnabled: true,
+ limitsNavigationsToAppBoundDomains: false,
+ },
+ plugins: {
+ SplashScreen: {
+ launchAutoHide: false,
+ backgroundColor: '#080814',
+ showSpinner: false,
+ },
+ PushNotifications: {
+ presentationOptions: ['badge', 'sound', 'alert'],
+ },
+ },
+};
+
+export default config;
diff --git a/ios/docs/ASSETS.md b/ios/docs/ASSETS.md
new file mode 100644
index 000000000..99c5f0c7a
--- /dev/null
+++ b/ios/docs/ASSETS.md
@@ -0,0 +1,59 @@
+# iOS app assets
+
+What Xcode and App Store Connect refuse to build or accept without. Sizes are
+exact; Apple rejects a mismatched pixel dimension and an icon with an alpha
+channel.
+
+Source art lives with the rest of the brand marks in [`../../public/`](../../public):
+`pwa-icon.svg` is the vector master, and `pwa-maskable-512x512.png` shows the
+safe-zone framing the Android app uses.
+
+## App icon
+
+Xcode 15+ takes a single 1024x1024 PNG and derives the rest.
+
+| Slot | Size | Rules |
+|---|---|---|
+| App Store / universal | 1024x1024 | **No alpha channel**, no transparency, no rounded corners. iOS applies the mask. sRGB. |
+
+Optional and worth doing, since the product is dark-only: supply the dark and
+tinted variants in the same asset set so the icon does not glare on a dark home
+screen.
+
+Drop it into `native/App/App/Assets.xcassets/AppIcon.appiconset/`. Capacitor's
+template icon is what is there now, and an archive with it will upload but must
+not ship.
+
+## Launch screen
+
+`native/App/App/Base.lproj/LaunchScreen.storyboard`. It should be the brand mark
+on `#080814`, matching `backgroundColor` in `capacitor.config.ts` and the
+`--bg` in `shell/offline.html`. Any mismatch reads as a flash.
+
+The launch screen is static by definition: no logic, no network, no text that
+needs localizing.
+
+## Screenshots
+
+Required for the listing. App Store Connect accepts one set and scales it to
+the other sizes, so produce the largest:
+
+| Device class | Size (portrait) | Count |
+|---|---|---|
+| iPhone 6.9" (15/16 Pro Max) | 1320x2868 | 3 to 10 |
+| iPad Pro 13" (only if the listing includes iPad) | 2064x2752 | 3 to 10 |
+
+Capture on a real device, not the simulator: the AR and camera surfaces are the
+most convincing frames in the set and the simulator cannot produce them. A
+strong order is `/create` mid-generation, the finished avatar in the viewer, an
+agent placed in a real room via `/ar/studio`, `/irl` discovery, and a profile.
+
+## App preview video (optional)
+
+15 to 30 seconds, same resolutions as the screenshots, captured on device. The
+AR placement flow is the obvious subject.
+
+## Metadata art
+
+None. Unlike the Solana dApp Store, App Store Connect has no banner or feature
+graphic; the icon and screenshots are the whole visual listing.
diff --git a/ios/docs/REVIEW-RISK.md b/ios/docs/REVIEW-RISK.md
new file mode 100644
index 000000000..254677d87
--- /dev/null
+++ b/ios/docs/REVIEW-RISK.md
@@ -0,0 +1,109 @@
+# App Review risk for three.ws on iOS
+
+Written before submission, from Apple's published App Review Guidelines. Every
+claim here is about a rule, not a prediction; where a rule is ambiguous that is
+said plainly. Re-read it before changing anything in `capacitor.config.ts`, the
+entitlements, or the crypto surfaces, because those are the three places where a
+small change flips a version-1 approval into a rejection.
+
+The short version: **the code is not the long pole. The account type and the
+crypto surfaces are.**
+
+## 1. Guideline 3.1.5(b) and 3.1.1: crypto. The real gate.
+
+Apple's rules for cryptocurrency, in the order they bite:
+
+**Wallets are organization-only.** Apps may facilitate virtual currency storage
+"provided they are offered by developers enrolled as an organization." three.ws
+gives every agent a wallet and every user a way to hold and move value, so an
+**Individual** Apple Developer account cannot ship it. Enrolling as an
+organization requires a legal entity and a D-U-N-S number, and the D-U-N-S
+lookup or request is the step that most often takes a week or more. **Start this
+before anything else; nothing downstream can be compressed to make up for it.**
+
+**Exchange functionality is licensing-gated.** Apps may facilitate
+cryptocurrency transactions "on an approved exchange, provided they are offered
+only in countries or regions where the app has appropriate licensing and
+permissions." three.ws's swap, trade and pump.fun launch surfaces are the
+exposure here. Submitting version 1 with in-app token launching and trading
+invites a rejection that asks for licensing documentation we do not have.
+
+**Unlocking features with crypto is prohibited.** Anything on the platform where
+paying in $THREE, USDC or an x402 call unlocks app functionality collides with
+3.1.1: digital content and features consumed in the app must use in-app
+purchase. Reading data, viewing holdings and viewing an agent's on-chain history
+are fine. Buying a generation credit with USDC inside the app is not.
+
+**What that implies for version 1.** Ship the creation and spatial product, and
+route the value-moving surfaces to Safari rather than removing them:
+
+| Ships in the app | Opens in Safari |
+|---|---|
+| `/create`, the forge, avatar and model generation | `/trade`, swaps, bridges |
+| `/ar`, `/ar/studio`, `/irl`, the viewer, Quick Look | pump.fun launching |
+| Agent profiles, `/marketplace` browsing, `/community`, `/feed` | Buying credits or paid generations |
+| Talk mode, animation, rigging, exports | Wallet funding and withdrawal |
+| Read-only wallet and portfolio views | x402 payment flows |
+
+`src/native-bridge.js` already sends every off-site link to an in-app Safari
+sheet; the remaining work is a `data-external` opt-out on the same-origin
+surfaces above so they take that path too. That is a small, reversible change,
+and it is the difference between a review conversation and a rejection.
+
+## 2. Guideline 4.2: minimum functionality.
+
+A WebView pointed at a website is rejected as "a bookmark." The mitigation is
+that the app does things the website cannot, and that they are visible in the
+first minute of use. What is already in place:
+
+- Camera, microphone, photo library, location and motion, each behind a real
+ system permission prompt with a real usage string.
+- The native share sheet, replacing a Web Share API that does not exist in
+ WKWebView.
+- Universal links: a shared `/viewer` or `/irl/s/` link opens the app.
+- Wallet deep links back into the app via `threews://`.
+- A designed offline screen that recovers on its own.
+- Haptics.
+
+That is a defensible 4.2 position and not a certain one. The two additions that
+move it from defensible to comfortable, in order of effect per unit of work:
+
+1. **A Share Extension.** Share a photo from Photos or a GLB from Files
+ straight into avatar creation. The Android app already has this through the
+ web manifest `share_target`; iOS needs a real extension target. It is the
+ single most convincing "this is an app" feature available here.
+2. **A WidgetKit widget.** Your agents on the home screen, refreshed from the
+ API. Nothing about it is possible on the web.
+
+Push notifications count for 4.2 as well and are half-wired (entitlement and
+background mode present, APNs key and token endpoint absent).
+
+## 3. Guideline 5.1.1: permissions and account deletion.
+
+- Every usage string in `Info.plist` says what the data is for in the user's
+ terms. Requesting a permission the app never uses is itself a rejection, so
+ do not add usage strings speculatively.
+- **Account deletion must be reachable in-app.** Apps that support account
+ creation must offer account deletion. Verify the existing account settings
+ path exposes it before submitting; this one is checked mechanically by
+ reviewers and is a common, avoidable rejection.
+- Sign in with Apple is required only if the app offers third-party social
+ login as the *only* sign-in option. Confirm which providers the login sheet
+ offers before assuming it is not needed.
+
+## 4. Guideline 2.5.1 and 4.7: WebView posture.
+
+`limitsNavigationsToAppBoundDomains` is `false` in `capacitor.config.ts`,
+which is required because the app navigates to wallet and OAuth domains.
+`server.allowNavigation` is restricted to three.ws hosts, so anything else goes
+through the Safari sheet rather than the app's WebView. Keep it that way:
+running third-party sign-in inside an embedded WebView is both a review problem
+and a security one.
+
+## 5. What is not a risk here.
+
+- **AR.** ARKit Quick Look and WebXR usage are ordinary and uncontroversial.
+- **User-generated 3D content.** Standard UGC moderation expectations apply
+ (report, block, terms), and the platform already has moderation surfaces.
+- **Export compliance.** `ITSAppUsesNonExemptEncryption` is `false` in
+ `Info.plist`: HTTPS and platform crypto only, which is the exempt case.
diff --git a/ios/docs/SUBMISSION.md b/ios/docs/SUBMISSION.md
new file mode 100644
index 000000000..57ccc00ed
--- /dev/null
+++ b/ios/docs/SUBMISSION.md
@@ -0,0 +1,132 @@
+# Shipping three.ws to the App Store
+
+End-to-end, in the order the steps actually unblock each other. Everything
+before "On a Mac" can be done from this repo on any machine; everything after
+needs macOS with Xcode, because Apple's code signing and `altool` upload path
+exist nowhere else.
+
+Read [`REVIEW-RISK.md`](REVIEW-RISK.md) first. Step 1 is the long pole and does
+not depend on any code, so start it the day this is decided.
+
+## 1. Apple Developer Program, enrolled as an organization
+
+Not as an individual. Apple only allows crypto wallet functionality from
+organization accounts, and three.ws has wallets everywhere.
+
+- $99/yr, renewed annually.
+- Needs a legal entity and a **D-U-N-S number** for that entity. Look it up at
+ Apple's D-U-N-S lookup tool first; if the entity has one, enrollment is
+ typically days. If it does not, requesting one is the step that can take a
+ week or more, and nothing else can absorb that delay.
+- The person enrolling must have legal authority to bind the entity, or provide
+ documentation of authorization.
+
+Record the **Team ID** (10 characters) the moment it exists: everything in
+step 3 is blocked on it.
+
+## 2. App Store Connect setup
+
+1. Create the app record. Bundle ID `ws.three.app`, matching
+ `PRODUCT_BUNDLE_IDENTIFIER` in `native/App/App.xcodeproj/project.pbxproj`
+ and the `appId` in `capacitor.config.ts`.
+2. Register the bundle ID in the Developer portal with the **Associated
+ Domains** and **Push Notifications** capabilities enabled; the app's
+ entitlements declare both and signing fails without them.
+3. Fill the listing from [`../publish/listing.md`](../publish/listing.md).
+4. Answer the content rights, age rating, and privacy questionnaires. The
+ privacy answers must match what the app actually collects; the camera,
+ photos, location and identifiers sections all apply.
+
+## 3. Wire the Team ID into production
+
+```bash
+gcloud run services update three-ws-api \
+ --region us-central1 --project aerial-vehicle-466722-p5 \
+ --update-env-vars APPLE_TEAM_ID=<team id>
+```
+
+`--update-env-vars` merges. Never `--set-env-vars`, which replaces the whole
+environment.
+
+Then verify Apple can read the association, because a wrong answer here fails
+silently on device and links simply keep opening in Safari:
+
+```bash
+curl -sS -D- -o- https://three.ws/.well-known/apple-app-site-association
+```
+
+It must be `200`, `content-type: application/json`, **no redirect**, and the
+`appIDs` entry must read `<team id>.ws.three.app`.
+
+## 4. Build the web bundle
+
+The app's WebView loads the deployed site, so "building the app" means the site
+is deployed. The one build-time coupling is `src/native-bridge.js`, which is
+injected into every page by the `three-ws-ios-native-bridge` plugin in
+`vite.config.js`; a deploy that predates that plugin gives the app no native
+behaviour at all. Confirm it landed:
+
+```bash
+grep -c native-bridge dist/create.html # expect 1
+```
+
+Then sync the shell bundle into the Xcode project:
+
+```bash
+cd ios && npm install && npm run sync
+```
+
+## 5. On a Mac: archive, sign, upload
+
+```bash
+cd ios && npm run open # opens native/App/App.xcworkspace
+```
+
+In Xcode:
+
+1. Select the **App** target, Signing & Capabilities, choose the team. Confirm
+ Associated Domains lists `applinks:three.ws` and Push Notifications is
+ present; both come from `App/App.entitlements`.
+2. Set the marketing version and build number. `MARKETING_VERSION` is `1.0`
+ and `CURRENT_PROJECT_VERSION` is `1` in the project file; the build number
+ must increase on every upload.
+3. Replace the placeholder app icon in `App/Assets.xcassets` per
+ [`ASSETS.md`](ASSETS.md). Xcode rejects an archive with a missing icon.
+4. Product > Archive, then Distribute App > App Store Connect > Upload.
+
+Headless alternative once signing is configured, for a Mac build machine or
+Xcode Cloud:
+
+```bash
+xcodebuild -workspace native/App/App.xcworkspace -scheme App \
+ -configuration Release -archivePath build/App.xcarchive archive
+xcodebuild -exportArchive -archivePath build/App.xcarchive \
+ -exportOptionsPlist ExportOptions.plist -exportPath build/export
+```
+
+`ExportOptions.plist` does not exist yet; it needs the real team ID and
+provisioning profile name, so it is written at the same time as step 1.
+
+## 6. TestFlight, then review
+
+- The first upload takes 15 to 60 minutes to finish processing before it is
+ testable.
+- Internal TestFlight testers need no review. External testers need a
+ Beta App Review, usually a day.
+- App Review itself is typically 24 to 48 hours for a first submission, and
+ can be longer when a reviewer opens a question. Budget for at least one
+ round trip: assume the first response is a question about the crypto
+ surfaces and have the answer from [`REVIEW-RISK.md`](REVIEW-RISK.md) ready.
+
+## Verification checklist before submitting
+
+- [ ] `curl https://three.ws/.well-known/apple-app-site-association` returns a real association
+- [ ] A shared `https://three.ws/viewer?src=...` link opens the app, not Safari
+- [ ] Camera prompt appears on `/create/selfie` with the string from `Info.plist`
+- [ ] Location prompt appears on `/irl`
+- [ ] Share on an AR capture opens the system share sheet with the image attached
+- [ ] Airplane mode at launch shows `shell/offline.html`, and it recovers by itself when the network returns
+- [ ] An off-site link opens the Safari sheet and returns to the app
+- [ ] Account deletion is reachable in-app (guideline 5.1.1)
+- [ ] No white flash between launch screen and first paint
+- [ ] Value-moving surfaces open in Safari, per `REVIEW-RISK.md`
diff --git a/ios/native/.gitignore b/ios/native/.gitignore
new file mode 100644
index 000000000..f47029973
--- /dev/null
+++ b/ios/native/.gitignore
@@ -0,0 +1,13 @@
+App/build
+App/Pods
+App/output
+App/App/public
+DerivedData
+xcuserdata
+
+# Cordova plugins for Capacitor
+capacitor-cordova-ios-plugins
+
+# Generated Config files
+App/App/capacitor.config.json
+App/App/config.xml
diff --git a/ios/native/App/App.xcodeproj/project.pbxproj b/ios/native/App/App.xcodeproj/project.pbxproj
new file mode 100644
index 000000000..e7922dbeb
--- /dev/null
+++ b/ios/native/App/App.xcodeproj/project.pbxproj
@@ -0,0 +1,382 @@
+// !$*UTF8*$!
+{
+ archiveVersion = 1;
+ classes = {
+ };
+ objectVersion = 60;
+ objects = {
+
+/* Begin PBXBuildFile section */
+ 2FAD9763203C412B000D30F8 /* config.xml in Resources */ = {isa = PBXBuildFile; fileRef = 2FAD9762203C412B000D30F8 /* config.xml */; };
+ 4D22ABE92AF431CB00220026 /* CapApp-SPM in Frameworks */ = {isa = PBXBuildFile; productRef = 4D22ABE82AF431CB00220026 /* CapApp-SPM */; };
+ 50379B232058CBB4000EE86E /* capacitor.config.json in Resources */ = {isa = PBXBuildFile; fileRef = 50379B222058CBB4000EE86E /* capacitor.config.json */; };
+ 504EC3081FED79650016851F /* AppDelegate.swift in Sources */ = {isa = PBXBuildFile; fileRef = 504EC3071FED79650016851F /* AppDelegate.swift */; };
+ 504EC30D1FED79650016851F /* Main.storyboard in Resources */ = {isa = PBXBuildFile; fileRef = 504EC30B1FED79650016851F /* Main.storyboard */; };
+ 504EC30F1FED79650016851F /* Assets.xcassets in Resources */ = {isa = PBXBuildFile; fileRef = 504EC30E1FED79650016851F /* Assets.xcassets */; };
+ 504EC3121FED79650016851F /* LaunchScreen.storyboard in Resources */ = {isa = PBXBuildFile; fileRef = 504EC3101FED79650016851F /* LaunchScreen.storyboard */; };
+ 50B271D11FEDC1A000F3C39B /* public in Resources */ = {isa = PBXBuildFile; fileRef = 50B271D01FEDC1A000F3C39B /* public */; };
+ 9582B6832FE993A70072D4E8 /* SceneDelegate.swift in Sources */ = {isa = PBXBuildFile; fileRef = 9582B6822FE993A50072D4E8 /* SceneDelegate.swift */; };
+/* End PBXBuildFile section */
+
+/* Begin PBXFileReference section */
+ 2FAD9762203C412B000D30F8 /* config.xml */ = {isa = PBXFileReference; lastKnownFileType = text.xml; path = config.xml; sourceTree = "<group>"; };
+ 50379B222058CBB4000EE86E /* capacitor.config.json */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = text.json; path = capacitor.config.json; sourceTree = "<group>"; };
+ 504EC3041FED79650016851F /* App.app */ = {isa = PBXFileReference; explicitFileType = wrapper.application; includeInIndex = 0; path = App.app; sourceTree = BUILT_PRODUCTS_DIR; };
+ 504EC3071FED79650016851F /* AppDelegate.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = AppDelegate.swift; sourceTree = "<group>"; };
+ 504EC30C1FED79650016851F /* Base */ = {isa = PBXFileReference; lastKnownFileType = file.storyboard; name = Base; path = Base.lproj/Main.storyboard; sourceTree = "<group>"; };
+ 504EC30E1FED79650016851F /* Assets.xcassets */ = {isa = PBXFileReference; lastKnownFileType = folder.assetcatalog; path = Assets.xcassets; sourceTree = "<group>"; };
+ 504EC3111FED79650016851F /* Base */ = {isa = PBXFileReference; lastKnownFileType = file.storyboard; name = Base; path = Base.lproj/LaunchScreen.storyboard; sourceTree = "<group>"; };
+ 504EC3131FED79650016851F /* Info.plist */ = {isa = PBXFileReference; lastKnownFileType = text.plist.xml; path = Info.plist; sourceTree = "<group>"; };
+ 50B271D01FEDC1A000F3C39B /* public */ = {isa = PBXFileReference; lastKnownFileType = folder; path = public; sourceTree = "<group>"; };
+ 9582B6822FE993A50072D4E8 /* SceneDelegate.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = SceneDelegate.swift; sourceTree = "<group>"; };
+ 958DCC722DB07C7200EA8C5F /* debug.xcconfig */ = {isa = PBXFileReference; lastKnownFileType = text.xcconfig; name = debug.xcconfig; path = ../debug.xcconfig; sourceTree = SOURCE_ROOT; };
+/* End PBXFileReference section */
+
+/* Begin PBXFrameworksBuildPhase section */
+ 504EC3011FED79650016851F /* Frameworks */ = {
+ isa = PBXFrameworksBuildPhase;
+ buildActionMask = 2147483647;
+ files = (
+ 4D22ABE92AF431CB00220026 /* CapApp-SPM in Frameworks */,
+ );
+ runOnlyForDeploymentPostprocessing = 0;
+ };
+/* End PBXFrameworksBuildPhase section */
+
+/* Begin PBXGroup section */
+ 504EC2FB1FED79650016851F = {
+ isa = PBXGroup;
+ children = (
+ 958DCC722DB07C7200EA8C5F /* debug.xcconfig */,
+ 504EC3061FED79650016851F /* App */,
+ 504EC3051FED79650016851F /* Products */,
+ );
+ sourceTree = "<group>";
+ };
+ 504EC3051FED79650016851F /* Products */ = {
+ isa = PBXGroup;
+ children = (
+ 504EC3041FED79650016851F /* App.app */,
+ );
+ name = Products;
+ sourceTree = "<group>";
+ };
+ 504EC3061FED79650016851F /* App */ = {
+ isa = PBXGroup;
+ children = (
+ 9582B6822FE993A50072D4E8 /* SceneDelegate.swift */,
+ 50379B222058CBB4000EE86E /* capacitor.config.json */,
+ 504EC3071FED79650016851F /* AppDelegate.swift */,
+ 504EC30B1FED79650016851F /* Main.storyboard */,
+ 504EC30E1FED79650016851F /* Assets.xcassets */,
+ 504EC3101FED79650016851F /* LaunchScreen.storyboard */,
+ 504EC3131FED79650016851F /* Info.plist */,
+ 2FAD9762203C412B000D30F8 /* config.xml */,
+ 50B271D01FEDC1A000F3C39B /* public */,
+ );
+ path = App;
+ sourceTree = "<group>";
+ };
+/* End PBXGroup section */
+
+/* Begin PBXNativeTarget section */
+ 504EC3031FED79650016851F /* App */ = {
+ isa = PBXNativeTarget;
+ buildConfigurationList = 504EC3161FED79650016851F /* Build configuration list for PBXNativeTarget "App" */;
+ buildPhases = (
+ 504EC3001FED79650016851F /* Sources */,
+ 504EC3011FED79650016851F /* Frameworks */,
+ 504EC3021FED79650016851F /* Resources */,
+ );
+ buildRules = (
+ );
+ dependencies = (
+ );
+ name = App;
+ packageProductDependencies = (
+ 4D22ABE82AF431CB00220026 /* CapApp-SPM */,
+ );
+ productName = App;
+ productReference = 504EC3041FED79650016851F /* App.app */;
+ productType = "com.apple.product-type.application";
+ };
+/* End PBXNativeTarget section */
+
+/* Begin PBXProject section */
+ 504EC2FC1FED79650016851F /* Project object */ = {
+ isa = PBXProject;
+ attributes = {
+ LastSwiftUpdateCheck = 0920;
+ LastUpgradeCheck = 0920;
+ TargetAttributes = {
+ 504EC3031FED79650016851F = {
+ CreatedOnToolsVersion = 9.2;
+ LastSwiftMigration = 1100;
+ ProvisioningStyle = Automatic;
+ };
+ };
+ };
+ buildConfigurationList = 504EC2FF1FED79650016851F /* Build configuration list for PBXProject "App" */;
+ compatibilityVersion = "Xcode 8.0";
+ developmentRegion = en;
+ hasScannedForEncodings = 0;
+ knownRegions = (
+ en,
+ Base,
+ );
+ mainGroup = 504EC2FB1FED79650016851F;
+ packageReferences = (
+ D4C12C0A2AAA248700AAC8A2 /* XCLocalSwiftPackageReference "CapApp-SPM" */,
+ );
+ productRefGroup = 504EC3051FED79650016851F /* Products */;
+ projectDirPath = "";
+ projectRoot = "";
+ targets = (
+ 504EC3031FED79650016851F /* App */,
+ );
+ };
+/* End PBXProject section */
+
+/* Begin PBXResourcesBuildPhase section */
+ 504EC3021FED79650016851F /* Resources */ = {
+ isa = PBXResourcesBuildPhase;
+ buildActionMask = 2147483647;
+ files = (
+ 504EC3121FED79650016851F /* LaunchScreen.storyboard in Resources */,
+ 50B271D11FEDC1A000F3C39B /* public in Resources */,
+ 504EC30F1FED79650016851F /* Assets.xcassets in Resources */,
+ 50379B232058CBB4000EE86E /* capacitor.config.json in Resources */,
+ 504EC30D1FED79650016851F /* Main.storyboard in Resources */,
+ 2FAD9763203C412B000D30F8 /* config.xml in Resources */,
+ );
+ runOnlyForDeploymentPostprocessing = 0;
+ };
+/* End PBXResourcesBuildPhase section */
+
+/* Begin PBXSourcesBuildPhase section */
+ 504EC3001FED79650016851F /* Sources */ = {
+ isa = PBXSourcesBuildPhase;
+ buildActionMask = 2147483647;
+ files = (
+ 504EC3081FED79650016851F /* AppDelegate.swift in Sources */,
+ 9582B6832FE993A70072D4E8 /* SceneDelegate.swift in Sources */,
+ );
+ runOnlyForDeploymentPostprocessing = 0;
+ };
+/* End PBXSourcesBuildPhase section */
+
+/* Begin PBXVariantGroup section */
+ 504EC30B1FED79650016851F /* Main.storyboard */ = {
+ isa = PBXVariantGroup;
+ children = (
+ 504EC30C1FED79650016851F /* Base */,
+ );
+ name = Main.storyboard;
+ sourceTree = "<group>";
+ };
+ 504EC3101FED79650016851F /* LaunchScreen.storyboard */ = {
+ isa = PBXVariantGroup;
+ children = (
+ 504EC3111FED79650016851F /* Base */,
+ );
+ name = LaunchScreen.storyboard;
+ sourceTree = "<group>";
+ };
+/* End PBXVariantGroup section */
+
+/* Begin XCBuildConfiguration section */
+ 504EC3141FED79650016851F /* Debug */ = {
+ isa = XCBuildConfiguration;
+ baseConfigurationReference = 958DCC722DB07C7200EA8C5F /* debug.xcconfig */;
+ buildSettings = {
+ ALWAYS_SEARCH_USER_PATHS = NO;
+ CLANG_ANALYZER_NONNULL = YES;
+ CLANG_ANALYZER_NUMBER_OBJECT_CONVERSION = YES_AGGRESSIVE;
+ CLANG_CXX_LANGUAGE_STANDARD = "gnu++14";
+ CLANG_CXX_LIBRARY = "libc++";
+ CLANG_ENABLE_MODULES = YES;
+ CLANG_ENABLE_OBJC_ARC = YES;
+ CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES;
+ CLANG_WARN_BOOL_CONVERSION = YES;
+ CLANG_WARN_COMMA = YES;
+ CLANG_WARN_CONSTANT_CONVERSION = YES;
+ CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR;
+ CLANG_WARN_DOCUMENTATION_COMMENTS = YES;
+ CLANG_WARN_EMPTY_BODY = YES;
+ CLANG_WARN_ENUM_CONVERSION = YES;
+ CLANG_WARN_INFINITE_RECURSION = YES;
+ CLANG_WARN_INT_CONVERSION = YES;
+ CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES;
+ CLANG_WARN_OBJC_LITERAL_CONVERSION = YES;
+ CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR;
+ CLANG_WARN_RANGE_LOOP_ANALYSIS = YES;
+ CLANG_WARN_STRICT_PROTOTYPES = YES;
+ CLANG_WARN_SUSPICIOUS_MOVE = YES;
+ CLANG_WARN_UNGUARDED_AVAILABILITY = YES_AGGRESSIVE;
+ CLANG_WARN_UNREACHABLE_CODE = YES;
+ CLANG_WARN__DUPLICATE_METHOD_MATCH = YES;
+ CODE_SIGN_IDENTITY = "iPhone Developer";
+ COPY_PHASE_STRIP = NO;
+ DEBUG_INFORMATION_FORMAT = dwarf;
+ ENABLE_STRICT_OBJC_MSGSEND = YES;
+ ENABLE_TESTABILITY = YES;
+ GCC_C_LANGUAGE_STANDARD = gnu11;
+ GCC_DYNAMIC_NO_PIC = NO;
+ GCC_NO_COMMON_BLOCKS = YES;
+ GCC_OPTIMIZATION_LEVEL = 0;
+ GCC_PREPROCESSOR_DEFINITIONS = (
+ "DEBUG=1",
+ "$(inherited)",
+ );
+ GCC_WARN_64_TO_32_BIT_CONVERSION = YES;
+ GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR;
+ GCC_WARN_UNDECLARED_SELECTOR = YES;
+ GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
+ GCC_WARN_UNUSED_FUNCTION = YES;
+ GCC_WARN_UNUSED_VARIABLE = YES;
+ IPHONEOS_DEPLOYMENT_TARGET = 16.0;
+ MTL_ENABLE_DEBUG_INFO = YES;
+ ONLY_ACTIVE_ARCH = YES;
+ SDKROOT = iphoneos;
+ SWIFT_ACTIVE_COMPILATION_CONDITIONS = DEBUG;
+ SWIFT_OPTIMIZATION_LEVEL = "-Onone";
+ };
+ name = Debug;
+ };
+ 504EC3151FED79650016851F /* Release */ = {
+ isa = XCBuildConfiguration;
+ buildSettings = {
+ ALWAYS_SEARCH_USER_PATHS = NO;
+ CLANG_ANALYZER_NONNULL = YES;
+ CLANG_ANALYZER_NUMBER_OBJECT_CONVERSION = YES_AGGRESSIVE;
+ CLANG_CXX_LANGUAGE_STANDARD = "gnu++14";
+ CLANG_CXX_LIBRARY = "libc++";
+ CLANG_ENABLE_MODULES = YES;
+ CLANG_ENABLE_OBJC_ARC = YES;
+ CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES;
+ CLANG_WARN_BOOL_CONVERSION = YES;
+ CLANG_WARN_COMMA = YES;
+ CLANG_WARN_CONSTANT_CONVERSION = YES;
+ CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR;
+ CLANG_WARN_DOCUMENTATION_COMMENTS = YES;
+ CLANG_WARN_EMPTY_BODY = YES;
+ CLANG_WARN_ENUM_CONVERSION = YES;
+ CLANG_WARN_INFINITE_RECURSION = YES;
+ CLANG_WARN_INT_CONVERSION = YES;
+ CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES;
+ CLANG_WARN_OBJC_LITERAL_CONVERSION = YES;
+ CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR;
+ CLANG_WARN_RANGE_LOOP_ANALYSIS = YES;
+ CLANG_WARN_STRICT_PROTOTYPES = YES;
+ CLANG_WARN_SUSPICIOUS_MOVE = YES;
+ CLANG_WARN_UNGUARDED_AVAILABILITY = YES_AGGRESSIVE;
+ CLANG_WARN_UNREACHABLE_CODE = YES;
+ CLANG_WARN__DUPLICATE_METHOD_MATCH = YES;
+ CODE_SIGN_IDENTITY = "iPhone Developer";
+ COPY_PHASE_STRIP = NO;
+ DEBUG_INFORMATION_FORMAT = "dwarf-with-dsym";
+ ENABLE_NS_ASSERTIONS = NO;
+ ENABLE_STRICT_OBJC_MSGSEND = YES;
+ GCC_C_LANGUAGE_STANDARD = gnu11;
+ GCC_NO_COMMON_BLOCKS = YES;
+ GCC_WARN_64_TO_32_BIT_CONVERSION = YES;
+ GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR;
+ GCC_WARN_UNDECLARED_SELECTOR = YES;
+ GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
+ GCC_WARN_UNUSED_FUNCTION = YES;
+ GCC_WARN_UNUSED_VARIABLE = YES;
+ IPHONEOS_DEPLOYMENT_TARGET = 16.0;
+ MTL_ENABLE_DEBUG_INFO = NO;
+ SDKROOT = iphoneos;
+ SWIFT_COMPILATION_MODE = wholemodule;
+ SWIFT_OPTIMIZATION_LEVEL = "-O";
+ VALIDATE_PRODUCT = YES;
+ };
+ name = Release;
+ };
+ 504EC3171FED79650016851F /* Debug */ = {
+ isa = XCBuildConfiguration;
+ baseConfigurationReference = 958DCC722DB07C7200EA8C5F /* debug.xcconfig */;
+ buildSettings = {
+ ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
+ CODE_SIGN_STYLE = Automatic;
+ CODE_SIGN_ENTITLEMENTS = App/App.entitlements;
+ CURRENT_PROJECT_VERSION = 1;
+ INFOPLIST_FILE = App/Info.plist;
+ IPHONEOS_DEPLOYMENT_TARGET = 16.0;
+ LD_RUNPATH_SEARCH_PATHS = (
+ "$(inherited)",
+ "@executable_path/Frameworks",
+ );
+ MARKETING_VERSION = 1.0;
+ OTHER_SWIFT_FLAGS = "$(inherited) \"-D\" \"COCOAPODS\" \"-DDEBUG\"";
+ PRODUCT_BUNDLE_IDENTIFIER = ws.three.app;
+ PRODUCT_NAME = "$(TARGET_NAME)";
+ SWIFT_ACTIVE_COMPILATION_CONDITIONS = DEBUG;
+ SWIFT_VERSION = 5.0;
+ TARGETED_DEVICE_FAMILY = "1,2";
+ };
+ name = Debug;
+ };
+ 504EC3181FED79650016851F /* Release */ = {
+ isa = XCBuildConfiguration;
+ buildSettings = {
+ ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
+ CODE_SIGN_STYLE = Automatic;
+ CODE_SIGN_ENTITLEMENTS = App/App.entitlements;
+ CURRENT_PROJECT_VERSION = 1;
+ INFOPLIST_FILE = App/Info.plist;
+ IPHONEOS_DEPLOYMENT_TARGET = 16.0;
+ LD_RUNPATH_SEARCH_PATHS = (
+ "$(inherited)",
+ "@executable_path/Frameworks",
+ );
+ MARKETING_VERSION = 1.0;
+ PRODUCT_BUNDLE_IDENTIFIER = ws.three.app;
+ PRODUCT_NAME = "$(TARGET_NAME)";
+ SWIFT_ACTIVE_COMPILATION_CONDITIONS = "";
+ SWIFT_VERSION = 5.0;
+ TARGETED_DEVICE_FAMILY = "1,2";
+ };
+ name = Release;
+ };
+/* End XCBuildConfiguration section */
+
+/* Begin XCConfigurationList section */
+ 504EC2FF1FED79650016851F /* Build configuration list for PBXProject "App" */ = {
+ isa = XCConfigurationList;
+ buildConfigurations = (
+ 504EC3141FED79650016851F /* Debug */,
+ 504EC3151FED79650016851F /* Release */,
+ );
+ defaultConfigurationIsVisible = 0;
+ defaultConfigurationName = Release;
+ };
+ 504EC3161FED79650016851F /* Build configuration list for PBXNativeTarget "App" */ = {
+ isa = XCConfigurationList;
+ buildConfigurations = (
+ 504EC3171FED79650016851F /* Debug */,
+ 504EC3181FED79650016851F /* Release */,
+ );
+ defaultConfigurationIsVisible = 0;
+ defaultConfigurationName = Release;
+ };
+/* End XCConfigurationList section */
+
+/* Begin XCLocalSwiftPackageReference section */
+ D4C12C0A2AAA248700AAC8A2 /* XCLocalSwiftPackageReference "CapApp-SPM" */ = {
+ isa = XCLocalSwiftPackageReference;
+ relativePath = "CapApp-SPM";
+ };
+/* End XCLocalSwiftPackageReference section */
+
+/* Begin XCSwiftPackageProductDependency section */
+ 4D22ABE82AF431CB00220026 /* CapApp-SPM */ = {
+ isa = XCSwiftPackageProductDependency;
+ package = D4C12C0A2AAA248700AAC8A2 /* XCLocalSwiftPackageReference "CapApp-SPM" */;
+ productName = "CapApp-SPM";
+ };
+/* End XCSwiftPackageProductDependency section */
+ };
+ rootObject = 504EC2FC1FED79650016851F /* Project object */;
+}
diff --git a/ios/native/App/App.xcodeproj/project.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist b/ios/native/App/App.xcodeproj/project.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist
new file mode 100644
index 000000000..18d981003
--- /dev/null
+++ b/ios/native/App/App.xcodeproj/project.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+ <key>IDEDidComputeMac32BitWarning</key>
+ <true/>
+</dict>
+</plist>
diff --git a/ios/native/App/App/App.entitlements b/ios/native/App/App/App.entitlements
new file mode 100644
index 000000000..733fb1d30
--- /dev/null
+++ b/ios/native/App/App/App.entitlements
@@ -0,0 +1,28 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+ <!--
+ Universal links. Every https://three.ws link the app can handle opens in
+ the app instead of Safari, which is what makes a shared /viewer, /irl/s/
+ or /avatars/ link land on an installed app. Paired with
+ public/.well-known/apple-app-site-association, which Apple's CDN fetches
+ over TLS with no redirects; if that file 404s or is served with the wrong
+ content type, links silently keep opening in Safari and nothing errors.
+ -->
+ <key>com.apple.developer.associated-domains</key>
+ <array>
+ <string>applinks:three.ws</string>
+ <string>applinks:www.three.ws</string>
+ <!-- Password AutoFill for the three.ws login form inside the WebView. -->
+ <string>webcredentials:three.ws</string>
+ </array>
+
+ <!--
+ APNs. Xcode rewrites this to "production" on an App Store / TestFlight
+ archive; "development" is what a device build off a personal team needs.
+ -->
+ <key>aps-environment</key>
+ <string>development</string>
+</dict>
+</plist>
diff --git a/ios/native/App/App/AppDelegate.swift b/ios/native/App/App/AppDelegate.swift
new file mode 100644
index 000000000..fec95acae
--- /dev/null
+++ b/ios/native/App/App/AppDelegate.swift
@@ -0,0 +1,44 @@
+import UIKit
+import Capacitor
+
+@UIApplicationMain
+class AppDelegate: UIResponder, UIApplicationDelegate {
+
+ var window: UIWindow?
+
+ func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
+ // Override point for customization after application launch.
+ return true
+ }
+
+ func applicationWillResignActive(_ application: UIApplication) {
+ // Sent when the application is about to move from active to inactive state. This can occur for certain types of temporary interruptions (such as an incoming phone call or SMS message) or when the user quits the application and it begins the transition to the background state.
+ // Use this method to pause ongoing tasks, disable timers, and invalidate graphics rendering callbacks. Games should use this method to pause the game.
+ }
+
+ func applicationDidEnterBackground(_ application: UIApplication) {
+ // Use this method to release shared resources, save user data, invalidate timers, and store enough application state information to restore your application to its current state in case it is terminated later.
+ // If your application supports background execution, this method is called instead of applicationWillTerminate: when the user quits.
+ }
+
+ func applicationWillEnterForeground(_ application: UIApplication) {
+ // Called as part of the transition from the background to the active state; here you can undo many of the changes made on entering the background.
+ }
+
+ func applicationDidBecomeActive(_ application: UIApplication) {
+ // Restart any tasks that were paused (or not yet started) while the application was inactive. If the application was previously in the background, optionally refresh the user interface.
+ }
+
+ func applicationWillTerminate(_ application: UIApplication) {
+ // Called when the application is about to terminate. Save data if appropriate. See also applicationDidEnterBackground:.
+ }
+
+ func application(_ application: UIApplication,
+ configurationForConnecting connectingSceneSession: UISceneSession,
+ options: UIScene.ConnectionOptions) -> UISceneConfiguration {
+ let config = UISceneConfiguration(name: "Default Configuration",
+ sessionRole: connectingSceneSession.role)
+ config.delegateClass = SceneDelegate.self
+ return config
+ }
+}
diff --git a/ios/native/App/App/Assets.xcassets/AppIcon.appiconset/[email protected] b/ios/native/App/App/Assets.xcassets/AppIcon.appiconset/[email protected]
new file mode 100644
index 000000000..adf6ba01d
Binary files /dev/null and b/ios/native/App/App/Assets.xcassets/AppIcon.appiconset/[email protected] differ
diff --git a/ios/native/App/App/Assets.xcassets/AppIcon.appiconset/Contents.json b/ios/native/App/App/Assets.xcassets/AppIcon.appiconset/Contents.json
new file mode 100644
index 000000000..9b7d382dc
--- /dev/null
+++ b/ios/native/App/App/Assets.xcassets/AppIcon.appiconset/Contents.json
@@ -0,0 +1,14 @@
+{
+ "images" : [
+ {
+ "filename" : "[email protected]",
+ "idiom" : "universal",
+ "platform" : "ios",
+ "size" : "1024x1024"
+ }
+ ],
+ "info" : {
+ "author" : "xcode",
+ "version" : 1
+ }
+}
diff --git a/ios/native/App/App/Assets.xcassets/Contents.json b/ios/native/App/App/Assets.xcassets/Contents.json
new file mode 100644
index 000000000..da4a164c9
--- /dev/null
+++ b/ios/native/App/App/Assets.xcassets/Contents.json
@@ -0,0 +1,6 @@
+{
+ "info" : {
+ "version" : 1,
+ "author" : "xcode"
+ }
+}
\ No newline at end of file
diff --git a/ios/native/App/App/Assets.xcassets/Splash.imageset/Contents.json b/ios/native/App/App/Assets.xcassets/Splash.imageset/Contents.json
new file mode 100644
index 000000000..d7d96a67c
--- /dev/null
+++ b/ios/native/App/App/Assets.xcassets/Splash.imageset/Contents.json
@@ -0,0 +1,23 @@
+{
+ "images" : [
+ {
+ "idiom" : "universal",
+ "filename" : "splash-2732x2732-2.png",
+ "scale" : "1x"
+ },
+ {
+ "idiom" : "universal",
+ "filename" : "splash-2732x2732-1.png",
+ "scale" : "2x"
+ },
+ {
+ "idiom" : "universal",
+ "filename" : "splash-2732x2732.png",
+ "scale" : "3x"
+ }
+ ],
+ "info" : {
+ "version" : 1,
+ "author" : "xcode"
+ }
+}
\ No newline at end of file
diff --git a/ios/native/App/App/Assets.xcassets/Splash.imageset/splash-2732x2732-1.png b/ios/native/App/App/Assets.xcassets/Splash.imageset/splash-2732x2732-1.png
new file mode 100644
index 000000000..33ea6c970
Binary files /dev/null and b/ios/native/App/App/Assets.xcassets/Splash.imageset/splash-2732x2732-1.png differ
diff --git a/ios/native/App/App/Assets.xcassets/Splash.imageset/splash-2732x2732-2.png b/ios/native/App/App/Assets.xcassets/Splash.imageset/splash-2732x2732-2.png
new file mode 100644
index 000000000..33ea6c970
Binary files /dev/null and b/ios/native/App/App/Assets.xcassets/Splash.imageset/splash-2732x2732-2.png differ
diff --git a/ios/native/App/App/Assets.xcassets/Splash.imageset/splash-2732x2732.png b/ios/native/App/App/Assets.xcassets/Splash.imageset/splash-2732x2732.png
new file mode 100644
index 000000000..33ea6c970
Binary files /dev/null and b/ios/native/App/App/Assets.xcassets/Splash.imageset/splash-2732x2732.png differ
diff --git a/ios/native/App/App/Base.lproj/LaunchScreen.storyboard b/ios/native/App/App/Base.lproj/LaunchScreen.storyboard
new file mode 100644
index 000000000..e7ae5d780
--- /dev/null
+++ b/ios/native/App/App/Base.lproj/LaunchScreen.storyboard
@@ -0,0 +1,32 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<document type="com.apple.InterfaceBuilder3.CocoaTouch.Storyboard.XIB" version="3.0" toolsVersion="17132" targetRuntime="iOS.CocoaTouch" propertyAccessControl="none" useAutolayout="YES" launchScreen="YES" useTraitCollections="YES" useSafeAreas="YES" colorMatched="YES" initialViewController="01J-lp-oVM">
+ <device id="retina4_7" orientation="portrait" appearance="light"/>
+ <dependencies>
+ <deployment identifier="iOS"/>
+ <plugIn identifier="com.apple.InterfaceBuilder.IBCocoaTouchPlugin" version="17105"/>
+ <capability name="System colors in document resources" minToolsVersion="11.0"/>
+ <capability name="documents saved in the Xcode 8 format" minToolsVersion="8.0"/>
+ </dependencies>
+ <scenes>
+ <!--View Controller-->
+ <scene sceneID="EHf-IW-A2E">
+ <objects>
+ <viewController id="01J-lp-oVM" sceneMemberID="viewController">
+ <imageView key="view" userInteractionEnabled="NO" contentMode="scaleAspectFill" horizontalHuggingPriority="251" verticalHuggingPriority="251" image="Splash" id="snD-IY-ifK">
+ <rect key="frame" x="0.0" y="0.0" width="375" height="667"/>
+ <autoresizingMask key="autoresizingMask"/>
+ <color key="backgroundColor" systemColor="systemBackgroundColor"/>
+ </imageView>
+ </viewController>
+ <placeholder placeholderIdentifier="IBFirstResponder" id="iYj-Kq-Ea1" userLabel="First Responder" sceneMemberID="firstResponder"/>
+ </objects>
+ <point key="canvasLocation" x="53" y="375"/>
+ </scene>
+ </scenes>
+ <resources>
+ <image name="Splash" width="1366" height="1366"/>
+ <systemColor name="systemBackgroundColor">
+ <color white="1" alpha="1" colorSpace="custom" customColorSpace="genericGamma22GrayColorSpace"/>
+ </systemColor>
+ </resources>
+</document>
diff --git a/ios/native/App/App/Base.lproj/Main.storyboard b/ios/native/App/App/Base.lproj/Main.storyboard
new file mode 100644
index 000000000..b44df7be8
--- /dev/null
+++ b/ios/native/App/App/Base.lproj/Main.storyboard
@@ -0,0 +1,19 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<document type="com.apple.InterfaceBuilder3.CocoaTouch.Storyboard.XIB" version="3.0" toolsVersion="14111" targetRuntime="iOS.CocoaTouch" propertyAccessControl="none" useAutolayout="YES" useTraitCollections="YES" colorMatched="YES" initialViewController="BYZ-38-t0r">
+ <device id="retina4_7" orientation="portrait">
+ <adaptation id="fullscreen"/>
+ </device>
+ <dependencies>
+ <deployment identifier="iOS"/>
+ <plugIn identifier="com.apple.InterfaceBuilder.IBCocoaTouchPlugin" version="14088"/>
+ </dependencies>
+ <scenes>
+ <!--Bridge View Controller-->
+ <scene sceneID="tne-QT-ifu">
+ <objects>
+ <viewController id="BYZ-38-t0r" customClass="CAPBridgeViewController" customModule="Capacitor" sceneMemberID="viewController"/>
+ <placeholder placeholderIdentifier="IBFirstResponder" id="dkx-z0-nzr" sceneMemberID="firstResponder"/>
+ </objects>
+ </scene>
+ </scenes>
+</document>
diff --git a/ios/native/App/App/Info.plist b/ios/native/App/App/Info.plist
new file mode 100644
index 000000000..df4834a26
--- /dev/null
+++ b/ios/native/App/App/Info.plist
@@ -0,0 +1,154 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+ <key>CAPACITOR_DEBUG</key>
+ <string>$(CAPACITOR_DEBUG)</string>
+ <key>CFBundleDevelopmentRegion</key>
+ <string>en</string>
+ <key>CFBundleDisplayName</key>
+ <string>three.ws</string>
+ <key>CFBundleExecutable</key>
+ <string>$(EXECUTABLE_NAME)</string>
+ <key>CFBundleIdentifier</key>
+ <string>$(PRODUCT_BUNDLE_IDENTIFIER)</string>
+ <key>CFBundleInfoDictionaryVersion</key>
+ <string>6.0</string>
+ <key>CFBundleName</key>
+ <string>$(PRODUCT_NAME)</string>
+ <key>CFBundlePackageType</key>
+ <string>APPL</string>
+ <key>CFBundleShortVersionString</key>
+ <string>$(MARKETING_VERSION)</string>
+ <key>CFBundleVersion</key>
+ <string>$(CURRENT_PROJECT_VERSION)</string>
+ <key>LSRequiresIPhoneOS</key>
+ <true/>
+
+ <!--
+ Deep links. Universal links (https://three.ws/...) are the primary path and
+ are declared in App.entitlements + public/.well-known/apple-app-site-association;
+ this custom scheme is the fallback that wallet and OAuth redirects can always
+ reach, including from a Safari view controller that cannot resolve an
+ associated domain. Handled in AppDelegate -> Capacitor's App plugin ->
+ src/native-bridge.js.
+ -->
+ <key>CFBundleURLTypes</key>
+ <array>
+ <dict>
+ <key>CFBundleURLName</key>
+ <string>ws.three.app</string>
+ <key>CFBundleTypeRole</key>
+ <string>Editor</string>
+ <key>CFBundleURLSchemes</key>
+ <array>
+ <string>threews</string>
+ </array>
+ </dict>
+ </array>
+
+ <!--
+ Schemes the app is allowed to probe with canOpenURL. Phantom and Solflare
+ are how a Solana user signs on iOS: there is no Seed Vault outside Seeker,
+ so the wallet handoff is a deep link into the wallet app and back. Without
+ these entries canOpenURL always answers false and the sign-in sheet cannot
+ tell an installed wallet from a missing one.
+ -->
+ <key>LSApplicationQueriesSchemes</key>
+ <array>
+ <string>phantom</string>
+ <string>solflare</string>
+ <string>metamask</string>
+ <string>https</string>
+ </array>
+
+ <!-- Selfie to avatar (/create/selfie), the AR camera passthrough (/ar/studio, /irl). -->
+ <key>NSCameraUsageDescription</key>
+ <string>three.ws uses the camera to turn a selfie into a 3D avatar and to place your agents in the room around you.</string>
+ <!-- Talk mode: speaking to an agent. -->
+ <key>NSMicrophoneUsageDescription</key>
+ <string>three.ws uses the microphone so you can talk to your agents out loud.</string>
+ <!-- Choosing a reference photo for avatar generation. -->
+ <key>NSPhotoLibraryUsageDescription</key>
+ <string>three.ws reads a photo you pick so it can build a 3D avatar from it.</string>
+ <!-- Saving an AR capture back to the camera roll. -->
+ <key>NSPhotoLibraryAddUsageDescription</key>
+ <string>three.ws saves the photos and videos you capture of your agents to your library.</string>
+ <!-- IRL pins: dropping and discovering an agent at a real place. -->
+ <key>NSLocationWhenInUseUsageDescription</key>
+ <string>three.ws uses your location to pin agents to real places and to show you the ones pinned nearby.</string>
+ <!-- Gyro world-lock in the non-WebXR AR path (src/ar/multi-place.js). -->
+ <key>NSMotionUsageDescription</key>
+ <string>three.ws reads device motion to keep an agent anchored in place as you move the camera.</string>
+
+ <!-- Push notifications arriving while the app is backgrounded. -->
+ <key>UIBackgroundModes</key>
+ <array>
+ <string>remote-notification</string>
+ </array>
+
+ <!--
+ The product is dark-only. Leaving this unset lets iOS hand the WebView a
+ light system appearance, which flashes white behind every WebGL canvas
+ during a scene load.
+ -->
+ <key>UIUserInterfaceStyle</key>
+ <string>Dark</string>
+
+ <key>UIApplicationSceneManifest</key>
+ <dict>
+ <key>UIApplicationSupportsMultipleScenes</key>
+ <false/>
+ <key>UISceneConfigurations</key>
+ <dict>
+ <key>UIWindowSceneSessionRoleApplication</key>
+ <array>
+ <dict>
+ <key>UISceneConfigurationName</key>
+ <string>Default Configuration</string>
+ <key>UISceneDelegateClassName</key>
+ <string>$(PRODUCT_MODULE_NAME).SceneDelegate</string>
+ <key>UISceneStoryboardFile</key>
+ <string>Main</string>
+ </dict>
+ </array>
+ </dict>
+ </dict>
+ <key>UILaunchStoryboardName</key>
+ <string>LaunchScreen</string>
+ <key>UIMainStoryboardFile</key>
+ <string>Main</string>
+ <!--
+ arm64, not the armv7 Capacitor's template still ships: armv7 is a 32-bit
+ capability no supported iOS device reports, and App Store Connect rejects
+ a build that requires it.
+ -->
+ <key>UIRequiredDeviceCapabilities</key>
+ <array>
+ <string>arm64</string>
+ </array>
+ <key>UISupportedInterfaceOrientations</key>
+ <array>
+ <string>UIInterfaceOrientationPortrait</string>
+ <string>UIInterfaceOrientationLandscapeLeft</string>
+ <string>UIInterfaceOrientationLandscapeRight</string>
+ </array>
+ <key>UISupportedInterfaceOrientations~ipad</key>
+ <array>
+ <string>UIInterfaceOrientationPortrait</string>
+ <string>UIInterfaceOrientationPortraitUpsideDown</string>
+ <string>UIInterfaceOrientationLandscapeLeft</string>
+ <string>UIInterfaceOrientationLandscapeRight</string>
+ </array>
+ <key>UIViewControllerBasedStatusBarAppearance</key>
+ <true/>
+
+ <!--
+ Answers App Store Connect's export-compliance question at upload time
+ instead of blocking every TestFlight build on a manual form. three.ws uses
+ only HTTPS and the platform's own crypto, which is the exempt case.
+ -->
+ <key>ITSAppUsesNonExemptEncryption</key>
+ <false/>
+</dict>
+</plist>
diff --git a/ios/native/App/App/SceneDelegate.swift b/ios/native/App/App/SceneDelegate.swift
new file mode 100644
index 000000000..f352e1e95
--- /dev/null
+++ b/ios/native/App/App/SceneDelegate.swift
@@ -0,0 +1,24 @@
+import UIKit
+import Capacitor
+
+class SceneDelegate: UIResponder, UIWindowSceneDelegate {
+ var window: UIWindow?
+
+ func scene(_ scene: UIScene, willConnectTo session: UISceneSession, options connectionOptions: UIScene.ConnectionOptions) {
+ guard let windowScene = scene as? UIWindowScene else { return }
+
+ window = UIWindow(windowScene: windowScene)
+ window?.rootViewController = CAPBridgeViewController()
+ window?.makeKeyAndVisible()
+
+ SceneDelegateProxy.shared.scene(scene, willConnectTo: session, options: connectionOptions)
+ }
+
+ func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>) {
+ SceneDelegateProxy.shared.scene(scene, openURLContexts: URLContexts)
+ }
+
+ func scene(_ scene: UIScene, continue userActivity: NSUserActivity) {
+ SceneDelegateProxy.shared.scene(scene, continue: userActivity)
+ }
+}
diff --git a/ios/native/App/CapApp-SPM/.gitignore b/ios/native/App/CapApp-SPM/.gitignore
new file mode 100644
index 000000000..3b2981208
--- /dev/null
+++ b/ios/native/App/CapApp-SPM/.gitignore
@@ -0,0 +1,9 @@
+.DS_Store
+/.build
+/Packages
+/*.xcodeproj
+xcuserdata/
+DerivedData/
+.swiftpm/config/registries.json
+.swiftpm/xcode/package.xcworkspace/contents.xcworkspacedata
+.netrc
diff --git a/ios/native/App/CapApp-SPM/Package.swift b/ios/native/App/CapApp-SPM/Package.swift
new file mode 100644
index 000000000..26aae16bf
--- /dev/null
+++ b/ios/native/App/CapApp-SPM/Package.swift
@@ -0,0 +1,49 @@
+// swift-tools-version: 5.9
+import PackageDescription
+
+// DO NOT MODIFY THIS FILE - managed by Capacitor CLI commands
+let package = Package(
+ name: "CapApp-SPM",
+ platforms: [.iOS(.v16)],
+ products: [
+ .library(
+ name: "CapApp-SPM",
+ targets: ["CapApp-SPM"])
+ ],
+ dependencies: [
+ .package(url: "https://github.com/ionic-team/capacitor-swift-pm.git", exact: "8.5.0"),
+ .package(name: "CapacitorApp", path: "../../../node_modules/@capacitor/app"),
+ .package(name: "CapacitorBrowser", path: "../../../node_modules/@capacitor/browser"),
+ .package(name: "CapacitorCamera", path: "../../../node_modules/@capacitor/camera"),
+ .package(name: "CapacitorDevice", path: "../../../node_modules/@capacitor/device"),
+ .package(name: "CapacitorFilesystem", path: "../../../node_modules/@capacitor/filesystem"),
+ .package(name: "CapacitorGeolocation", path: "../../../node_modules/@capacitor/geolocation"),
+ .package(name: "CapacitorHaptics", path: "../../../node_modules/@capacitor/haptics"),
+ .package(name: "CapacitorPreferences", path: "../../../node_modules/@capacitor/preferences"),
+ .package(name: "CapacitorPushNotifications", path: "../../../node_modules/@capacitor/push-notifications"),
+ .package(name: "CapacitorShare", path: "../../../node_modules/@capacitor/share"),
+ .package(name: "CapacitorSplashScreen", path: "../../../node_modules/@capacitor/splash-screen"),
+ .package(name: "CapacitorStatusBar", path: "../../../node_modules/@capacitor/status-bar")
+ ],
+ targets: [
+ .target(
+ name: "CapApp-SPM",
+ dependencies: [
+ .product(name: "Capacitor", package: "capacitor-swift-pm"),
+ .product(name: "Cordova", package: "capacitor-swift-pm"),
+ .product(name: "CapacitorApp", package: "CapacitorApp"),
+ .product(name: "CapacitorBrowser", package: "CapacitorBrowser"),
+ .product(name: "CapacitorCamera", package: "CapacitorCamera"),
+ .product(name: "CapacitorDevice", package: "CapacitorDevice"),
+ .product(name: "CapacitorFilesystem", package: "CapacitorFilesystem"),
+ .product(name: "CapacitorGeolocation", package: "CapacitorGeolocation"),
+ .product(name: "CapacitorHaptics", package: "CapacitorHaptics"),
+ .product(name: "CapacitorPreferences", package: "CapacitorPreferences"),
+ .product(name: "CapacitorPushNotifications", package: "CapacitorPushNotifications"),
+ .product(name: "CapacitorShare", package: "CapacitorShare"),
+ .product(name: "CapacitorSplashScreen", package: "CapacitorSplashScreen"),
+ .product(name: "CapacitorStatusBar", package: "CapacitorStatusBar")
+ ]
+ )
+ ]
+)
diff --git a/ios/native/App/CapApp-SPM/README.md b/ios/native/App/CapApp-SPM/README.md
new file mode 100644
index 000000000..03964db90
--- /dev/null
+++ b/ios/native/App/CapApp-SPM/README.md
@@ -0,0 +1,5 @@
+# CapApp-SPM
+
+This package is used to host SPM dependencies for your Capacitor project
+
+Do not modify the contents of it or there may be unintended consequences.
diff --git a/ios/native/App/CapApp-SPM/Sources/CapApp-SPM/CapApp-SPM.swift b/ios/native/App/CapApp-SPM/Sources/CapApp-SPM/CapApp-SPM.swift
new file mode 100644
index 000000000..945afec8c
--- /dev/null
+++ b/ios/native/App/CapApp-SPM/Sources/CapApp-SPM/CapApp-SPM.swift
@@ -0,0 +1 @@
+public let isCapacitorApp = true
diff --git a/ios/native/debug.xcconfig b/ios/native/debug.xcconfig
new file mode 100644
index 000000000..53ce18dea
--- /dev/null
+++ b/ios/native/debug.xcconfig
@@ -0,0 +1 @@
+CAPACITOR_DEBUG = true
diff --git a/ios/package-lock.json b/ios/package-lock.json
new file mode 100644
index 000000000..660424c32
--- /dev/null
+++ b/ios/package-lock.json
@@ -0,0 +1,1368 @@
+{
+ "name": "three-ws-ios",
+ "version": "1.0.0",
+ "lockfileVersion": 3,
+ "requires": true,
+ "packages": {
+ "": {
+ "name": "three-ws-ios",
+ "version": "1.0.0",
+ "dependencies": {
+ "@capacitor/app": "^8.0.0",
+ "@capacitor/browser": "^8.0.0",
+ "@capacitor/camera": "^8.0.0",
+ "@capacitor/core": "^8.0.0",
+ "@capacitor/device": "^8.0.0",
+ "@capacitor/filesystem": "^8.0.0",
+ "@capacitor/geolocation": "^8.0.0",
+ "@capacitor/haptics": "^8.0.0",
+ "@capacitor/ios": "^8.0.0",
+ "@capacitor/preferences": "^8.0.0",
+ "@capacitor/push-notifications": "^8.0.0",
+ "@capacitor/share": "^8.0.0",
+ "@capacitor/splash-screen": "^8.0.0",
+ "@capacitor/status-bar": "^8.0.0"
+ },
+ "devDependencies": {
+ "@capacitor/cli": "^8.0.0"
+ }
+ },
+ "node_modules/@capacitor/app": {
+ "version": "8.1.1",
+ "resolved": "https://registry.npmjs.org/@capacitor/app/-/app-8.1.1.tgz",
+ "integrity": "sha512-xM2ZTX5jK60tFtmjsmJv+Cdj1Qsb6NcavkqmdEnCPQBeya9oKhamZJxYOnQNj1ZvcJM7sWfG6BEtSLx42pisbA==",
+ "license": "MIT",
+ "peerDependencies": {
+ "@capacitor/core": ">=8.0.0"
+ }
+ },
+ "node_modules/@capacitor/browser": {
+ "version": "8.0.4",
+ "resolved": "https://registry.npmjs.org/@capacitor/browser/-/browser-8.0.4.tgz",
+ "integrity": "sha512-ORZ4u/y+7aMuu6yVuk6SP529fUZyqcbnuHB1q5McpA3o2SYfVoi28iB8rsQjI2ad1qlKJd29ZUuGtspXLBDlWg==",
+ "license": "MIT",
+ "peerDependencies": {
+ "@capacitor/core": ">=8.0.0"
+ }
+ },
+ "node_modules/@capacitor/camera": {
+ "version": "8.2.3",
+ "resolved": "https://registry.npmjs.org/@capacitor/camera/-/camera-8.2.3.tgz",
+ "integrity": "sha512-x9Pl5UgvrZyU5Hl53Fly9f6u019hhgN+gSdDgi+WygxK9DUVuYKjigplOXz3VJQ9m8ttUSjqN/rAC3JVnyEzcA==",
+ "license": "MIT",
+ "peerDependencies": {
+ "@capacitor/core": ">=8.0.0"
+ }
+ },
+ "node_modules/@capacitor/cli": {
+ "version": "8.5.0",
+ "resolved": "https://registry.npmjs.org/@capacitor/cli/-/cli-8.5.0.tgz",
+ "integrity": "sha512-rLdzMUM5QV4WITcqoWv04p32i14BXgUH2diqEH6MWQlWaJfiyNrvOyt/+d5vHAfOxOm1klBu637VDEobctlwBA==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "@ionic/cli-framework-output": "^2.2.8",
+ "@ionic/utils-subprocess": "^3.0.1",
+ "@ionic/utils-terminal": "^2.3.5",
+ "commander": "^12.1.0",
+ "debug": "^4.4.0",
+ "env-paths": "^2.2.0",
+ "fs-extra": "^11.2.0",
+ "kleur": "^4.1.5",
+ "native-run": "^2.0.3",
+ "open": "^8.4.0",
+ "plist": "^3.1.0",
+ "prompts": "^2.4.2",
+ "rimraf": "^6.0.1",
+ "semver": "^7.6.3",
+ "tar": "^7.5.3",
+ "tslib": "^2.8.1",
+ "xcode": "^3.0.1",
+ "xml2js": "^0.6.2"
+ },
+ "bin": {
+ "cap": "bin/capacitor",
+ "capacitor": "bin/capacitor"
+ },
+ "engines": {
+ "node": ">=22.0.0"
+ }
+ },
+ "node_modules/@capacitor/core": {
+ "version": "8.5.0",
+ "resolved": "https://registry.npmjs.org/@capacitor/core/-/core-8.5.0.tgz",
+ "integrity": "sha512-Ca4krtqH1hothjtBIwf2J2TW7IhYq1ujp8QeItTiJohNsqij8ja2DYYH3DU0l8RmxCWaBAFTGA2TgOgOMCSNsQ==",
+ "license": "MIT",
+ "dependencies": {
+ "tslib": "^2.1.0"
+ }
+ },
+ "node_modules/@capacitor/device": {
+ "version": "8.0.3",
+ "resolved": "https://registry.npmjs.org/@capacitor/device/-/device-8.0.3.tgz",
+ "integrity": "sha512-rliPCCZwxtjU6200jJNDAsQhioyozV3fGgiP+NgRqtDOI7i+Jdz+DYNwEup+3MGZZ4NEmkuFaBeWLM3T01vJRg==",
+ "license": "MIT",
+ "peerDependencies": {
+ "@capacitor/core": ">=8.0.0"
+ }
+ },
+ "node_modules/@capacitor/filesystem": {
+ "version": "8.1.3",
+ "resolved": "https://registry.npmjs.org/@capacitor/filesystem/-/filesystem-8.1.3.tgz",
+ "integrity": "sha512-GNBlRkaXEEb+6WP/YsDXr2zygyOHoieuye6viyd2ZkEdBwfseG41jxfarVxLWH0r0owhyNUbwJ/Qi8fubqr6wA==",
+ "license": "MIT",
+ "dependencies": {
+ "@capacitor/synapse": "^1.0.4"
+ },
+ "peerDependencies": {
+ "@capacitor/core": ">=8.0.0"
+ }
+ },
+ "node_modules/@capacitor/geolocation": {
+ "version": "8.2.2",
+ "resolved": "https://registry.npmjs.org/@capacitor/geolocation/-/geolocation-8.2.2.tgz",
+ "integrity": "sha512-X8ryw6CfL4LspJnnfVL4++DUKKZVfdUIA9JljWVRljEDIQxZQZtz6xf7qstht+ymc+le6oa5EaUChVA6KsCYlA==",
+ "license": "MIT",
+ "dependencies": {
+ "@capacitor/synapse": "^1.0.4"
+ },
+ "peerDependencies": {
+ "@capacitor/core": ">=8.0.0"
+ }
+ },
+ "node_modules/@capacitor/haptics": {
+ "version": "8.0.2",
+ "resolved": "https://registry.npmjs.org/@capacitor/haptics/-/haptics-8.0.2.tgz",
+ "integrity": "sha512-c2hZzRR5Fk1tbTvhG1jhh2XBAf3EhnIerMIb2sl7Mt41Gxx1fhBJFDa0/BI1IbY4loVepyyuqNC9820/GZuoWQ==",
+ "license": "MIT",
+ "peerDependencies": {
+ "@capacitor/core": ">=8.0.0"
+ }
+ },
+ "node_modules/@capacitor/ios": {
+ "version": "8.5.0",
+ "resolved": "https://registry.npmjs.org/@capacitor/ios/-/ios-8.5.0.tgz",
+ "integrity": "sha512-7k1TfohJu5BzRXc1F3g04Q8QQ0fyQgms6h1AvhnHb04VaNr9EdHOx03hL8O+OigEKMQnyJd1ZOjTPPNHCqL5Yw==",
+ "license": "MIT",
+ "peerDependencies": {
+ "@capacitor/core": "^8.5.0"
+ }
+ },
+ "node_modules/@capacitor/preferences": {
+ "version": "8.0.1",
+ "resolved": "https://registry.npmjs.org/@capacitor/preferences/-/preferences-8.0.1.tgz",
+ "integrity": "sha512-T6no3ebi79XJCk91U3Jp/liJUwgBdvHR+s6vhvPkPxSuch7z3zx5Rv1bdWM6sWruNx+pViuEGqZvbfCdyBvcHQ==",
+ "license": "MIT",
+ "peerDependencies": {
+ "@capacitor/core": ">=8.0.0"
+ }
+ },
+ "node_modules/@capacitor/push-notifications": {
+ "version": "8.1.2",
+ "resolved": "https://registry.npmjs.org/@capacitor/push-notifications/-/push-notifications-8.1.2.tgz",
+ "integrity": "sha512-TQl4XxqJfNF+KbSYBFMXYYT5WXUaleVKXlByhh/8+KySMVNjp+l5OqAUoGe/sY1IAnGXEuUeCjA/WLZEVvGwrA==",
+ "license": "MIT",
+ "peerDependencies": {
+ "@capacitor/core": ">=8.0.0"
+ }
+ },
+ "node_modules/@capacitor/share": {
+ "version": "8.0.1",
+ "resolved": "https://registry.npmjs.org/@capacitor/share/-/share-8.0.1.tgz",
+ "integrity": "sha512-3cSBKBCJVon54rKDROP2rqGyeGks4pBh9TbaEk9S375Kbek/ZHe72N50zIa0Vn9Eac/SuhwgehO/mmA4CsUOiw==",
+ "license": "MIT",
+ "peerDependencies": {
+ "@capacitor/core": ">=8.0.0"
+ }
+ },
+ "node_modules/@capacitor/splash-screen": {
+ "version": "8.0.2",
+ "resolved": "https://registry.npmjs.org/@capacitor/splash-screen/-/splash-screen-8.0.2.tgz",
+ "integrity": "sha512-0C6rYScr13WfAE9nPl4ScOQynmjFv9NT3Th+RZkD4ezYHmER6mcl1/lDYsv7jg3Rj3FOvLrlTlmNkUrr83kZzQ==",
+ "license": "MIT",
+ "peerDependencies": {
+ "@capacitor/core": ">=8.0.0"
+ }
+ },
+ "node_modules/@capacitor/status-bar": {
+ "version": "8.0.3",
+ "resolved": "https://registry.npmjs.org/@capacitor/status-bar/-/status-bar-8.0.3.tgz",
+ "integrity": "sha512-csSpfNeN49Hx9JaQBSJEIiEbOLtXg3kcc2IpScq2fu5L520h3AWEvsxoH8Srk1jxfRKepaJ4S4sqSC3foI4AgA==",
+ "license": "MIT",
+ "peerDependencies": {
+ "@capacitor/core": ">=8.0.0"
+ }
+ },
+ "node_modules/@capacitor/synapse": {
+ "version": "1.0.4",
+ "resolved": "https://registry.npmjs.org/@capacitor/synapse/-/synapse-1.0.4.tgz",
+ "integrity": "sha512-/C1FUo8/OkKuAT4nCIu/34ny9siNHr9qtFezu4kxm6GY1wNFxrCFWjfYx5C1tUhVGz3fxBABegupkpjXvjCHrw==",
+ "license": "ISC"
+ },
+ "node_modules/@ionic/cli-framework-output": {
+ "version": "2.2.8",
+ "resolved": "https://registry.npmjs.org/@ionic/cli-framework-output/-/cli-framework-output-2.2.8.tgz",
+ "integrity": "sha512-TshtaFQsovB4NWRBydbNFawql6yul7d5bMiW1WYYf17hd99V6xdDdk3vtF51bw6sLkxON3bDQpWsnUc9/hVo3g==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "@ionic/utils-terminal": "2.3.5",
+ "debug": "^4.0.0",
+ "tslib": "^2.0.1"
+ },
+ "engines": {
+ "node": ">=16.0.0"
+ }
+ },
+ "node_modules/@ionic/utils-array": {
+ "version": "2.1.6",
+ "resolved": "https://registry.npmjs.org/@ionic/utils-array/-/utils-array-2.1.6.tgz",
+ "integrity": "sha512-0JZ1Zkp3wURnv8oq6Qt7fMPo5MpjbLoUoa9Bu2Q4PJuSDWM8H8gwF3dQO7VTeUj3/0o1IB1wGkFWZZYgUXZMUg==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "debug": "^4.0.0",
+ "tslib": "^2.0.1"
+ },
+ "engines": {
+ "node": ">=16.0.0"
+ }
+ },
+ "node_modules/@ionic/utils-fs": {
+ "version": "3.1.7",
+ "resolved": "https://registry.npmjs.org/@ionic/utils-fs/-/utils-fs-3.1.7.tgz",
+ "integrity": "sha512-2EknRvMVfhnyhL1VhFkSLa5gOcycK91VnjfrTB0kbqkTFCOXyXgVLI5whzq7SLrgD9t1aqos3lMMQyVzaQ5gVA==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "@types/fs-extra": "^8.0.0",
+ "debug": "^4.0.0",
+ "fs-extra": "^9.0.0",
+ "tslib": "^2.0.1"
+ },
+ "engines": {
+ "node": ">=16.0.0"
+ }
+ },
+ "node_modules/@ionic/utils-fs/node_modules/fs-extra": {
+ "version": "9.1.0",
+ "resolved": "https://registry.npmjs.org/fs-extra/-/fs-extra-9.1.0.tgz",
+ "integrity": "sha512-hcg3ZmepS30/7BSFqRvoo3DOMQu7IjqxO5nCDt+zM9XWjb33Wg7ziNT+Qvqbuc3+gWpzO02JubVyk2G4Zvo1OQ==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "at-least-node": "^1.0.0",
+ "graceful-fs": "^4.2.0",
+ "jsonfile": "^6.0.1",
+ "universalify": "^2.0.0"
+ },
+ "engines": {
+ "node": ">=10"
+ }
+ },
+ "node_modules/@ionic/utils-object": {
+ "version": "2.1.6",
+ "resolved": "https://registry.npmjs.org/@ionic/utils-object/-/utils-object-2.1.6.tgz",
+ "integrity": "sha512-vCl7sl6JjBHFw99CuAqHljYJpcE88YaH2ZW4ELiC/Zwxl5tiwn4kbdP/gxi2OT3MQb1vOtgAmSNRtusvgxI8ww==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "debug": "^4.0.0",
+ "tslib": "^2.0.1"
+ },
+ "engines": {
+ "node": ">=16.0.0"
+ }
+ },
+ "node_modules/@ionic/utils-process": {
+ "version": "2.1.12",
+ "resolved": "https://registry.npmjs.org/@ionic/utils-process/-/utils-process-2.1.12.tgz",
+ "integrity": "sha512-Jqkgyq7zBs/v/J3YvKtQQiIcxfJyplPgECMWgdO0E1fKrrH8EF0QGHNJ9mJCn6PYe2UtHNS8JJf5G21e09DfYg==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "@ionic/utils-object": "2.1.6",
+ "@ionic/utils-terminal": "2.3.5",
+ "debug": "^4.0.0",
+ "signal-exit": "^3.0.3",
+ "tree-kill": "^1.2.2",
+ "tslib": "^2.0.1"
+ },
+ "engines": {
+ "node": ">=16.0.0"
+ }
+ },
+ "node_modules/@ionic/utils-stream": {
+ "version": "3.1.7",
+ "resolved": "https://registry.npmjs.org/@ionic/utils-stream/-/utils-stream-3.1.7.tgz",
+ "integrity": "sha512-eSELBE7NWNFIHTbTC2jiMvh1ABKGIpGdUIvARsNPMNQhxJB3wpwdiVnoBoTYp+5a6UUIww4Kpg7v6S7iTctH1w==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "debug": "^4.0.0",
+ "tslib": "^2.0.1"
+ },
+ "engines": {
+ "node": ">=16.0.0"
+ }
+ },
+ "node_modules/@ionic/utils-subprocess": {
+ "version": "3.0.1",
+ "resolved": "https://registry.npmjs.org/@ionic/utils-subprocess/-/utils-subprocess-3.0.1.tgz",
+ "integrity": "sha512-cT4te3AQQPeIM9WCwIg8ohroJ8TjsYaMb2G4ZEgv9YzeDqHZ4JpeIKqG2SoaA3GmVQ3sOfhPM6Ox9sxphV/d1A==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "@ionic/utils-array": "2.1.6",
+ "@ionic/utils-fs": "3.1.7",
+ "@ionic/utils-process": "2.1.12",
+ "@ionic/utils-stream": "3.1.7",
+ "@ionic/utils-terminal": "2.3.5",
+ "cross-spawn": "^7.0.3",
+ "debug": "^4.0.0",
+ "tslib": "^2.0.1"
+ },
+ "engines": {
+ "node": ">=16.0.0"
+ }
+ },
+ "node_modules/@ionic/utils-terminal": {
+ "version": "2.3.5",
+ "resolved": "https://registry.npmjs.org/@ionic/utils-terminal/-/utils-terminal-2.3.5.tgz",
+ "integrity": "sha512-3cKScz9Jx2/Pr9ijj1OzGlBDfcmx7OMVBt4+P1uRR0SSW4cm1/y3Mo4OY3lfkuaYifMNBW8Wz6lQHbs1bihr7A==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "@types/slice-ansi": "^4.0.0",
+ "debug": "^4.0.0",
+ "signal-exit": "^3.0.3",
+ "slice-ansi": "^4.0.0",
+ "string-width": "^4.1.0",
+ "strip-ansi": "^6.0.0",
+ "tslib": "^2.0.1",
+ "untildify": "^4.0.0",
+ "wrap-ansi": "^7.0.0"
+ },
+ "engines": {
+ "node": ">=16.0.0"
+ }
+ },
+ "node_modules/@isaacs/fs-minipass": {
+ "version": "4.0.1",
+ "resolved": "https://registry.npmjs.org/@isaacs/fs-minipass/-/fs-minipass-4.0.1.tgz",
+ "integrity": "sha512-wgm9Ehl2jpeqP3zw/7mo3kRHFp5MEDhqAdwy1fTGkHAwnkGOVsgpvQhL8B5n1qlb01jV3n/bI0ZfZp5lWA1k4w==",
+ "dev": true,
+ "license": "ISC",
+ "dependencies": {
+ "minipass": "^7.0.4"
+ },
+ "engines": {
+ "node": ">=18.0.0"
+ }
+ },
+ "node_modules/@types/fs-extra": {
+ "version": "8.1.5",
+ "resolved": "https://registry.npmjs.org/@types/fs-extra/-/fs-extra-8.1.5.tgz",
+ "integrity": "sha512-0dzKcwO+S8s2kuF5Z9oUWatQJj5Uq/iqphEtE3GQJVRRYm/tD1LglU2UnXi2A8jLq5umkGouOXOR9y0n613ZwQ==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "@types/node": "*"
+ }
+ },
+ "node_modules/@types/node": {
+ "version": "26.4.0",
+ "resolved": "https://registry.npmjs.org/@types/node/-/node-26.4.0.tgz",
+ "integrity": "sha512-faiGnoIrLH/V8cibOMEAZ8pMw6oXqSukl29ra4mN8GdaB2ZewzeaLj+INpV5N+Z1eKWzY+IzaIZH2EIR6YZRNQ==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "undici-types": "~8.3.0"
+ }
+ },
+ "node_modules/@types/slice-ansi": {
+ "version": "4.0.0",
+ "resolved": "https://registry.npmjs.org/@types/slice-ansi/-/slice-ansi-4.0.0.tgz",
+ "integrity": "sha512-+OpjSaq85gvlZAYINyzKpLeiFkSC4EsC6IIiT6v6TLSU5k5U83fHGj9Lel8oKEXM0HqgrMVCjXPDPVICtxF7EQ==",
+ "dev": true,
+ "license": "MIT"
+ },
+ "node_modules/@xmldom/xmldom": {
+ "version": "0.9.12",
+ "resolved": "https://registry.npmjs.org/@xmldom/xmldom/-/xmldom-0.9.12.tgz",
+ "integrity": "sha512-5AXjrcMClTryPe9LgZrygpB1lj7s0S9E0+W+AHaVKAVyHanafK86iPSvG5xHVSp/jC+VH1UXu0TAEmY279xH7A==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">=14.6"
+ }
+ },
+ "node_modules/ansi-regex": {
+ "version": "5.0.1",
+ "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-5.0.1.tgz",
+ "integrity": "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">=8"
+ }
+ },
+ "node_modules/ansi-styles": {
+ "version": "4.3.0",
+ "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz",
+ "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "color-convert": "^2.0.1"
+ },
+ "engines": {
+ "node": ">=8"
+ },
+ "funding": {
+ "url": "https://github.com/chalk/ansi-styles?sponsor=1"
+ }
+ },
+ "node_modules/astral-regex": {
+ "version": "2.0.0",
+ "resolved": "https://registry.npmjs.org/astral-regex/-/astral-regex-2.0.0.tgz",
+ "integrity": "sha512-Z7tMw1ytTXt5jqMcOP+OQteU1VuNK9Y02uuJtKQ1Sv69jXQKKg5cibLwGJow8yzZP+eAc18EmLGPal0bp36rvQ==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">=8"
+ }
+ },
+ "node_modules/at-least-node": {
+ "version": "1.0.0",
+ "resolved": "https://registry.npmjs.org/at-least-node/-/at-least-node-1.0.0.tgz",
+ "integrity": "sha512-+q/t7Ekv1EDY2l6Gda6LLiX14rU9TV20Wa3ofeQmwPFZbOMo9DXrLbOjFaaclkXKWidIaopwAObQDqwWtGUjqg==",
+ "dev": true,
+ "license": "ISC",
+ "engines": {
+ "node": ">= 4.0.0"
+ }
+ },
+ "node_modules/balanced-match": {
+ "version": "4.0.4",
+ "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-4.0.4.tgz",
+ "integrity": "sha512-BLrgEcRTwX2o6gGxGOCNyMvGSp35YofuYzw9h1IMTRmKqttAZZVU67bdb9Pr2vUHA8+j3i2tJfjO6C6+4myGTA==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": "18 || 20 || >=22"
+ }
+ },
+ "node_modules/base64-js": {
+ "version": "1.5.1",
+ "resolved": "https://registry.npmjs.org/base64-js/-/base64-js-1.5.1.tgz",
+ "integrity": "sha512-AKpaYlHn8t4SVbOHCy+b5+KKgvR4vrsD8vbvrbiQJps7fKDTkjkDry6ji0rUJjC0kzbNePLwzxq8iypo41qeWA==",
+ "dev": true,
+ "funding": [
+ {
+ "type": "github",
+ "url": "https://github.com/sponsors/feross"
+ },
+ {
+ "type": "patreon",
+ "url": "https://www.patreon.com/feross"
+ },
+ {
+ "type": "consulting",
+ "url": "https://feross.org/support"
+ }
+ ],
+ "license": "MIT"
+ },
+ "node_modules/big-integer": {
+ "version": "1.6.52",
+ "resolved": "https://registry.npmjs.org/big-integer/-/big-integer-1.6.52.tgz",
+ "integrity": "sha512-QxD8cf2eVqJOOz63z6JIN9BzvVs/dlySa5HGSBH5xtR8dPteIRQnBxxKqkNTiT6jbDTF6jAfrd4oMcND9RGbQg==",
+ "dev": true,
+ "license": "Unlicense",
+ "engines": {
+ "node": ">=0.6"
+ }
+ },
+ "node_modules/bplist-creator": {
+ "version": "0.1.0",
+ "resolved": "https://registry.npmjs.org/bplist-creator/-/bplist-creator-0.1.0.tgz",
+ "integrity": "sha512-sXaHZicyEEmY86WyueLTQesbeoH/mquvarJaQNbjuOQO+7gbFcDEWqKmcWA4cOTLzFlfgvkiVxolk1k5bBIpmg==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "stream-buffers": "2.2.x"
+ }
+ },
+ "node_modules/bplist-parser": {
+ "version": "0.3.2",
+ "resolved": "https://registry.npmjs.org/bplist-parser/-/bplist-parser-0.3.2.tgz",
+ "integrity": "sha512-apC2+fspHGI3mMKj+dGevkGo/tCqVB8jMb6i+OX+E29p0Iposz07fABkRIfVUPNd5A5VbuOz1bZbnmkKLYF+wQ==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "big-integer": "1.6.x"
+ },
+ "engines": {
+ "node": ">= 5.10.0"
+ }
+ },
+ "node_modules/brace-expansion": {
+ "version": "5.0.9",
+ "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-5.0.9.tgz",
+ "integrity": "sha512-ScQ4IuvIEF1TMlP7Zt+vjJ//9zlPb2SDcxWxM3bk8s6t6GGdJ7KO1dCcTidOPJKePW30LE/2cT7wCyPho9/Wxg==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "balanced-match": "^4.0.2"
+ },
+ "engines": {
+ "node": "20 || >=22"
+ }
+ },
+ "node_modules/buffer-crc32": {
+ "version": "0.2.13",
+ "resolved": "https://registry.npmjs.org/buffer-crc32/-/buffer-crc32-0.2.13.tgz",
+ "integrity": "sha512-VO9Ht/+p3SN7SKWqcrgEzjGbRSJYTx+Q1pTQC0wrWqHx0vpJraQ6GtHx8tvcg1rlK1byhU5gccxgOgj7B0TDkQ==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": "*"
+ }
+ },
+ "node_modules/chownr": {
+ "version": "3.0.0",
+ "resolved": "https://registry.npmjs.org/chownr/-/chownr-3.0.0.tgz",
+ "integrity": "sha512-+IxzY9BZOQd/XuYPRmrvEVjF/nqj5kgT4kEq7VofrDoM1MxoRjEWkrCC3EtLi59TVawxTAn+orJwFQcrqEN1+g==",
+ "dev": true,
+ "license": "BlueOak-1.0.0",
+ "engines": {
+ "node": ">=18"
+ }
+ },
+ "node_modules/color-convert": {
+ "version": "2.0.1",
+ "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz",
+ "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "color-name": "~1.1.4"
+ },
+ "engines": {
+ "node": ">=7.0.0"
+ }
+ },
+ "node_modules/color-name": {
+ "version": "1.1.4",
+ "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz",
+ "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==",
+ "dev": true,
+ "license": "MIT"
+ },
+ "node_modules/commander": {
+ "version": "12.1.0",
+ "resolved": "https://registry.npmjs.org/commander/-/commander-12.1.0.tgz",
+ "integrity": "sha512-Vw8qHK3bZM9y/P10u3Vib8o/DdkvA2OtPtZvD871QKjy74Wj1WSKFILMPRPSdUSx5RFK1arlJzEtA4PkFgnbuA==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">=18"
+ }
+ },
+ "node_modules/cross-spawn": {
+ "version": "7.0.6",
+ "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-7.0.6.tgz",
+ "integrity": "sha512-uV2QOWP2nWzsy2aMp8aRibhi9dlzF5Hgh5SHaB9OiTGEyDTiJJyx0uy51QXdyWbtAHNua4XJzUKca3OzKUd3vA==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "path-key": "^3.1.0",
+ "shebang-command": "^2.0.0",
+ "which": "^2.0.1"
+ },
+ "engines": {
+ "node": ">= 8"
+ }
+ },
+ "node_modules/debug": {
+ "version": "4.4.3",
+ "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.3.tgz",
+ "integrity": "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "ms": "^2.1.3"
+ },
+ "engines": {
+ "node": ">=6.0"
+ },
+ "peerDependenciesMeta": {
+ "supports-color": {
+ "optional": true
+ }
+ }
+ },
+ "node_modules/define-lazy-prop": {
+ "version": "2.0.0",
+ "resolved": "https://registry.npmjs.org/define-lazy-prop/-/define-lazy-prop-2.0.0.tgz",
+ "integrity": "sha512-Ds09qNh8yw3khSjiJjiUInaGX9xlqZDY7JVryGxdxV7NPeuqQfplOpQ66yJFZut3jLa5zOwkXw1g9EI2uKh4Og==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">=8"
+ }
+ },
+ "node_modules/elementtree": {
+ "version": "0.1.7",
+ "resolved": "https://registry.npmjs.org/elementtree/-/elementtree-0.1.7.tgz",
+ "integrity": "sha512-wkgGT6kugeQk/P6VZ/f4T+4HB41BVgNBq5CDIZVbQ02nvTVqAiVTbskxxu3eA/X96lMlfYOwnLQpN2v5E1zDEg==",
+ "dev": true,
+ "license": "Apache-2.0",
+ "dependencies": {
+ "sax": "1.1.4"
+ },
+ "engines": {
+ "node": ">= 0.4.0"
+ }
+ },
+ "node_modules/emoji-regex": {
+ "version": "8.0.0",
+ "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-8.0.0.tgz",
+ "integrity": "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A==",
+ "dev": true,
+ "license": "MIT"
+ },
+ "node_modules/env-paths": {
+ "version": "2.2.1",
+ "resolved": "https://registry.npmjs.org/env-paths/-/env-paths-2.2.1.tgz",
+ "integrity": "sha512-+h1lkLKhZMTYjog1VEpJNG7NZJWcuc2DDk/qsqSTRRCOXiLjeQ1d1/udrUGhqMxUgAlwKNZ0cf2uqan5GLuS2A==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">=6"
+ }
+ },
+ "node_modules/fd-slicer": {
+ "version": "1.1.0",
+ "resolved": "https://registry.npmjs.org/fd-slicer/-/fd-slicer-1.1.0.tgz",
+ "integrity": "sha512-cE1qsB/VwyQozZ+q1dGxR8LBYNZeofhEdUNGSMbQD3Gw2lAzX9Zb3uIU6Ebc/Fmyjo9AWWfnn0AUCHqtevs/8g==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "pend": "~1.2.0"
+ }
+ },
+ "node_modules/fs-extra": {
+ "version": "11.4.0",
+ "resolved": "https://registry.npmjs.org/fs-extra/-/fs-extra-11.4.0.tgz",
+ "integrity": "sha512-EQsFzMUJkCKGr1ePqlYADkIUmHW1s3ZXr5Yqy6wbGrfUCphpl2maM/kyOIRA2HpP3AaFQTZXD4ldjek+nccddA==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "graceful-fs": "^4.2.0",
+ "jsonfile": "^6.0.1",
+ "universalify": "^2.0.0"
+ },
+ "engines": {
+ "node": ">=14.14"
+ }
+ },
+ "node_modules/glob": {
+ "version": "13.0.6",
+ "resolved": "https://registry.npmjs.org/glob/-/glob-13.0.6.tgz",
+ "integrity": "sha512-Wjlyrolmm8uDpm/ogGyXZXb1Z+Ca2B8NbJwqBVg0axK9GbBeoS7yGV6vjXnYdGm6X53iehEuxxbyiKp8QmN4Vw==",
+ "dev": true,
+ "license": "BlueOak-1.0.0",
+ "dependencies": {
+ "minimatch": "^10.2.2",
+ "minipass": "^7.1.3",
+ "path-scurry": "^2.0.2"
+ },
+ "engines": {
+ "node": "18 || 20 || >=22"
+ },
+ "funding": {
+ "url": "https://github.com/sponsors/isaacs"
+ }
+ },
+ "node_modules/graceful-fs": {
+ "version": "4.2.11",
+ "resolved": "https://registry.npmjs.org/graceful-fs/-/graceful-fs-4.2.11.tgz",
+ "integrity": "sha512-RbJ5/jmFcNNCcDV5o9eTnBLJ/HszWV0P73bc+Ff4nS/rJj+YaS6IGyiOL0VoBYX+l1Wrl3k63h/KrH+nhJ0XvQ==",
+ "dev": true,
+ "license": "ISC"
+ },
+ "node_modules/inherits": {
+ "version": "2.0.4",
+ "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.4.tgz",
+ "integrity": "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ==",
+ "dev": true,
+ "license": "ISC"
+ },
+ "node_modules/ini": {
+ "version": "4.1.3",
+ "resolved": "https://registry.npmjs.org/ini/-/ini-4.1.3.tgz",
+ "integrity": "sha512-X7rqawQBvfdjS10YU1y1YVreA3SsLrW9dX2CewP2EbBJM4ypVNLDkO5y04gejPwKIY9lR+7r9gn3rFPt/kmWFg==",
+ "dev": true,
+ "license": "ISC",
+ "engines": {
+ "node": "^14.17.0 || ^16.13.0 || >=18.0.0"
+ }
+ },
+ "node_modules/is-docker": {
+ "version": "2.2.1",
+ "resolved": "https://registry.npmjs.org/is-docker/-/is-docker-2.2.1.tgz",
+ "integrity": "sha512-F+i2BKsFrH66iaUFc0woD8sLy8getkwTwtOBjvs56Cx4CgJDeKQeqfz8wAYiSb8JOprWhHH5p77PbmYCvvUuXQ==",
+ "dev": true,
+ "license": "MIT",
+ "bin": {
+ "is-docker": "cli.js"
+ },
+ "engines": {
+ "node": ">=8"
+ },
+ "funding": {
+ "url": "https://github.com/sponsors/sindresorhus"
+ }
+ },
+ "node_modules/is-fullwidth-code-point": {
+ "version": "3.0.0",
+ "resolved": "https://registry.npmjs.org/is-fullwidth-code-point/-/is-fullwidth-code-point-3.0.0.tgz",
+ "integrity": "sha512-zymm5+u+sCsSWyD9qNaejV3DFvhCKclKdizYaJUuHA83RLjb7nSuGnddCHGv0hk+KY7BMAlsWeK4Ueg6EV6XQg==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">=8"
+ }
+ },
+ "node_modules/is-wsl": {
+ "version": "2.2.0",
+ "resolved": "https://registry.npmjs.org/is-wsl/-/is-wsl-2.2.0.tgz",
+ "integrity": "sha512-fKzAra0rGJUUBwGBgNkHZuToZcn+TtXHpeCgmkMJMMYx1sQDYaCSyjJBSCa2nH1DGm7s3n1oBnohoVTBaN7Lww==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "is-docker": "^2.0.0"
+ },
+ "engines": {
+ "node": ">=8"
+ }
+ },
+ "node_modules/isexe": {
+ "version": "2.0.0",
+ "resolved": "https://registry.npmjs.org/isexe/-/isexe-2.0.0.tgz",
+ "integrity": "sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw==",
+ "dev": true,
+ "license": "ISC"
+ },
+ "node_modules/jsonfile": {
+ "version": "6.2.1",
+ "resolved": "https://registry.npmjs.org/jsonfile/-/jsonfile-6.2.1.tgz",
+ "integrity": "sha512-zwOTdL3rFQ/lRdBnntKVOX6k5cKJwEc1HdilT71BWEu7J41gXIB2MRp+vxduPSwZJPWBxEzv4yH1wYLJGUHX4Q==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "universalify": "^2.0.0"
+ },
+ "optionalDependencies": {
+ "graceful-fs": "^4.1.6"
+ }
+ },
+ "node_modules/kleur": {
+ "version": "4.1.5",
+ "resolved": "https://registry.npmjs.org/kleur/-/kleur-4.1.5.tgz",
+ "integrity": "sha512-o+NO+8WrRiQEE4/7nwRJhN1HWpVmJm511pBHUxPLtp0BUISzlBplORYSmTclCnJvQq2tKu/sgl3xVpkc7ZWuQQ==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">=6"
+ }
+ },
+ "node_modules/lru-cache": {
+ "version": "11.5.2",
+ "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-11.5.2.tgz",
+ "integrity": "sha512-4pfM1Ff0x50o0tQwb5ucw/RzNyD0/YJME6IVcStalZuMWxdt3sR3huStTtxz4PUmvZfRguvDejasvQ2kifR11g==",
+ "dev": true,
+ "license": "BlueOak-1.0.0",
+ "engines": {
+ "node": "20 || >=22"
+ }
+ },
+ "node_modules/minimatch": {
+ "version": "10.2.6",
+ "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-10.2.6.tgz",
+ "integrity": "sha512-vpLQEs+VLCr1nU0BXS07maYoFwlDAH0gngQuuttxIwutDFEMHq2blX+8vpgxDdK3J1PwjCJiep77OitTZ4Ll1A==",
+ "dev": true,
+ "license": "BlueOak-1.0.0",
+ "dependencies": {
+ "brace-expansion": "^5.0.8"
+ },
+ "engines": {
+ "node": "18 || 20 || >=22"
+ },
+ "funding": {
+ "url": "https://github.com/sponsors/isaacs"
+ }
+ },
+ "node_modules/minipass": {
+ "version": "7.1.3",
+ "resolved": "https://registry.npmjs.org/minipass/-/minipass-7.1.3.tgz",
+ "integrity": "sha512-tEBHqDnIoM/1rXME1zgka9g6Q2lcoCkxHLuc7ODJ5BxbP5d4c2Z5cGgtXAku59200Cx7diuHTOYfSBD8n6mm8A==",
+ "dev": true,
+ "license": "BlueOak-1.0.0",
+ "engines": {
+ "node": ">=16 || 14 >=14.17"
+ }
+ },
+ "node_modules/minizlib": {
+ "version": "3.1.0",
+ "resolved": "https://registry.npmjs.org/minizlib/-/minizlib-3.1.0.tgz",
+ "integrity": "sha512-KZxYo1BUkWD2TVFLr0MQoM8vUUigWD3LlD83a/75BqC+4qE0Hb1Vo5v1FgcfaNXvfXzr+5EhQ6ing/CaBijTlw==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "minipass": "^7.1.2"
+ },
+ "engines": {
+ "node": ">= 18"
+ }
+ },
+ "node_modules/ms": {
+ "version": "2.1.3",
+ "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz",
+ "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==",
+ "dev": true,
+ "license": "MIT"
+ },
+ "node_modules/native-run": {
+ "version": "2.0.3",
+ "resolved": "https://registry.npmjs.org/native-run/-/native-run-2.0.3.tgz",
+ "integrity": "sha512-U1PllBuzW5d1gfan+88L+Hky2eZx+9gv3Pf6rNBxKbORxi7boHzqiA6QFGSnqMem4j0A9tZ08NMIs5+0m/VS1Q==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "@ionic/utils-fs": "^3.1.7",
+ "@ionic/utils-terminal": "^2.3.4",
+ "bplist-parser": "^0.3.2",
+ "debug": "^4.3.4",
+ "elementtree": "^0.1.7",
+ "ini": "^4.1.1",
+ "plist": "^3.1.0",
+ "split2": "^4.2.0",
+ "through2": "^4.0.2",
+ "tslib": "^2.6.2",
+ "yauzl": "^2.10.0"
+ },
+ "bin": {
+ "native-run": "bin/native-run"
+ },
+ "engines": {
+ "node": ">=16.0.0"
+ }
+ },
+ "node_modules/open": {
+ "version": "8.4.2",
+ "resolved": "https://registry.npmjs.org/open/-/open-8.4.2.tgz",
+ "integrity": "sha512-7x81NCL719oNbsq/3mh+hVrAWmFuEYUqrq/Iw3kUzH8ReypT9QQ0BLoJS7/G9k6N81XjW4qHWtjWwe/9eLy1EQ==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "define-lazy-prop": "^2.0.0",
+ "is-docker": "^2.1.1",
+ "is-wsl": "^2.2.0"
+ },
+ "engines": {
+ "node": ">=12"
+ },
+ "funding": {
+ "url": "https://github.com/sponsors/sindresorhus"
+ }
+ },
+ "node_modules/package-json-from-dist": {
+ "version": "1.0.1",
+ "resolved": "https://registry.npmjs.org/package-json-from-dist/-/package-json-from-dist-1.0.1.tgz",
+ "integrity": "sha512-UEZIS3/by4OC8vL3P2dTXRETpebLI2NiI5vIrjaD/5UtrkFX/tNbwjTSRAGC/+7CAo2pIcBaRgWmcBBHcsaCIw==",
+ "dev": true,
+ "license": "BlueOak-1.0.0"
+ },
+ "node_modules/path-key": {
+ "version": "3.1.1",
+ "resolved": "https://registry.npmjs.org/path-key/-/path-key-3.1.1.tgz",
+ "integrity": "sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">=8"
+ }
+ },
+ "node_modules/path-scurry": {
+ "version": "2.0.2",
+ "resolved": "https://registry.npmjs.org/path-scurry/-/path-scurry-2.0.2.tgz",
+ "integrity": "sha512-3O/iVVsJAPsOnpwWIeD+d6z/7PmqApyQePUtCndjatj/9I5LylHvt5qluFaBT3I5h3r1ejfR056c+FCv+NnNXg==",
+ "dev": true,
+ "license": "BlueOak-1.0.0",
+ "dependencies": {
+ "lru-cache": "^11.0.0",
+ "minipass": "^7.1.2"
+ },
+ "engines": {
+ "node": "18 || 20 || >=22"
+ },
+ "funding": {
+ "url": "https://github.com/sponsors/isaacs"
+ }
+ },
+ "node_modules/pend": {
+ "version": "1.2.0",
+ "resolved": "https://registry.npmjs.org/pend/-/pend-1.2.0.tgz",
+ "integrity": "sha512-F3asv42UuXchdzt+xXqfW1OGlVBe+mxa2mqI0pg5yAHZPvFmY3Y6drSf/GQ1A86WgWEN9Kzh/WrgKa6iGcHXLg==",
+ "dev": true,
+ "license": "MIT"
+ },
+ "node_modules/plist": {
+ "version": "3.1.1",
+ "resolved": "https://registry.npmjs.org/plist/-/plist-3.1.1.tgz",
+ "integrity": "sha512-ZIfcLJC+7E7FBFnDxm9MPmt7D+DidyQ26lewieO75AdhA2ayMtsJSES0iWzqJQbcVRSrTufQoy0DR94xHue0oA==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "@xmldom/xmldom": "^0.9.10",
+ "base64-js": "^1.5.1",
+ "xmlbuilder": "^15.1.1"
+ },
+ "engines": {
+ "node": ">=10.4.0"
+ }
+ },
+ "node_modules/prompts": {
+ "version": "2.4.2",
+ "resolved": "https://registry.npmjs.org/prompts/-/prompts-2.4.2.tgz",
+ "integrity": "sha512-NxNv/kLguCA7p3jE8oL2aEBsrJWgAakBpgmgK6lpPWV+WuOmY6r2/zbAVnP+T8bQlA0nzHXSJSJW0Hq7ylaD2Q==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "kleur": "^3.0.3",
+ "sisteransi": "^1.0.5"
+ },
+ "engines": {
+ "node": ">= 6"
+ }
+ },
+ "node_modules/prompts/node_modules/kleur": {
+ "version": "3.0.3",
+ "resolved": "https://registry.npmjs.org/kleur/-/kleur-3.0.3.tgz",
+ "integrity": "sha512-eTIzlVOSUR+JxdDFepEYcBMtZ9Qqdef+rnzWdRZuMbOywu5tO2w2N7rqjoANZ5k9vywhL6Br1VRjUIgTQx4E8w==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">=6"
+ }
+ },
+ "node_modules/readable-stream": {
+ "version": "3.6.2",
+ "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-3.6.2.tgz",
+ "integrity": "sha512-9u/sniCrY3D5WdsERHzHE4G2YCXqoG5FTHUiCC4SIbr6XcLZBY05ya9EKjYek9O5xOAwjGq+1JdGBAS7Q9ScoA==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "inherits": "^2.0.3",
+ "string_decoder": "^1.1.1",
+ "util-deprecate": "^1.0.1"
+ },
+ "engines": {
+ "node": ">= 6"
+ }
+ },
+ "node_modules/rimraf": {
+ "version": "6.1.3",
+ "resolved": "https://registry.npmjs.org/rimraf/-/rimraf-6.1.3.tgz",
+ "integrity": "sha512-LKg+Cr2ZF61fkcaK1UdkH2yEBBKnYjTyWzTJT6KNPcSPaiT7HSdhtMXQuN5wkTX0Xu72KQ1l8S42rlmexS2hSA==",
+ "dev": true,
+ "license": "BlueOak-1.0.0",
+ "dependencies": {
+ "glob": "^13.0.3",
+ "package-json-from-dist": "^1.0.1"
+ },
+ "bin": {
+ "rimraf": "dist/esm/bin.mjs"
+ },
+ "engines": {
+ "node": "20 || >=22"
+ },
+ "funding": {
+ "url": "https://github.com/sponsors/isaacs"
+ }
+ },
+ "node_modules/safe-buffer": {
+ "version": "5.2.1",
+ "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.2.1.tgz",
+ "integrity": "sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ==",
+ "dev": true,
+ "funding": [
+ {
+ "type": "github",
+ "url": "https://github.com/sponsors/feross"
+ },
+ {
+ "type": "patreon",
+ "url": "https://www.patreon.com/feross"
+ },
+ {
+ "type": "consulting",
+ "url": "https://feross.org/support"
+ }
+ ],
+ "license": "MIT"
+ },
+ "node_modules/sax": {
+ "version": "1.1.4",
+ "resolved": "https://registry.npmjs.org/sax/-/sax-1.1.4.tgz",
+ "integrity": "sha512-5f3k2PbGGp+YtKJjOItpg3P99IMD84E4HOvcfleTb5joCHNXYLsR9yWFPOYGgaeMPDubQILTCMdsFb2OMeOjtg==",
+ "dev": true,
+ "license": "ISC"
+ },
+ "node_modules/semver": {
+ "version": "7.8.5",
+ "resolved": "https://registry.npmjs.org/semver/-/semver-7.8.5.tgz",
+ "integrity": "sha512-Y7/KDsb8LjooZpwaqGyulO6DQlksgCncchHGk+sZIY4SBvUocMBEFH5Ur1fI4dV+Jvl0w6cjvucaIi40puRioA==",
+ "dev": true,
+ "license": "ISC",
+ "bin": {
+ "semver": "bin/semver.js"
+ },
+ "engines": {
+ "node": ">=10"
+ }
+ },
+ "node_modules/shebang-command": {
+ "version": "2.0.0",
+ "resolved": "https://registry.npmjs.org/shebang-command/-/shebang-command-2.0.0.tgz",
+ "integrity": "sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "shebang-regex": "^3.0.0"
+ },
+ "engines": {
+ "node": ">=8"
+ }
+ },
+ "node_modules/shebang-regex": {
+ "version": "3.0.0",
+ "resolved": "https://registry.npmjs.org/shebang-regex/-/shebang-regex-3.0.0.tgz",
+ "integrity": "sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">=8"
+ }
+ },
+ "node_modules/signal-exit": {
+ "version": "3.0.7",
+ "resolved": "https://registry.npmjs.org/signal-exit/-/signal-exit-3.0.7.tgz",
+ "integrity": "sha512-wnD2ZE+l+SPC/uoS0vXeE9L1+0wuaMqKlfz9AMUo38JsyLSBWSFcHR1Rri62LZc12vLr1gb3jl7iwQhgwpAbGQ==",
+ "dev": true,
+ "license": "ISC"
+ },
+ "node_modules/simple-plist": {
+ "version": "1.3.1",
+ "resolved": "https://registry.npmjs.org/simple-plist/-/simple-plist-1.3.1.tgz",
+ "integrity": "sha512-iMSw5i0XseMnrhtIzRb7XpQEXepa9xhWxGUojHBL43SIpQuDQkh3Wpy67ZbDzZVr6EKxvwVChnVpdl8hEVLDiw==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "bplist-creator": "0.1.0",
+ "bplist-parser": "0.3.1",
+ "plist": "^3.0.5"
+ }
+ },
+ "node_modules/simple-plist/node_modules/bplist-parser": {
+ "version": "0.3.1",
+ "resolved": "https://registry.npmjs.org/bplist-parser/-/bplist-parser-0.3.1.tgz",
+ "integrity": "sha512-PyJxiNtA5T2PlLIeBot4lbp7rj4OadzjnMZD/G5zuBNt8ei/yCU7+wW0h2bag9vr8c+/WuRWmSxbqAl9hL1rBA==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "big-integer": "1.6.x"
+ },
+ "engines": {
+ "node": ">= 5.10.0"
+ }
+ },
+ "node_modules/sisteransi": {
+ "version": "1.0.5",
+ "resolved": "https://registry.npmjs.org/sisteransi/-/sisteransi-1.0.5.tgz",
+ "integrity": "sha512-bLGGlR1QxBcynn2d5YmDX4MGjlZvy2MRBDRNHLJ8VI6l6+9FUiyTFNJ0IveOSP0bcXgVDPRcfGqA0pjaqUpfVg==",
+ "dev": true,
+ "license": "MIT"
+ },
+ "node_modules/slice-ansi": {
+ "version": "4.0.0",
+ "resolved": "https://registry.npmjs.org/slice-ansi/-/slice-ansi-4.0.0.tgz",
+ "integrity": "sha512-qMCMfhY040cVHT43K9BFygqYbUPFZKHOg7K73mtTWJRb8pyP3fzf4Ixd5SzdEJQ6MRUg/WBnOLxghZtKKurENQ==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "ansi-styles": "^4.0.0",
+ "astral-regex": "^2.0.0",
+ "is-fullwidth-code-point": "^3.0.0"
+ },
+ "engines": {
+ "node": ">=10"
+ },
+ "funding": {
+ "url": "https://github.com/chalk/slice-ansi?sponsor=1"
+ }
+ },
+ "node_modules/split2": {
+ "version": "4.2.0",
+ "resolved": "https://registry.npmjs.org/split2/-/split2-4.2.0.tgz",
+ "integrity": "sha512-UcjcJOWknrNkF6PLX83qcHM6KHgVKNkV62Y8a5uYDVv9ydGQVwAHMKqHdJje1VTWpljG0WYpCDhrCdAOYH4TWg==",
+ "dev": true,
+ "license": "ISC",
+ "engines": {
+ "node": ">= 10.x"
+ }
+ },
+ "node_modules/stream-buffers": {
+ "version": "2.2.0",
+ "resolved": "https://registry.npmjs.org/stream-buffers/-/stream-buffers-2.2.0.tgz",
+ "integrity": "sha512-uyQK/mx5QjHun80FLJTfaWE7JtwfRMKBLkMne6udYOmvH0CawotVa7TfgYHzAnpphn4+TweIx1QKMnRIbipmUg==",
+ "dev": true,
+ "license": "Unlicense",
+ "engines": {
+ "node": ">= 0.10.0"
+ }
+ },
+ "node_modules/string_decoder": {
+ "version": "1.3.0",
+ "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-1.3.0.tgz",
+ "integrity": "sha512-hkRX8U1WjJFd8LsDJ2yQ/wWWxaopEsABU1XfkM8A+j0+85JAGppt16cr1Whg6KIbb4okU6Mql6BOj+uup/wKeA==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "safe-buffer": "~5.2.0"
+ }
+ },
+ "node_modules/string-width": {
+ "version": "4.2.3",
+ "resolved": "https://registry.npmjs.org/string-width/-/string-width-4.2.3.tgz",
+ "integrity": "sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "emoji-regex": "^8.0.0",
+ "is-fullwidth-code-point": "^3.0.0",
+ "strip-ansi": "^6.0.1"
+ },
+ "engines": {
+ "node": ">=8"
+ }
+ },
+ "node_modules/strip-ansi": {
+ "version": "6.0.1",
+ "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-6.0.1.tgz",
+ "integrity": "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "ansi-regex": "^5.0.1"
+ },
+ "engines": {
+ "node": ">=8"
+ }
+ },
+ "node_modules/tar": {
+ "version": "7.5.22",
+ "resolved": "https://registry.npmjs.org/tar/-/tar-7.5.22.tgz",
+ "integrity": "sha512-MFO/QzvtAOmJbkhOaCTvbGcFN9L9b+JunIsDwaKljSOdcLMea3NJ1k9Usz/rjdfSXTq4dfzfeS7W4p4YOAAHeA==",
+ "dev": true,
+ "license": "BlueOak-1.0.0",
+ "dependencies": {
+ "@isaacs/fs-minipass": "^4.0.0",
+ "chownr": "^3.0.0",
+ "minipass": "^7.1.2",
+ "minizlib": "^3.1.0",
+ "yallist": "^5.0.0"
+ },
+ "engines": {
+ "node": ">=18"
+ }
+ },
+ "node_modules/through2": {
+ "version": "4.0.2",
+ "resolved": "https://registry.npmjs.org/through2/-/through2-4.0.2.tgz",
+ "integrity": "sha512-iOqSav00cVxEEICeD7TjLB1sueEL+81Wpzp2bY17uZjZN0pWZPuo4suZ/61VujxmqSGFfgOcNuTZ85QJwNZQpw==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "readable-stream": "3"
+ }
+ },
+ "node_modules/tree-kill": {
+ "version": "1.2.2",
+ "resolved": "https://registry.npmjs.org/tree-kill/-/tree-kill-1.2.2.tgz",
+ "integrity": "sha512-L0Orpi8qGpRG//Nd+H90vFB+3iHnue1zSSGmNOOCh1GLJ7rUKVwV2HvijphGQS2UmhUZewS9VgvxYIdgr+fG1A==",
+ "dev": true,
+ "license": "MIT",
+ "bin": {
+ "tree-kill": "cli.js"
+ }
+ },
+ "node_modules/tslib": {
+ "version": "2.8.1",
+ "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.8.1.tgz",
+ "integrity": "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w==",
+ "license": "0BSD"
+ },
+ "node_modules/undici-types": {
+ "version": "8.3.0",
+ "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-8.3.0.tgz",
+ "integrity": "sha512-j375ScV60dom+YkPFIfTLcOiPxkN/buHz5GobjLhixFuANaNs3C9l4GmrWqejgXWJ7BbJcFYpTEUkS1Ge8bpZQ==",
+ "dev": true,
+ "license": "MIT"
+ },
+ "node_modules/universalify": {
+ "version": "2.0.1",
+ "resolved": "https://registry.npmjs.org/universalify/-/universalify-2.0.1.tgz",
+ "integrity": "sha512-gptHNQghINnc/vTGIk0SOFGFNXw7JVrlRUtConJRlvaw6DuX0wO5Jeko9sWrMBhh+PsYAZ7oXAiOnf/UKogyiw==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">= 10.0.0"
+ }
+ },
+ "node_modules/untildify": {
+ "version": "4.0.0",
+ "resolved": "https://registry.npmjs.org/untildify/-/untildify-4.0.0.tgz",
+ "integrity": "sha512-KK8xQ1mkzZeg9inewmFVDNkg3l5LUhoq9kN6iWYB/CC9YMG8HA+c1Q8HwDe6dEX7kErrEVNVBO3fWsVq5iDgtw==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">=8"
+ }
+ },
+ "node_modules/util-deprecate": {
+ "version": "1.0.2",
+ "resolved": "https://registry.npmjs.org/util-deprecate/-/util-deprecate-1.0.2.tgz",
+ "integrity": "sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw==",
+ "dev": true,
+ "license": "MIT"
+ },
+ "node_modules/uuid": {
+ "version": "7.0.3",
+ "resolved": "https://registry.npmjs.org/uuid/-/uuid-7.0.3.tgz",
+ "integrity": "sha512-DPSke0pXhTZgoF/d+WSt2QaKMCFSfx7QegxEWT+JOuHF5aWrKEn0G+ztjuJg/gG8/ItK+rbPCD/yNv8yyih6Cg==",
+ "deprecated": "uuid@10 and below is no longer supported. For ESM codebases, update to uuid@latest. For CommonJS codebases, use uuid@11 (but be aware this version will likely be deprecated in 2028).",
+ "dev": true,
+ "license": "MIT",
+ "bin": {
+ "uuid": "dist/bin/uuid"
+ }
+ },
+ "node_modules/which": {
+ "version": "2.0.2",
+ "resolved": "https://registry.npmjs.org/which/-/which-2.0.2.tgz",
+ "integrity": "sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA==",
+ "dev": true,
+ "license": "ISC",
+ "dependencies": {
+ "isexe": "^2.0.0"
+ },
+ "bin": {
+ "node-which": "bin/node-which"
+ },
+ "engines": {
+ "node": ">= 8"
+ }
+ },
+ "node_modules/wrap-ansi": {
+ "version": "7.0.0",
+ "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-7.0.0.tgz",
+ "integrity": "sha512-YVGIj2kamLSTxw6NsZjoBxfSwsn0ycdesmc4p+Q21c5zPuZ1pl+NfxVdxPtdHvmNVOQ6XSYG4AUtyt/Fi7D16Q==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "ansi-styles": "^4.0.0",
+ "string-width": "^4.1.0",
+ "strip-ansi": "^6.0.0"
+ },
+ "engines": {
+ "node": ">=10"
+ },
+ "funding": {
+ "url": "https://github.com/chalk/wrap-ansi?sponsor=1"
+ }
+ },
+ "node_modules/xcode": {
+ "version": "3.0.1",
+ "resolved": "https://registry.npmjs.org/xcode/-/xcode-3.0.1.tgz",
+ "integrity": "sha512-kCz5k7J7XbJtjABOvkc5lJmkiDh8VhjVCGNiqdKCscmVpdVUpEAyXv1xmCLkQJ5dsHqx3IPO4XW+NTDhU/fatA==",
+ "dev": true,
+ "license": "Apache-2.0",
+ "dependencies": {
+ "simple-plist": "^1.1.0",
+ "uuid": "^7.0.3"
+ },
+ "engines": {
+ "node": ">=10.0.0"
+ }
+ },
+ "node_modules/xml2js": {
+ "version": "0.6.2",
+ "resolved": "https://registry.npmjs.org/xml2js/-/xml2js-0.6.2.tgz",
+ "integrity": "sha512-T4rieHaC1EXcES0Kxxj4JWgaUQHDk+qwHcYOCFHfiwKz7tOVPLq7Hjq9dM1WCMhylqMEfP7hMcOIChvotiZegA==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "sax": ">=0.6.0",
+ "xmlbuilder": "~11.0.0"
+ },
+ "engines": {
+ "node": ">=4.0.0"
+ }
+ },
+ "node_modules/xml2js/node_modules/xmlbuilder": {
+ "version": "11.0.1",
+ "resolved": "https://registry.npmjs.org/xmlbuilder/-/xmlbuilder-11.0.1.tgz",
+ "integrity": "sha512-fDlsI/kFEx7gLvbecc0/ohLG50fugQp8ryHzMTuW9vSa1GJ0XYWKnhsUx7oie3G98+r56aTQIUB4kht42R3JvA==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">=4.0"
+ }
+ },
+ "node_modules/xmlbuilder": {
+ "version": "15.1.1",
+ "resolved": "https://registry.npmjs.org/xmlbuilder/-/xmlbuilder-15.1.1.tgz",
+ "integrity": "sha512-yMqGBqtXyeN1e3TGYvgNgDVZ3j84W4cwkOXQswghol6APgZWaff9lnbvN7MHYJOiXsvGPXtjTYJEiC9J2wv9Eg==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">=8.0"
+ }
+ },
+ "node_modules/yallist": {
+ "version": "5.0.0",
+ "resolved": "https://registry.npmjs.org/yallist/-/yallist-5.0.0.tgz",
+ "integrity": "sha512-YgvUTfwqyc7UXVMrB+SImsVYSmTS8X/tSrtdNZMImM+n7+QTriRXyXim0mBrTXNeqzVF0KWGgHPeiyViFFrNDw==",
+ "dev": true,
+ "license": "BlueOak-1.0.0",
+ "engines": {
+ "node": ">=18"
+ }
+ },
+ "node_modules/yauzl": {
+ "version": "2.10.0",
+ "resolved": "https://registry.npmjs.org/yauzl/-/yauzl-2.10.0.tgz",
+ "integrity": "sha512-p4a9I6X6nu6IhoGmBqAcbJy1mlC4j27vEPZX9F4L4/vZT3Lyq1VkFHw/V/PUcB9Buo+DG3iHkT0x3Qya58zc3g==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "buffer-crc32": "~0.2.3",
+ "fd-slicer": "~1.1.0"
+ }
+ }
+ }
+}
diff --git a/ios/package.json b/ios/package.json
new file mode 100644
index 000000000..68a41dbc9
--- /dev/null
+++ b/ios/package.json
@@ -0,0 +1,32 @@
+{
+ "name": "three-ws-ios",
+ "private": true,
+ "version": "1.0.0",
+ "description": "three.ws iOS app: Capacitor shell + native extensions (share, push, widgets, App Intents) around the three.ws product.",
+ "type": "module",
+ "scripts": {
+ "sync": "cap sync ios",
+ "copy": "cap copy ios",
+ "open": "cap open ios",
+ "doctor": "cap doctor ios"
+ },
+ "dependencies": {
+ "@capacitor/app": "^8.0.0",
+ "@capacitor/browser": "^8.0.0",
+ "@capacitor/camera": "^8.0.0",
+ "@capacitor/core": "^8.0.0",
+ "@capacitor/device": "^8.0.0",
+ "@capacitor/filesystem": "^8.0.0",
+ "@capacitor/geolocation": "^8.0.0",
+ "@capacitor/haptics": "^8.0.0",
+ "@capacitor/ios": "^8.0.0",
+ "@capacitor/preferences": "^8.0.0",
+ "@capacitor/push-notifications": "^8.0.0",
+ "@capacitor/share": "^8.0.0",
+ "@capacitor/splash-screen": "^8.0.0",
+ "@capacitor/status-bar": "^8.0.0"
+ },
+ "devDependencies": {
+ "@capacitor/cli": "^8.0.0"
+ }
+}
diff --git a/ios/publish/listing.md b/ios/publish/listing.md
new file mode 100644
index 000000000..702710c5a
--- /dev/null
+++ b/ios/publish/listing.md
@@ -0,0 +1,120 @@
+# App Store listing copy
+
+Every field App Store Connect asks for, filled in, so the submission is a copy
+and paste rather than a writing session. Character limits are Apple's and are
+enforced by the form.
+
+## Name (30 characters max)
+
+```
+three.ws: 3D AI Agents
+```
+
+## Subtitle (30 characters max)
+
+```
+Give your AI a body
+```
+
+## Promotional text (170 characters, editable without a new build)
+
+```
+Describe a character, get a rigged 3D avatar in under a minute, then stand it up in your actual room in AR. Your agents, animated, anywhere.
+```
+
+## Description (4000 characters max)
+
+```
+three.ws turns a sentence into a 3D character you can animate, talk to, and place in the real world.
+
+CREATE
+Describe what you want and get a textured 3D model back. Add a face from a selfie. Every humanoid comes rigged and animation-ready, so it walks, idles and gestures from the moment it exists. No modelling, no rigging, no software to learn.
+
+SEE IT IN YOUR ROOM
+Point your camera at the floor and put your agent there. Place as many as you like, move them, resize them, walk around them. Real lighting from your room, real occlusion behind real furniture. Capture a photo and share it.
+
+PIN IT TO A PLACE
+Leave an agent at a real location and let other people find it there. A character at your favourite bench, a guide at the entrance to a building, a companion where you left it.
+
+TALK TO IT
+Give an agent a voice and a personality and have a conversation out loud. It looks at you while you speak.
+
+BRING IT ANYWHERE
+Everything you make exports as a standard GLB and embeds in any website with one line of code. Your work is not trapped in an app.
+
+BROWSE WHAT OTHERS MADE
+A live feed of what the community is creating, full creator profiles, and a marketplace of agents you can use.
+
+three.ws is the 3D layer for the agentic web. Everything you create is yours, in open formats, on open standards.
+```
+
+## Keywords (100 characters, comma separated, no spaces)
+
+```
+3d,avatar,ai,agent,ar,augmented,reality,character,animation,glb,creator,generator,rig,model,studio
+```
+
+## Support URL
+
+```
+https://three.ws/docs
+```
+
+## Marketing URL
+
+```
+https://three.ws
+```
+
+## Privacy policy URL
+
+```
+https://three.ws/privacy
+```
+
+Verify this route resolves before submitting; a 404 here is an automatic
+rejection.
+
+## Category
+
+- Primary: **Graphics & Design**
+- Secondary: **Photo & Video**
+
+`Graphics & Design` over `Entertainment` because the product is a creation tool
+and the App Store ranks it against tools rather than games.
+
+## Age rating
+
+Expect 12+. The honest answers to the questionnaire are: user-generated content
+is present, so the UGC questions apply; no gambling, no realistic violence, no
+sexual content. Answer the questionnaire from the product, not from this note.
+
+## App Privacy (data collection disclosure)
+
+Declare what the app actually collects and how it is used. At minimum:
+
+| Data type | Collected | Linked to identity | Used for |
+|---|---|---|---|
+| Email address | Yes | Yes | App functionality (account) |
+| User content (photos, models, prompts) | Yes | Yes | App functionality |
+| Coarse location | Yes | Yes | App functionality (IRL pins) |
+| Identifiers (user ID) | Yes | Yes | App functionality, analytics |
+| Usage data | Yes | Yes | Analytics, product improvement |
+| Purchases / wallet activity | Review before answering | | |
+
+The last row needs a real answer from whoever knows the current wallet and
+payments surfaces; do not guess it on the form.
+
+## Notes for the reviewer
+
+```
+three.ws is a 3D content creation tool. A reviewer can exercise the whole core product without an account: open Create, type a prompt, and a 3D model is generated and rendered. Placing a model in AR needs camera access on a physical device.
+
+Demo account (if one is wanted): supplied separately in App Store Connect.
+
+On blockchain functionality: the app displays 3D characters that creators may optionally have registered on a public blockchain, and shows read-only wallet and ownership information. Transactional surfaces are not offered inside the app; they open in Safari.
+```
+
+Keep that last paragraph true. If the app ships with in-app transactional
+surfaces, rewrite it and read [`../docs/REVIEW-RISK.md`](../docs/REVIEW-RISK.md)
+again first.
diff --git a/ios/shell/index.html b/ios/shell/index.html
new file mode 100644
index 000000000..4450b1338
--- /dev/null
+++ b/ios/shell/index.html
@@ -0,0 +1,25 @@
+<!doctype html>
+<html lang="en">
+ <head>
+ <meta charset="utf-8" />
+ <meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover" />
+ <title>three.ws</title>
+ <meta http-equiv="refresh" content="0; url=https://three.ws/?source=ios" />
+ <style>
+ html, body { height: 100%; margin: 0; background: #080814; }
+ </style>
+ </head>
+ <body>
+ <!--
+ Bootstrap only. With server.url set in capacitor.config.ts the WebView
+ goes straight to https://three.ws and never renders this file; it exists
+ so that a bundle loaded on its own (a simulator run with the server
+ config stripped, a future local-first build) still reaches the product
+ instead of a blank frame. The designed no-network screen is
+ offline.html, wired as server.errorPath.
+ -->
+ <script>
+ location.replace('https://three.ws/?source=ios');
+ </script>
+ </body>
+</html>
diff --git a/ios/shell/offline.html b/ios/shell/offline.html
new file mode 100644
index 000000000..e7ed504b4
--- /dev/null
+++ b/ios/shell/offline.html
@@ -0,0 +1,116 @@
+<!doctype html>
+<html lang="en">
+ <head>
+ <meta charset="utf-8" />
+ <meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover" />
+ <title>three.ws</title>
+ <style>
+ :root {
+ color-scheme: dark;
+ --bg: #080814;
+ --fg: #f5f5ff;
+ --muted: #8a8aa8;
+ --accent: #6f5cff;
+ --edge: rgba(255, 255, 255, 0.1);
+ }
+ * { box-sizing: border-box; }
+ html, body { height: 100%; margin: 0; }
+ body {
+ background: radial-gradient(120% 80% at 50% 0%, #16163a 0%, var(--bg) 60%);
+ color: var(--fg);
+ font: 400 17px/1.5 -apple-system, BlinkMacSystemFont, "SF Pro Text", system-ui, sans-serif;
+ display: grid;
+ place-items: center;
+ padding: max(24px, env(safe-area-inset-top)) 24px max(24px, env(safe-area-inset-bottom));
+ text-align: center;
+ -webkit-user-select: none;
+ user-select: none;
+ }
+ main { max-width: 22rem; }
+ .mark {
+ width: 64px;
+ height: 64px;
+ margin: 0 auto 24px;
+ border-radius: 18px;
+ border: 1px solid var(--edge);
+ background: linear-gradient(145deg, #1d1d44, #0d0d22);
+ display: grid;
+ place-items: center;
+ font: 600 15px/1 "SF Mono", ui-monospace, monospace;
+ letter-spacing: 0.04em;
+ color: var(--accent);
+ }
+ h1 { font-size: 22px; font-weight: 600; margin: 0 0 10px; letter-spacing: -0.01em; }
+ p { color: var(--muted); margin: 0 0 28px; font-size: 15px; }
+ button {
+ appearance: none;
+ border: 0;
+ border-radius: 12px;
+ background: var(--accent);
+ color: #fff;
+ font: 600 16px/1 inherit;
+ padding: 15px 28px;
+ min-height: 48px;
+ width: 100%;
+ transition: transform 0.15s ease, opacity 0.15s ease;
+ }
+ button:active { transform: scale(0.97); opacity: 0.85; }
+ button:focus-visible { outline: 2px solid #fff; outline-offset: 3px; }
+ button[aria-busy='true'] { opacity: 0.6; }
+ .status { margin-top: 18px; font-size: 13px; color: var(--muted); min-height: 1.2em; }
+ </style>
+ </head>
+ <body>
+ <main>
+ <div class="mark" aria-hidden="true">3ws</div>
+ <h1>You are offline</h1>
+ <p>three.ws needs a connection to load your agents, avatars and worlds. Everything you have created is safe.</p>
+ <button id="retry" type="button">Try again</button>
+ <p class="status" id="status" role="status" aria-live="polite"></p>
+ </main>
+ <script>
+ const retry = document.getElementById('retry');
+ const status = document.getElementById('status');
+ const HOME = 'https://three.ws/?source=ios';
+
+ function go() {
+ retry.setAttribute('aria-busy', 'true');
+ status.textContent = 'Reconnecting…';
+ location.replace(HOME);
+ }
+
+ retry.addEventListener('click', go);
+
+ // Reachability, not navigator.onLine: iOS reports online on a captive
+ // portal and on a Wi-Fi network with no route out. A HEAD that actually
+ // lands is the only signal worth auto-retrying on.
+ async function reachable() {
+ try {
+ const res = await fetch('https://three.ws/api/healthz', {
+ method: 'HEAD',
+ cache: 'no-store',
+ signal: AbortSignal.timeout(4000),
+ });
+ return res.ok;
+ } catch {
+ return false;
+ }
+ }
+
+ let checking = false;
+ async function poll() {
+ if (checking) return;
+ checking = true;
+ if (await reachable()) go();
+ checking = false;
+ }
+
+ window.addEventListener('online', poll);
+ document.addEventListener('visibilitychange', () => {
+ if (document.visibilityState === 'visible') poll();
+ });
+ setInterval(poll, 5000);
+ poll();
+ </script>
+ </body>
+</html>
diff --git a/ios/src/native-bridge.js b/ios/src/native-bridge.js
new file mode 100644
index 000000000..2323d9d34
--- /dev/null
+++ b/ios/src/native-bridge.js
@@ -0,0 +1,322 @@
+// Web-side half of the three.ws iOS app.
+//
+// The iOS app is a Capacitor shell whose WebView loads the live product at
+// https://three.ws (see ios/capacitor.config.ts for why it is not a baked-in
+// copy of dist/). Capacitor injects its native bridge into that page at document
+// start, so `window.Capacitor` is present on the real site whenever it is being
+// viewed inside the app and absent in every browser. This module is what turns
+// that fact into app behaviour: it repairs the WKWebView APIs that a website
+// normally gets for free, routes off-site links out to Safari, handles deep
+// links, and hides the launch screen once there is something to look at.
+//
+// It is a no-op outside the app, which is why it is safe to load on every page.
+// Wired in by the `three-ws-ios-native-bridge` plugin in vite.config.js.
+//
+// The Android/Seeker equivalent is solana-mobile/src/, which follows the same
+// shape: detection first, then capability shims, then a single boot function.
+
+let cachedNative = null;
+
+/**
+ * True when this page is running inside the three.ws iOS app.
+ *
+ * `Capacitor.isNativePlatform()` is the only honest signal. User-agent sniffing
+ * cannot tell the app from Safari (WKWebView sends the same UA), and
+ * `navigator.standalone` reports true for a home-screen PWA, which is a
+ * different runtime with none of these plugins.
+ *
+ * @returns {boolean}
+ */
+export function isNativeIOS() {
+ if (cachedNative !== null) return cachedNative;
+ const cap = globalThis.Capacitor;
+ cachedNative = Boolean(cap?.isNativePlatform?.() && cap?.getPlatform?.() === 'ios');
+ return cachedNative;
+}
+
+/**
+ * Load a Capacitor plugin only inside the app.
+ *
+ * Every plugin package is a dependency of ios/package.json, not of the site
+ * bundle, so these imports must never be statically analysable: a bare
+ * `import '@capacitor/share'` in site code fails the Vite build on a machine
+ * that has never touched the iOS project. Inside the app the plugins are
+ * already registered natively and exposed on `Capacitor.Plugins`, so reading
+ * them off the global is both correct and free.
+ *
+ * @param {string} name Registered plugin name, e.g. 'Share'.
+ * @returns {object|null}
+ */
+function plugin(name) {
+ if (!isNativeIOS()) return null;
+ return globalThis.Capacitor?.Plugins?.[name] ?? null;
+}
+
+/**
+ * Marks the document so CSS can target the app.
+ *
+ * `html.ios-app` exists because a handful of surfaces need app-only chrome: the
+ * install prompts and "add to home screen" nudges must not render inside an
+ * app that is already installed, and the bottom-edge controls need the home
+ * indicator's inset. `--ios-safe-top` / `--ios-safe-bottom` mirror the env()
+ * values into custom properties so they can be used in calc() on browsers that
+ * still mis-handle env() inside nested calc.
+ */
+function markDocument() {
+ const root = document.documentElement;
+ root.classList.add('ios-app', 'native-app');
+ root.style.setProperty('--ios-safe-top', 'env(safe-area-inset-top, 0px)');
+ root.style.setProperty('--ios-safe-bottom', 'env(safe-area-inset-bottom, 0px)');
+}
+
+/**
+ * Hides the launch screen once the first real frame is on screen.
+ *
+ * capacitor.config.ts sets `launchAutoHide: false` deliberately. Auto-hide fires
+ * on WebView load, which on a three.js page is minutes before anything is
+ * rendered, so the user watches a black void instead of the launch screen. The
+ * WebGL surfaces here mount asynchronously, so the trigger is the first paint of
+ * real content plus a hard ceiling: a page that never paints must still reveal
+ * itself rather than hold the launch screen forever.
+ */
+function hideSplashWhenPainted() {
+ const splash = plugin('SplashScreen');
+ if (!splash) return;
+ let done = false;
+ const hide = () => {
+ if (done) return;
+ done = true;
+ splash.hide({ fadeOutDuration: 220 }).catch(() => {});
+ };
+ if (typeof requestAnimationFrame === 'function') {
+ requestAnimationFrame(() => requestAnimationFrame(hide));
+ }
+ // Ceiling. A failed fetch, a WebGL context that never initialises, or a
+ // backgrounded tab can all starve rAF; none of them justify a stuck splash.
+ setTimeout(hide, 4000);
+ window.addEventListener('pageshow', hide, { once: true });
+}
+
+/** Chooses the light status bar content the dark product needs. */
+function styleStatusBar() {
+ const bar = plugin('StatusBar');
+ if (!bar) return;
+ // 'DARK' in Capacitor's vocabulary means dark *background*, i.e. light text.
+ bar.setStyle({ style: 'DARK' }).catch(() => {});
+ bar.setOverlaysWebView({ overlay: true }).catch(() => {});
+}
+
+const INTERNAL_HOSTS = new Set(['three.ws', 'www.three.ws']);
+
+/**
+ * @param {string} href
+ * @returns {boolean} true when the URL belongs to the product itself.
+ */
+export function isInternalUrl(href) {
+ try {
+ const url = new URL(href, location.href);
+ if (url.protocol !== 'https:' && url.protocol !== 'http:') return true;
+ return INTERNAL_HOSTS.has(url.hostname);
+ } catch {
+ // A malformed href is a same-document anchor or a broken link; either way
+ // it is not something to hand to the system browser.
+ return true;
+ }
+}
+
+/**
+ * Sends off-site links to an in-app Safari sheet instead of replacing the app.
+ *
+ * Without this, tapping a link to a block explorer, a docs site, or an X post
+ * navigates the app's only WebView away from three.ws with no way back: iOS has
+ * no back button and Capacitor's WebView ships with back/forward gestures off.
+ * Apple also rejects apps that run third-party sign-in inside an embedded
+ * WebView, which is the other reason this cannot be left to the WebView.
+ */
+function routeExternalLinks() {
+ const browser = plugin('Browser');
+ if (!browser) return;
+ document.addEventListener(
+ 'click',
+ (ev) => {
+ if (ev.defaultPrevented || ev.button !== 0 || ev.metaKey || ev.ctrlKey) return;
+ const anchor = ev.target?.closest?.('a[href]');
+ if (!anchor) return;
+ const href = anchor.getAttribute('href');
+ if (!href || href.startsWith('#') || isInternalUrl(href)) return;
+ // download links are the one external case that must stay native: the
+ // share sheet handles them, an in-app browser sheet cannot.
+ if (anchor.hasAttribute('download')) return;
+ ev.preventDefault();
+ browser
+ .open({ url: new URL(href, location.href).href, presentationStyle: 'popover' })
+ .catch(() => {
+ // Sheet refused (no network, malformed scheme): fall back to the
+ // plain navigation rather than swallowing the user's tap.
+ location.href = href;
+ });
+ },
+ // Capture, so this wins over per-surface click handlers that would
+ // otherwise stopPropagation() before the link is ever seen.
+ true,
+ );
+}
+
+/**
+ * Gives the app a working `navigator.share`.
+ *
+ * WKWebView does not implement the Web Share API: it exists only in Safari
+ * proper. Every share affordance on the platform (an AR capture, an /irl/s/
+ * link, an agent profile) calls navigator.share and silently does nothing
+ * inside the app. This maps it onto the native share sheet, including the file
+ * case, which needs the blob written to disk first because the Share plugin
+ * takes file URIs and not Blobs.
+ */
+function installShare() {
+ const share = plugin('Share');
+ const fs = plugin('Filesystem');
+ if (!share) return;
+ if (typeof navigator.share === 'function') return;
+
+ async function blobToCacheUri(file) {
+ if (!fs) return null;
+ const base64 = await new Promise((resolve, reject) => {
+ const reader = new FileReader();
+ reader.onerror = () => reject(reader.error ?? new Error('read failed'));
+ reader.onload = () => {
+ const result = String(reader.result ?? '');
+ // FileReader hands back a data: URL; the plugin wants raw base64.
+ resolve(result.slice(result.indexOf(',') + 1));
+ };
+ reader.readAsDataURL(file);
+ });
+ const name = file.name || `three-ws-${Date.now()}`;
+ // CACHE, not DOCUMENTS: these are transient artefacts of one share and
+ // should not accumulate in a directory the user can browse or back up.
+ const written = await fs.writeFile({ path: name, data: base64, directory: 'CACHE' });
+ return written?.uri ?? null;
+ }
+
+ navigator.share = async (data = {}) => {
+ const files = Array.isArray(data.files) ? data.files : [];
+ const uris = [];
+ for (const file of files) {
+ const uri = await blobToCacheUri(file);
+ if (uri) uris.push(uri);
+ }
+ await share.share({
+ title: data.title || undefined,
+ text: data.text || undefined,
+ url: data.url || undefined,
+ files: uris.length ? uris : undefined,
+ dialogTitle: data.title || 'Share',
+ });
+ };
+
+ // Callers feature-detect with canShare before offering the affordance.
+ navigator.canShare = (data = {}) => {
+ if (!data || typeof data !== 'object') return false;
+ if (Array.isArray(data.files) && data.files.length) return Boolean(fs);
+ return Boolean(data.url || data.text || data.title);
+ };
+}
+
+/**
+ * Routes universal links and threews:// deep links to the right page.
+ *
+ * An https://three.ws link caught by the associated-domains entitlement, and a
+ * threews://<path> link from a wallet or OAuth redirect, both arrive here rather
+ * than as a navigation. Anything off-domain is refused outright: appUrlOpen is
+ * an entry point another app can call, so treating its payload as a navigation
+ * target without checking the host would let any installed app push the WebView
+ * wherever it liked.
+ */
+function routeDeepLinks() {
+ const app = plugin('App');
+ if (!app) return;
+ app.addListener('appUrlOpen', (event) => {
+ const raw = event?.url;
+ if (!raw) return;
+ let target = null;
+ try {
+ const url = new URL(raw);
+ if (url.protocol === 'threews:') {
+ // threews://create?x=1 -> /create?x=1. The custom scheme puts the
+ // first path segment in `hostname`, which is a URL parsing quirk and
+ // not a host in any meaningful sense.
+ const path = `${url.hostname ? `/${url.hostname}` : ''}${url.pathname}`;
+ target = `https://three.ws${path || '/'}${url.search}${url.hash}`;
+ } else if (INTERNAL_HOSTS.has(url.hostname)) {
+ target = url.href;
+ }
+ } catch {
+ return;
+ }
+ if (!target) return;
+ if (target === location.href) return;
+ location.assign(target);
+ });
+}
+
+/**
+ * Short haptic tick for primary actions.
+ *
+ * Exposed as `window.threeWsHaptic` so surfaces can call it without importing
+ * anything, and wired to `[data-haptic]` so the common case needs no JS at all.
+ * Silently absent outside the app, which is the correct behaviour: a browser
+ * has nothing to buzz.
+ *
+ * @param {'light'|'medium'|'heavy'} [strength]
+ */
+export async function haptic(strength = 'light') {
+ const haptics = plugin('Haptics');
+ if (!haptics) return;
+ const style = { light: 'LIGHT', medium: 'MEDIUM', heavy: 'HEAVY' }[strength] ?? 'LIGHT';
+ await haptics.impact({ style }).catch(() => {});
+}
+
+function installHaptics() {
+ if (!isNativeIOS()) return;
+ globalThis.threeWsHaptic = haptic;
+ document.addEventListener(
+ 'click',
+ (ev) => {
+ const el = ev.target?.closest?.('[data-haptic]');
+ if (!el) return;
+ haptic(el.getAttribute('data-haptic') || 'light');
+ },
+ true,
+ );
+}
+
+let booted = false;
+
+/**
+ * Boots every app-only behaviour. Safe to call more than once and on every page.
+ *
+ * @returns {boolean} true if the app layer was installed, false in a browser.
+ */
+export function bootNativeIOS() {
+ if (booted) return isNativeIOS();
+ booted = true;
+ if (!isNativeIOS()) return false;
+ markDocument();
+ styleStatusBar();
+ installShare();
+ installHaptics();
+ routeExternalLinks();
+ routeDeepLinks();
+ hideSplashWhenPainted();
+ return true;
+}
+
+// Auto-boot. This module is injected into every page of the built site, and the
+// behaviours it installs (share, external links, splash) are all things a page
+// can need before any of its own code runs.
+if (typeof document !== 'undefined') {
+ if (document.readyState === 'loading') {
+ document.addEventListener('DOMContentLoaded', bootNativeIOS, { once: true });
+ } else {
+ bootNativeIOS();
+ }
+}
diff --git a/package.json b/package.json
index e5385315a..42cfc8594 100644
--- a/package.json
+++ b/package.json
@@ -380,6 +380,8 @@
"okx:three-copy": "node scripts/okx-three-copy-check.mjs",
"okx:gauntlet": "node scripts/okx-e2e-gauntlet.mjs",
"check:conflicts": "node scripts/check-merge-conflicts.mjs",
+ "ios:sync": "npm --prefix ios install --silent && npm --prefix ios run sync",
+ "ios:open": "npm --prefix ios run open",
"clean:worktrees": "node scripts/clean-deploy-worktrees.mjs",
"prep:worktree": "node scripts/prepare-deploy-worktree.mjs",
"check:browser-graph": "node scripts/check-browser-graph.mjs",
diff --git a/tests/api/apple-app-site-association.test.js b/tests/api/apple-app-site-association.test.js
new file mode 100644
index 000000000..06e06c0c8
--- /dev/null
+++ b/tests/api/apple-app-site-association.test.js
@@ -0,0 +1,101 @@
+/**
+ * /.well-known/apple-app-site-association
+ *
+ * The file iOS fetches to decide whether a three.ws link opens the app instead
+ * of Safari. Its failure mode is the reason it is tested: a wrong or absent
+ * association produces no error anywhere. Links simply keep opening in Safari,
+ * on every device, until someone thinks to check. So the two things worth
+ * pinning are that it never publishes an association for a team that cannot
+ * sign (which is what an empty APPLE_TEAM_ID would do), and that the app
+ * identifier is exactly "<Team ID>.<bundle id>" with no stray whitespace from
+ * a value pasted out of the developer portal.
+ */
+
+import { describe, it, expect, afterEach } from 'vitest';
+import handler from '../../api/wk.js';
+
+const NAME = 'apple-app-site-association';
+const BUNDLE_ID = 'ws.three.app';
+
+function fakeRes() {
+ const headers = {};
+ return {
+ statusCode: 0,
+ body: undefined,
+ setHeader(k, v) {
+ headers[String(k).toLowerCase()] = v;
+ },
+ getHeader(k) {
+ return headers[String(k).toLowerCase()];
+ },
+ end(b) {
+ this.body = b;
+ },
+ _headers: headers,
+ };
+}
+
+async function call() {
+ const res = fakeRes();
+ await handler(
+ { method: 'GET', headers: {}, url: `/api/wk?name=${NAME}`, query: { name: NAME } },
+ res,
+ );
+ return { res, json: res.body ? JSON.parse(res.body) : undefined };
+}
+
+const original = process.env.APPLE_TEAM_ID;
+
+afterEach(() => {
+ if (original === undefined) delete process.env.APPLE_TEAM_ID;
+ else process.env.APPLE_TEAM_ID = original;
+});
+
+describe('/.well-known/apple-app-site-association', () => {
+ it('refuses to publish an association when no Team ID is configured', async () => {
+ delete process.env.APPLE_TEAM_ID;
+ const { res, json } = await call();
+ expect(res.statusCode).toBe(503);
+ expect(json.error).toBe('not_configured');
+ expect(JSON.stringify(json)).not.toContain('applinks');
+ });
+
+ it('treats a whitespace-only Team ID as unconfigured', async () => {
+ process.env.APPLE_TEAM_ID = ' ';
+ const { res } = await call();
+ expect(res.statusCode).toBe(503);
+ });
+
+ it('publishes applinks and webcredentials for <team>.<bundle>', async () => {
+ process.env.APPLE_TEAM_ID = 'A1B2C3D4E5';
+ const { res, json } = await call();
+ expect(res.statusCode).toBe(200);
+ const appId = `A1B2C3D4E5.${BUNDLE_ID}`;
+ expect(json.applinks.details).toHaveLength(1);
+ expect(json.applinks.details[0].appIDs).toEqual([appId]);
+ expect(json.webcredentials.apps).toEqual([appId]);
+ });
+
+ it('trims a Team ID pasted with surrounding whitespace', async () => {
+ process.env.APPLE_TEAM_ID = '\n A1B2C3D4E5 \t';
+ const { json } = await call();
+ expect(json.applinks.details[0].appIDs).toEqual([`A1B2C3D4E5.${BUNDLE_ID}`]);
+ });
+
+ it('keeps the API and the third-party embed entries out of the app', async () => {
+ process.env.APPLE_TEAM_ID = 'A1B2C3D4E5';
+ const { json } = await call();
+ const components = json.applinks.details[0].components;
+ const excluded = components.filter((c) => c.exclude).map((c) => c['/']);
+ expect(excluded).toEqual(expect.arrayContaining(['/api/*', '/embed*', '/widget*']));
+ // Order matters to iOS: it takes the first matching component, so the
+ // catch-all has to come last or the exclusions never apply.
+ expect(components.at(-1)).toEqual({ '/': '/*' });
+ });
+
+ it('is served as JSON, which is what Apple requires of this path', async () => {
+ process.env.APPLE_TEAM_ID = 'A1B2C3D4E5';
+ const { res } = await call();
+ expect(String(res.getHeader('content-type'))).toContain('application/json');
+ });
+});
diff --git a/tests/ios-native-bridge.test.js b/tests/ios-native-bridge.test.js
new file mode 100644
index 000000000..388fcc0d6
--- /dev/null
+++ b/tests/ios-native-bridge.test.js
@@ -0,0 +1,82 @@
+/**
+ * The iOS app's web-side bridge (ios/src/native-bridge.js).
+ *
+ * This module ships with the SITE, not the .ipa: Capacitor injects its native
+ * bridge into the remote page, so `window.Capacitor` exists on three.ws only
+ * when the site is being viewed inside the iOS app. Two properties matter more
+ * than the rest and are pinned here.
+ *
+ * First, it must be inert in a browser. It is injected into 671 built pages, so
+ * anything it does unconditionally, it does to every visitor on every surface.
+ *
+ * Second, isInternalUrl decides which links stay in the app's only WebView. Get
+ * it wrong in the permissive direction and a tap on an off-site link navigates
+ * the app away from three.ws with no back button to return; get it wrong in the
+ * strict direction and ordinary in-app navigation bounces out to Safari.
+ */
+
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+
+describe('ios native bridge', () => {
+ let mod;
+
+ beforeEach(async () => {
+ vi.resetModules();
+ vi.stubGlobal('document', {
+ readyState: 'complete',
+ addEventListener: vi.fn(),
+ documentElement: { classList: { add: vi.fn() }, style: { setProperty: vi.fn() } },
+ });
+ vi.stubGlobal('location', { href: 'https://three.ws/create' });
+ mod = await import('../ios/src/native-bridge.js');
+ });
+
+ afterEach(() => {
+ vi.unstubAllGlobals();
+ });
+
+ it('reports a plain browser as not native', () => {
+ expect(mod.isNativeIOS()).toBe(false);
+ });
+
+ it('installs nothing in a browser', () => {
+ expect(mod.bootNativeIOS()).toBe(false);
+ expect(document.documentElement.classList.add).not.toHaveBeenCalled();
+ });
+
+ it('leaves navigator untouched in a browser', async () => {
+ // haptic() must be safe to call anywhere: surfaces invoke it directly.
+ await expect(mod.haptic('heavy')).resolves.toBeUndefined();
+ expect(globalThis.threeWsHaptic).toBeUndefined();
+ });
+
+ describe('isInternalUrl', () => {
+ for (const href of [
+ '/create',
+ '#gallery',
+ '?tab=agents',
+ 'https://three.ws/viewer?src=x',
+ 'https://www.three.ws/agents/1',
+ 'mailto:[email protected]',
+ 'threews://create',
+ ]) {
+ it(`keeps ${href} in the app`, () => {
+ expect(mod.isInternalUrl(href)).toBe(true);
+ });
+ }
+
+ for (const href of [
+ 'https://solscan.io/tx/abc',
+ 'https://x.com/threews',
+ 'http://example.com',
+ // A lookalike host is the case worth being explicit about: substring
+ // matching on "three.ws" would hand the WebView to an attacker.
+ 'https://three.ws.evil.com/phish',
+ 'https://notthree.ws/',
+ ]) {
+ it(`sends ${href} out to Safari`, () => {
+ expect(mod.isInternalUrl(href)).toBe(false);
+ });
+ }
+ });
+});
diff --git a/vercel.json b/vercel.json
index 04b02434a..28f24b48c 100644
--- a/vercel.json
+++ b/vercel.json
@@ -505,6 +505,10 @@
"src": "/\\.well-known/three-vanity\\.json",
"dest": "/api/wk?name=three-vanity"
},
+ {
+ "src": "/\\.well-known/apple-app-site-association",
+ "dest": "/api/wk?name=apple-app-site-association"
+ },
{
"src": "/\\.well-known/jwks\\.json",
"dest": "/api/auth/persona/[action]?action=jwks"
diff --git a/vite.config.js b/vite.config.js
index 6af9620f3..0c5e457f0 100644
--- a/vite.config.js
+++ b/vite.config.js
@@ -39,6 +39,19 @@ function rewriteSeoHead(pathname, html) {
// npm run build:all → both
const TARGET = process.env.TARGET || 'app';
+// Entries that render inside a third-party page. They get neither the service
+// worker (stripped after the build, below) nor the iOS bridge: both install
+// document-level behaviour that belongs to three.ws, not to an embedder.
+const IOS_BRIDGE_EXCLUDED = new Set([
+ 'widget.html',
+ 'embed.html',
+ 'avatar-embed.html',
+ 'agent-embed.html',
+ 'a-embed.html',
+ 'agent-token-page.html',
+ 'assistant-frame.html',
+]);
+
// Prepended to every emitted chunk (app AND lib). `Object.hasOwn` is an ES2022
// *runtime API*, so esbuild's `target` never lowers it. It ships raw and throws
// "Object.hasOwn is not a function" on anything older than Chrome 93 / Safari
@@ -991,6 +1004,71 @@ const appConfig = {
// transformIndexHtml, so this strip has to run *after* the bundle is
// emitted to disk — a closeBundle hook on the dist/ output directory
// is the only ordering that's stable across Vite versions.
+ // Injects the iOS app's web-side bridge into every page of the built
+ // site. The iOS app (ios/) is a Capacitor shell whose WebView loads the
+ // live https://three.ws, so the code that makes it behave like an app
+ // (native share sheet, off-site links to Safari, deep links, launch
+ // screen) has to ship with the SITE rather than with the .ipa. It is a
+ // no-op in every browser, gated on Capacitor.isNativePlatform().
+ //
+ // This runs on dist/ after the bundle is written rather than as a
+ // transformIndexHtml, because the two surfaces the app most needs it on
+ // (/viewer and /ar) are self-contained pages copied verbatim out of
+ // public/ and are never seen by Vite's HTML pipeline. The module has no
+ // imports, so it is copied rather than bundled, under a content-hashed
+ // name so a change to it can never be served stale from the CDN.
+ //
+ // Embed entries are excluded for the same reason they have the service
+ // worker stripped below: they render inside third-party pages, where
+ // installing document-level click capture and a navigator.share
+ // polyfill would be reaching into someone else's document. HTML
+ // fragments (nav, footer) are skipped because they have no <body> to
+ // inject into and are inlined into pages that already carry the tag.
+ {
+ name: 'three-ws-ios-native-bridge',
+ apply: 'build',
+ closeBundle: {
+ sequential: true,
+ order: 'post',
+ async handler() {
+ if (TARGET !== 'app') return;
+ const { readdirSync, statSync, readFileSync, writeFileSync, existsSync } =
+ await import('node:fs');
+ const { createHash } = await import('node:crypto');
+ const { join, resolve: resolvePath } = await import('node:path');
+ const outDir = resolvePath(__dirname, 'dist');
+ const source = resolvePath(__dirname, 'ios/src/native-bridge.js');
+ if (!existsSync(outDir) || !existsSync(source)) return;
+
+ const code = readFileSync(source, 'utf8');
+ const hash = createHash('sha256').update(code).digest('hex').slice(0, 8);
+ const assetName = `ios-bridge.${hash}.js`;
+ writeFileSync(join(outDir, assetName), code);
+
+ const tag = `<script type="module" src="/${assetName}"></script>`;
+ const injected = [];
+ const walk = (dir) => {
+ for (const entry of readdirSync(dir)) {
+ const full = join(dir, entry);
+ if (statSync(full).isDirectory()) {
+ walk(full);
+ continue;
+ }
+ if (!entry.endsWith('.html')) continue;
+ if (IOS_BRIDGE_EXCLUDED.has(entry)) continue;
+ const html = readFileSync(full, 'utf8');
+ // Fragments have no </body>; a page that somehow already
+ // carries the tag is left alone rather than doubled.
+ if (!html.includes('</body>') || html.includes('/ios-bridge.')) continue;
+ writeFileSync(full, html.replace('</body>', `\t\t${tag}\n\t</body>`));
+ injected.push(entry);
+ }
+ };
+ walk(outDir);
+ console.log(`[ios-bridge] ${assetName} injected into ${injected.length} page(s)`);
+ },
+ },
+ },
{
name: 'three-ws-strip-sw-from-embeds',
apply: 'build',