// Builds and installs the iOS preview build for apps/mobile using EAS local build and devicectl. Use when the user asks to install a preview/internal iOS build on a connected iPhone for production-like testing.
Perform a regular desktop release from the dev branch. Gather changes since the last desktop tag, update the changelog, choose the desktop release mode in release-plan.json, bump the version, and prepare the release PR.
Use when preparing a mobile release from the dev branch and deciding whether changes should ship through the app stores or through the OTA pipeline before creating the release PR to mobile-main.
Self-test a mobile feature change or bug fix after implementation in `apps/mobile`. Use this whenever the user asks to verify a mobile change, run simulator acceptance, smoke-test a mobile PR, or provide screenshot proof for a mobile fix. This skill decides between prod vs local API mode, starts the local follow-server when needed, builds a release app, uses Maestro only to bootstrap registration for non-auth work, then switches to screenshot-driven visual validation and returns screenshot evidence.
Run apps/mobile Maestro end-to-end tests in this repo. Use when an agent needs to validate mobile auth flows on iOS Simulator or Android Emulator. Current maintained coverage is register, sign out, and sign in.
Update all dependencies across frontend and backend projects. Reads changelogs for breaking changes, checks affected code, runs tests, and provides a summary. Use when updating npm dependencies across the monorepo.
| name | installing-mobile-preview-builds |
| description | Builds and installs the iOS preview build for apps/mobile using EAS local build and devicectl. Use when the user asks to install a preview/internal iOS build on a connected iPhone for production-like testing. |
| disable-model-invocation | true |
| allowed-tools | Bash, Read, Glob, Grep |
| argument-hint | [device-udid-or-name(optional)] |
Use this skill to create a fresh local preview iOS build and install it on a connected iPhone.
$ARGUMENTS: device identifier (UDID or exact device name).xcrun devicectl list devices.Validate repo and tooling.
apps/mobile exists.pnpm, xcrun, xcodebuild, and eas-cli are available.cd apps/mobile
pnpm dlx eas-cli whoami
Resolve target device.
xcrun devicectl list devices
$ARGUMENTS if provided and matches exactly one device.Trigger local preview iOS 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
Folo manually.local)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
Always return:
local) and final status.installed or failed) and launch result.