4.0 KiB
Hanzo Mobile
Expo Router tab starter — iOS, Android and web from one tree.
Live demo — https://mobile.hanzo.app — the same app, rendered by react-native-web from this source. Not a mock-up.
What you get
Three tabs (feed, search, settings), a dynamic item/[id] detail route and
one theme.ts every screen reads from. It is the shape almost every app
starts as, with none of the boilerplate you would delete on day one.
Run it
npm install
npx expo start # press i for the iOS simulator
npx expo export -p web # the static bundle the live demo serves
Building for iOS — read this first
Our runner fleet cannot produce an iOS build today. Two separate gaps, both measured rather than assumed:
- No macOS runner exists. An archive / IPA needs macOS + Xcode + a signing
identity. Every runner registered to
hanzoai(519 of them) reportsos: linux;luxfihas 151, same;zooaihas none. The only macOS builds in the org today (hanzoai/worldbuild-desktop.yml) run on GitHub-hostedmacos-14, which is what the house CI rule exists to avoid. hanzo-templatesis not in the arcd org list.arcdserveshanzoai, luxfi, zooai, parsdao, zenlm. Until this org is added, even the Linux jobs inhanzo.ymlsitqueuedwith no runner to claim them.
A third gap turned up while wiring this and is already fixed: this org
defaulted GITHUB_TOKEN to read, and hanzoai/ci declares
permissions: packages: write. A caller cannot be granted more than the org
maximum, so every run died as startup_failure before a job was even created —
no logs, no annotation, nothing to read. The org now defaults to write, the
same as hanzoai, and runs reach queued. If you fork these into another org
and see startup_failure with an empty log, check
/orgs/<org>/actions/permissions/workflow first.
So hanzo.yml declares only what a Linux arc runner could run, and the
macOS archive sits in a separate workflow_dispatch-only
.github/workflows/ios.yml — a job pinned to a label nothing advertises would
queue forever if it fired on push.
Both gaps close with the installer, no code change:
# (2) serve this org — re-run on any existing arcd host
~/work/hanzo/arc/scripts/install-arcd.sh \
--labels self-hosted,linux,amd64 \
--orgs hanzoai,luxfi,zooai,parsdao,zenlm,hanzo-templates
# (1) add the macOS lane — on an Apple Silicon Mac, once
xcode-select --install && sudo xcodebuild -license accept
~/work/hanzo/arc/scripts/install-arcd.sh \
--labels self-hosted,macos,arm64,xcode \
--orgs hanzoai,luxfi,zooai,parsdao,zenlm,hanzo-templates
Then runs-on: [self-hosted, macos, arm64, xcode] resolves and ios.yml
archives + exports the IPA. Signing material comes from KMS
(kms.hanzo.ai), never from a checked-in .p12.
CI
hanzo.yml + a seven-line .github/workflows/cicd.yml importing
hanzoai/ci. On every push a Linux arc runner runs:
- typecheck —
npm ci && npx tsc --noEmit - web-bundle —
npx expo export -p web
.github/workflows/ios.yml holds the macOS archive job and is
workflow_dispatch only — see above.
Upstream
Derived from expo/expo · templates/expo-template-tabs (MIT). This template is MIT; the upstream licence travels with the code it came from.