OpenParable
Skip to content
← Back to skills

Installing Mobile Preview Builds

Apps & Automation
installing-mobile-preview-builds

Installing Mobile Preview Builds is an Agent Skill for apps & automation published in the RSSNext/Folo repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

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.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/RSSNext/Folo/blob/HEAD/.agents/skills/installing-mobile-preview-builds/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/installing-mobile-preview-builds, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

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

  1. 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
      
  2. 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.
  3. 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
    
  4. 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"
    
  5. 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:

  1. Build mode (local) and final status.
  2. Local IPA path.
  3. Target device identifier.
  4. Install result (installed or failed) and launch result.
  5. Next action for the user if manual action is required.