Run any Skill in Manus with one click

run-ios-sim

Stars23

Forks69

UpdatedJuly 11, 2026 at 22:13

Build the hushh One webapp, sync it into the native iOS shell, and launch it on the iPhone 16 simulator (UDID B46FD09B-E0BC-400E-821B-5CE3D575ECAB) against the UAT backend. Use when the user asks to run/launch/build the app on the simulator, take a screenshot on device, or verify a change in the real native app. Wraps the mobile build gotchas (UAT backend override, Node 22, 8 GB heap, /tmp DerivedData) into one command.

Installation

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

Run Skill in Manus

Source

hushh-labs

hushh-labs/hushh-research

View GitHub Repository View Creator Repositories

Download

Run Skill in Manus

Related occupationsSOC

Based on SOC occupation classification

Software DevelopersComputer and Mathematical Occupations·SOC 15-1252

File Explorer

2 files

SKILL.md

readonly

name	run-ios-sim
description	Build the hushh One webapp, sync it into the native iOS shell, and launch it on the iPhone 16 simulator (UDID B46FD09B-E0BC-400E-821B-5CE3D575ECAB) against the UAT backend. Use when the user asks to run/launch/build the app on the simulator, take a screenshot on device, or verify a change in the real native app. Wraps the mobile build gotchas (UAT backend override, Node 22, 8 GB heap, /tmp DerivedData) into one command.
argument-hint	[optional: simulator UDID to override the default iPhone 16]
allowed-tools	Bash, Read
paths	[".claude/skills/run-ios-sim/","hushh-webapp/"]

Run hushh One on the iOS simulator

One command that goes from source → running app on the simulator. It bakes in every recurring build gotcha from [[mobile-bug-log]] so you don't rediscover them.

Quick start

.claude/skills/run-ios-sim/launch.sh

Optional: pass a different simulator UDID as $1 (default is the iPhone 16 below). Find UDIDs with xcrun simctl list devices.

