Seed mobile on Exact
Overnight port of the Seed mobile app to Expo's Exact framework, redesigned as a native iOS app. What was built, what is verified, what is missing, and what Exact needs upstream.

Seed mobile on Exact

Overnight 2026-11-09 → 11-10, a swarm of Claude Code (cc) and Codex (cx) agents on Clipper ported the Seed React Native app to Exact and redesigned it as a native iOS app. Eric asked for it at 23:00. This is the morning report.

Where it is

    Branch: feat/mobile-exact in clipper:~/Code/Seed-worktrees/mobile-exact (local only, not pushed), head 2d540182f (tag mobile-exact-final). Green checkpoints are tagged mobile-exact-green-*. The app is frontend/apps/mobile-exact/; the RN app frontend/apps/mobile/ is untouched (it stays the Android build).

    Exact pinned at expo/exact@94b8671f (clipper:~/Code/exact, referenced by path).

    Try it: iOS: installed and running on the Clipper simulator "Mobile Exact Lead iPhone" (806F6A36…). Clipper's Xcode has no Simulator.app, so it runs headless; cd frontend/apps/mobile-exact && bun exact.mjs agent ios "screenshot x.png" shows it, or bun exact.mjs share for an AppDrop link to a phone. Web: production build served from Clipper by the Probe session "Seed mobile-exact · web (8740)" at http://127.0.0.1:8740/ (LAN: http://192.168.1.149:8740/).

    Tests: final run on 2d540182f: 62/62 contract tests pass on web and 62/62 on the iOS simulator (9 files: app 3, activity 7, agents 15, crypto 1, discuss 6, me 13, profile 2, read 12, vault 3), 219 unit tests (bun test src, including the crypto golden vectors), and the scripted remote-vault flow (connect, conflicts, wrong keys, lock, logout) on web and iOS. Hosted notify was blocked for the whole run; writes went only to dev.hyper.media and local mocks, with throwaway keys.

Parity with the RN app

QA walked every RN feature against the new app on iOS and web (full table: clipper:~/.local/state/seed-mobile-exact/PARITY.md).

Status

Features

Ported and verified (passing test or screenshot)

61 at QA time (02:40), plus 4 closed after QA with tests: Share/Copy account ID, query card grid/banner, face piles, row authors and comment counts

Ported, not verified by a test or screenshot

14 (code present, no test or screenshot), e.g. pull to refresh, share sheet, empty-page and embed-unavailable states

Changed by design (tabs instead of the sidebar, relative dates, single import field, …)

12

Missing

4

Since QA, the remote vault flow (QA: unverified) also passes its scripted drive on web and iOS, and the QA bugs were fixed (one was serious: the Activity tab re-signed and re-sent a notify request on every frame; now one per minute, with a test that counts requests).

Ported beyond RN: rich text in documents (bold, italic, strike, code, links; RN showed plain text), images, tables, in-app hm:// links and deep links, a directory sheet with search, author pages, a nav-bar discussion button, saved servers, profile editing and publishing, reply-to-a-reply (RN attached every reply to the thread root), tappable child documents, agent run trees, tool attachments, source chips and reconnect recovery.

