Install Mobile Preview Build (iOS)
Use this skill to create a fresh local preview iOS build and install it on a connected iPhone.
Inputs
- Optional
$ARGUMENTS: device identifier (UDID or exact device name). - If no argument is provided, auto-select the first paired iPhone from
xcrun devicectl list devices.
Workflow
- Validate repo and tooling.
- Run from repo root and ensure apps/mobile exists. - Verify pnpm, xcrun, xcodebuild, and eas-cli are available. - Verify EAS login: cd apps/mobile pnpm dlx eas-cli whoami
- Resolve target device.
- List paired devices: xcrun devicectl list devices - Choose device in this order: - $ARGUMENTS if provided and matches exactly one device. - Otherwise, first paired iPhone.
- Trigger local
previewiOS build.mkdir -p.context/preview-install cd apps/mobile pnpm dlx eas-cli build -p ios --profile preview --non-interactive --local --output=./build-preview.ipa cd../.. cp apps/mobile/build-preview.ipa.context/preview-install/folo-preview.ipa - Install to device locally.
unzip -q -o.context/preview-install/folo-preview.ipa -d.context/preview-install/unpacked APP_PATH=$(find.context/preview-install/unpacked/Payload -maxdepth 1 -name '*.app' -type d | head -n 1) xcrun devicectl device install app --device "<device-id>" "$APP_PATH" - Try launching app.
xcrun devicectl device process launch --device "<device-id>" is.follow --activate
- If launch fails due to locked device, instruct the user to unlock iPhone and open Folo manually.
Failure Handling
- If local build fails, report:
- build mode (local) - failing command - key error message from command output
- If app config fails with
Assets source directory not found... /out/rn-web, prebuild assets then retry once:pnpm --filter @follow/rn-micro-web-app build --outDir out/rn-web/html-renderer
Output Format
Always return:
- Build mode (
local) and final status. - Local IPA path.
- Target device identifier.
- Install result (
installedorfailed) and launch result. - Next action for the user if manual action is required.