Default simulator: iPhone 16 — B46FD09B-E0BC-400E-821B-5CE3D575ECAB
App: com.hushh.app (scheme App, ios/App/App.xcodeproj)
Backend baked in: UAT (https://consent-protocol-f2gsa4kfsq-uc.a.run.app)

What the script does (and why)

nvm use 22 — cap sync needs Node 22 (see [[mobile-bug-log]] GOTCHA #2 / iOS build notes).
Verify UAT backend is reachable (curl → expect 200) before wasting a build.
export NEXT_PUBLIC_BACKEND_URL=<UAT> then NODE_OPTIONS=--max-old-space-size=8192 npm run cap:build — the UAT override is mandatory (GOTCHA #1: without it localhost:8000 gets baked in and the app can't reach the vault → navigation dies on every screen). The 8 GB heap avoids the cap:build OOM. This does NOT touch your .env.local.
npm run cap:sync:ios — copies out/ into the native shell + syncs plugins.
Boot the simulator (xcrun simctl boot, open -a Simulator) and wait until it reports Booted.
xcodebuild the App scheme for iphonesimulator, DerivedData in /tmp/hushh-ios-dd (iCloud FinderInfo on the default DerivedData path breaks codesign).
Install + launch the built App.app and print the app's URL so you can confirm.
Confirm the right backend is live — greps the app log for consent-protocol (good) vs 127.0.0.1:8000 (bad, GOTCHA #1 regressed).

After it launches

Most screens are auth + vault gated — you must log in to reach the dashboard, Onepoint/location, etc. On UAT you can use a QA test phone number with fixed OTP 000000 (see [[mobile-bug-log]] "QA test phone numbers"), then unlock the vault. Autonomous agents cannot pass this gate — a human does the login.

Diagnose runtime issues with the WKWebView + native log:

xcrun simctl spawn B46FD09B-E0BC-400E-821B-5CE3D575ECAB log show --last 120s --predicate 'process == "App"'

Screenshot the current simulator screen:

xcrun simctl io B46FD09B-E0BC-400E-821B-5CE3D575ECAB screenshot /tmp/onepoint-sim.png

Gotchas (don't relearn these)

Sim shows "Shutdown" / install fails → it's not booted. The build likely already succeeded; just xcrun simctl boot <UDID>; open -a Simulator; sleep 6 then re-run install. The script handles this, but if you install manually, boot first.
Capacitor has no OTA — a committed fix that isn't in this build has NOT shipped to a TestFlight tester. This script always rebuilds from current source, so what you see is your working tree.
First next build is slow (a few minutes). Subsequent builds are faster.
Stale CSS after a color/className change → the webpack cache (.next/cache) can serve a Tailwind compilation from before your edit, so new arbitrary classes (e.g. bg-[#007aff]) ship in the JS but have no CSS rule — the element renders with no color (a blue button with a transparent background). Fix: CLEAN=1 .claude/skills/run-ios-sim/launch.sh (forces rm -rf .next out). Verify a class landed: grep -c 'background-color:#007aff' hushh-webapp/out/_next/static/css/*.css.
Full disk corrupts the build — next build on a 100%-full disk produces a broken/partial CSS bundle (same symptom as above) even though it reports success. The script now aborts if < 5 GB is free. .next can grow to ~17 GB; rm -rf hushh-webapp/.next to reclaim it.

More from this repository

same repository

kai-voice-governance

hushh-labs/hushh-research

Use when changing One Voice capability authoring, Kai compatibility runtime contracts, generated action gateway contracts, typed-search and voice parity, persona/workspace gating, or BYOK-safe durable voice memory.

2026-07-1923

pr-governance-review

hushh-labs/hushh-research

Use when reviewing an incoming pull request for north-star alignment, trust-boundary regressions, malicious or low-signal degradation, stale-vs-current CI interpretation, and true merge readiness beyond a green gate. Also owns PR train planning, merge queue cohorts, maintainer patch-then-merge, contributor harvest decisions, and backlog review waves.

2026-07-1923

reviewer-app-testing

hushh-labs/hushh-research

Use when operating reviewer-account browser rehearsals that require BYOK unlock, memory-only decrypted information, and same-session client navigation.

2026-07-1823

frontend-design-system

hushh-labs/hushh-research

Use when changing Hussh UI architecture, shared components, shell chrome, or styling rules inside the frontend owner family.

2026-07-1823

founder-brief-curation

hushh-labs/hushh-research

Use when drafting or polishing founder-facing architecture briefs, presentation-grade markdown/html/pdf artifacts, generic report PDFs, Drive/shareable artifacts, or paper-style technical specs that must stay grounded in repo truth.

2026-07-1723

planning-board

hushh-labs/hushh-research

Use when inspecting, summarizing, creating, triaging, or updating work on the Hussh Engineering Core GitHub board.

2026-07-1723

name	run-ios-sim
description	Build the hushh One webapp, sync it into the native iOS shell, and launch it on the iPhone 16 simulator (UDID B46FD09B-E0BC-400E-821B-5CE3D575ECAB) against the UAT backend. Use when the user asks to run/launch/build the app on the simulator, take a screenshot on device, or verify a change in the real native app. Wraps the mobile build gotchas (UAT backend override, Node 22, 8 GB heap, /tmp DerivedData) into one command.
argument-hint	[optional: simulator UDID to override the default iPhone 16]
allowed-tools	Bash, Read
paths	[".claude/skills/run-ios-sim/","hushh-webapp/"]

Run hushh One on the iOS simulator

One command that goes from source → running app on the simulator. It bakes in every recurring build gotcha from [[mobile-bug-log]] so you don't rediscover them.

Quick start

.claude/skills/run-ios-sim/launch.sh

Optional: pass a different simulator UDID as $1 (default is the iPhone 16 below). Find UDIDs with xcrun simctl list devices.

Default simulator: iPhone 16 — B46FD09B-E0BC-400E-821B-5CE3D575ECAB
App: com.hushh.app (scheme App, ios/App/App.xcodeproj)
Backend baked in: UAT (https://consent-protocol-f2gsa4kfsq-uc.a.run.app)

What the script does (and why)

nvm use 22 — cap sync needs Node 22 (see [[mobile-bug-log]] GOTCHA #2 / iOS build notes).
Verify UAT backend is reachable (curl → expect 200) before wasting a build.
export NEXT_PUBLIC_BACKEND_URL=<UAT> then NODE_OPTIONS=--max-old-space-size=8192 npm run cap:build — the UAT override is mandatory (GOTCHA #1: without it localhost:8000 gets baked in and the app can't reach the vault → navigation dies on every screen). The 8 GB heap avoids the cap:build OOM. This does NOT touch your .env.local.
npm run cap:sync:ios — copies out/ into the native shell + syncs plugins.
Boot the simulator (xcrun simctl boot, open -a Simulator) and wait until it reports Booted.
xcodebuild the App scheme for iphonesimulator, DerivedData in /tmp/hushh-ios-dd (iCloud FinderInfo on the default DerivedData path breaks codesign).
Install + launch the built App.app and print the app's URL so you can confirm.
Confirm the right backend is live — greps the app log for consent-protocol (good) vs 127.0.0.1:8000 (bad, GOTCHA #1 regressed).

After it launches

Diagnose runtime issues with the WKWebView + native log:

xcrun simctl spawn B46FD09B-E0BC-400E-821B-5CE3D575ECAB log show --last 120s --predicate 'process == "App"'

Screenshot the current simulator screen:

xcrun simctl io B46FD09B-E0BC-400E-821B-5CE3D575ECAB screenshot /tmp/onepoint-sim.png

Gotchas (don't relearn these)

Sim shows "Shutdown" / install fails → it's not booted. The build likely already succeeded; just xcrun simctl boot <UDID>; open -a Simulator; sleep 6 then re-run install. The script handles this, but if you install manually, boot first.
Capacitor has no OTA — a committed fix that isn't in this build has NOT shipped to a TestFlight tester. This script always rebuilds from current source, so what you see is your working tree.
First next build is slow (a few minutes). Subsequent builds are faster.
Stale CSS after a color/className change → the webpack cache (.next/cache) can serve a Tailwind compilation from before your edit, so new arbitrary classes (e.g. bg-[#007aff]) ship in the JS but have no CSS rule — the element renders with no color (a blue button with a transparent background). Fix: CLEAN=1 .claude/skills/run-ios-sim/launch.sh (forces rm -rf .next out). Verify a class landed: grep -c 'background-color:#007aff' hushh-webapp/out/_next/static/css/*.css.
Full disk corrupts the build — next build on a 100%-full disk produces a broken/partial CSS bundle (same symptom as above) even though it reports success. The script now aborts if < 5 GB is free. .next can grow to ~17 GB; rm -rf hushh-webapp/.next to reclaim it.