Missing: profile icon upload (Exact has no image picker), migration of RN app data (different sandbox), the vault-synced notify-server override, and universal links (https://hyper.media/… opening the app needs an apple-app-site-association on hyper.media). hm:// links and in-app links work. Password-protected .seedkey import is refused, as in RN.

What it looks like

Read: hyper.media home, light
Read: home, dark
Query block as a card grid with banner and author faces
Discussion thread with reply-to-a-reply
Agents: live session, tool row and run card, composer above the keyboard
Agents: tool call input/output, dark
Activity: signed notification inbox grouped by day
Me: identities, server, vault, agent server
Vault, dark
Directory sheet with search, dark

Architecture

    UI in Contract, one file per area: read, discuss, agents, activity, me, vault, profile, plus shared ui.contract and the brand in app.tamber (Seed teal, light/dark). Exact draws UIKit on iOS: system tab bar, large titles, inset-grouped lists, sheets, swipe actions, Dynamic Type.

    Root app.contract holds the four tab stacks (Read, Activity, Agents, Me) and every resource and mutation (Exact allows them only at the root); packages edit only their marked blocks.

    Logic in TypeScript under src/<pkg>/, merged in app.ts. Exact's data module can import pure-JS npm packages but refuses ambient clocks and Node APIs anywhere in the import graph, so @seed-hypermedia/client is vendored, not imported, and time is always an argument.

    Crypto (src/crypto): BIP39 + SLIP-10 + Ed25519, seed-key files, vault XChaCha20-Poly1305/HKDF/gzip-CBOR envelopes, signed comment/change/ref/profile blobs, agents and notify envelopes, one vendored CBOR codec. Byte-for-byte against golden vectors generated by running the RN app's own code, plus the Go mnemonic vector, inside web and iOS (Hermes).

    Keys stay on the device in the Keychain (seed-keys, seed-vault-kek).

    Tests: *.test.contract per area, run on web and the iOS simulator by Exact's driver, against live hyper.media for reads, dev.hyper.media for writes (throwaway keys), and a combined local test server (tools/test-server) that hosts the agents, notify and vault mocks. bun test src holds unit tests and vectors.

How the night went

17 agent runs (9 cc, 8 cx), at most 5 at a time, each in its own git worktree, branch and simulator, merged by the lead after the full suite passed on web and iOS:

When

Package

Agent

Result

23:00–23:19

lead

cc

Exact setup, RN inventory (13 screens), spike (live doc + Ed25519 in the data module), tab shell, plan, design

23:19–23:50

crypto

cx

BIP39/SLIP-10/Ed25519, vault crypto, signed blobs; 47 unit tests on golden vectors from the RN code

23:19–23:52

read

cc

Site home, documents, rich text, embeds, queries, directory, author pages

23:19–23:50

me

cc

Identities: create, import (phrase or key file), switch, remove, export; server choice

23:19–00:12

agents

cx

Agents tab: signed protocol v3, WebSocket live sessions, run cards, tools, providers

23:55–00:10

discuss

cc

Discussions, threads, compose; signed comments (tested on dev.hyper.media)

23:55–00:38

activity

cx

Signed notification inbox, email verification flow

23:55–00:40

vault

cx

Encrypted vault, Remote Vault Connect, sync

00:19–00:41

review-cx / review-cc

cx / cc

Cross-reviews of each other's code: 32 fixes, each with a failing test first

00:19–01:12

polish

cc

Design pass: Seed teal, reader typography, discussion button, app icon

00:44–01:08

profile

cx

Profile editing and publishing

00:50–01:19

fixint

cx

Integration: test server CORS; activity tests fail closed against production notify

01:22–02:13

gaps

cc

hm:// deep links, saved servers, overlapping marks, relative dates

01:22–03:30

agents2

cx

Agents parity: nested runs, tool spawns, source chips, RetrySession, reconnect, timers

02:15–03:00

qa

cc

Read-only parity walk of every screen; 93 screenshots; 10 bugs, 11 design nits

03:06–05:10

fixes

cc

QA bugs, incl. activity re-signing a notify request every frame

03:32–04:49

agents3

cx

Chat composer/transcript layout; verify's agents findings 6 → 0

05:12–06:00

cards

cc

Query card grid and banner, face piles, comment counts

Two cross-reviews found and fixed real bugs before you saw them: a medium-severity agents issue (writes were signed with a server-supplied clock, letting a hostile server extend their replay window), five high-severity issues in identity, discussion and reading code (a corrupt key bundle could be silently overwritten; export could return the wrong identity's key; "create" accepted JSON as a phrase; a reply could carry another document's parent; javascript: links passed through), and an exported key could show on another identity's screen (fixed with a regression test).

Exact: gaps and bugs worth sending upstream

Collected from every worker's notes (each also recorded with exact.mjs feedback note, kept local):

    The data-module analyzer rejects whole packages for an unreachable branch. Date.now() in @seed-hypermedia/client, globalThis.Buffer/process probes in cborg and Function in zod 4 are refused even when never executed. Forced vendoring a CBOR codec and dropping zod.

    The 100 ms Hermes turn budget is invisible on web. A source can pass every web test and be refused on iOS (BIP39 PBKDF2 took ~215 ms). A web-side warning near the budget would catch it early.

    Web server render lacks the reserved exactTime source (host/web-js/build.mjs main-server.js): any app with a TS source and exactTime() fails the web build; worked around with a build-only fallback.

    Markdown links can't be coloured (text markup="markdown" ignores color, tamber tokens and AccentColor).

    iOS bar items: a link in a header is silently not a bar item; a bar button with image + text drops the text.

    Editing a source during test ios builds ends with "ios build is stale" and exit 0 with no results: easy to misread as a pass.

    One test server per app on a fixed port serializes parallel worktrees; a --port for the app's server would help.

    Smaller: no last()/.reverse(); expect state x == ["a"] refused; refresh(x) error doesn't suggest refresh x; app:/vault/… compiles but fails at run time (only app:/data/…); universal links (associatedDomains) undocumented; no image picker (contract vocab photo empty); go() across tabs doesn't select the target tab; a virtualized list takes one for; web stream sources must call fetch(…, {exactStream}) synchronously; the scaffold's setup didn't add the iOS Rust targets when a mise rustc shim shadowed rustup.

Next steps

    Decide on pushing feat/mobile-exact (local only; ~93 commits, all inside frontend/apps/mobile-exact/ plus one pnpm-workspace.yaml exclusion).

    Try it on a phone: cd frontend/apps/mobile-exact && bun exact.mjs share (AppDrop link).

    Universal links: add applinks:hyper.media and serve an apple-app-site-association from hyper.media (production change).

    Missing: profile icon upload (needs an Exact image picker), RN data migration, vault-synced notify override.

    Largest text sizes: Exact's verify still reports problems (web 18 after the fixes pass; iOS 73 after agents3), mostly at the largest Dynamic Type size (web tab labels, root overflow).

    Send the Exact gaps above upstream (feedback notes are local; bun exact.mjs feedback status).

    Android stays on the RN app until Exact's Android matures.

Do you like what you are reading? Subscribe to receive updates.

Unsubscribe anytime

People