iOS native

Set up with an agent

Paste one prompt and your coding agent does the rest.

Copy setup promptPreview prompt

Setup prompt

Copy

Set up Revyl for this native iOS app.

Read https://docs.revyl.com/frameworks/ios.md and follow it. It's the current Revyl guide for this, so prefer it over anything you remember about Revyl.

Build the app's main scheme in the Debug configuration for the simulator (`-sdk iphonesimulator`). Revyl runs the `.app`, not an `.ipa`.

You're done when a Revyl build of the app succeeds and the app runs on a cloud iOS simulator.

Ask me before anything that needs my login or approval.

Build GuidanceCopy Anchor Link

To use the Dev Loop, a build is required on every code change. The binary is the app — see Dev Loop: Hot reload and rebuild configuration for the full breakdown.

To capture sanitizer findings, upload a simulator build compiled with the corresponding sanitizer enabled. See iOS runtime diagnostics for supported diagnostics and how to view findings.

Build via the Revyl CLICopy Anchor Link

PrerequisitesCopy Anchor Link

• Revyl CLI installed and authenticated (revyl auth login)

SetupCopy Anchor Link

Initialize the project using the Revyl CLI:

revyl init

This detects the Xcode build and writes a named profile with its iOS recipe. Review or fill in the app ID, commands, and output path before the first build.

Run BuildCopy Anchor Link

Run a build using: revyl build --profile development --platform ios

This runs the selected recipe in the cloud. If your profile has a different name, pass it explicitly; no profile is active/default. See Configuration.

Advanced ConfigurationCopy Anchor Link

Revyl makes a best effort to determine the build commands to be used. If the build does not complete successfully modify the build commands manually in the config.yaml file.

Build via XCode UICopy Anchor Link

Select SimulatorCopy Anchor Link

In Xcode toolbar:

• Choose your app scheme
• Select any iOS Simulator (e.g., iPhone 15 Pro)

The specific simulator doesn't matter - builds are universal.

BuildCopy Anchor Link

1. Clean: Product → Clean Build Folder (⌘+Shift+K)
2. Build: Product → Build (⌘+B)
3. Wait for success

Locate BuildCopy Anchor Link

Product → Show Build Folder in Finder

Navigate to:

Build/Products/Debug-iphonesimulator/YourAppName.app

Important: Use Debug-iphonesimulator, NOT Debug-iphoneos.

Test Before UploadCopy Anchor Link

1. Open iOS Simulator
2. Drag YourApp.app onto simulator window
3. Launch from home screen
4. Verify it works

Always test locally before uploading.

Upload to RevylCopy Anchor Link

See Ways to Add Builds to upload the build to Revyl.

Auto-Detect Build from DerivedDataCopy Anchor Link

If you build in Xcode normally (Cmd+B), revyl dev automatically finds the most recent simulator .app from DerivedData:

# Build in Xcode as usual (Cmd+B), then:
revyl dev --platform ios

The CLI scans ~/Library/Developer/Xcode/DerivedData/ for the most recently modified .app matching your project. Test runner bundles (*Tests.app) are excluded automatically.

TroubleshootingCopy Anchor Link

Dev loopCopy Anchor Link

Swift/iOSCopy Anchor Link

Native iOS uses a rebuild-based dev loop. The CLI detects .xcodeproj / .xcworkspace and configures xcodebuild. During revyl dev, press [r] to rebuild and reinstall. Typical rebuild cycle: ~20-60s.

If an Expo or React Native project is detected as native iOS, run revyl init --detect from the app directory. If detection still cannot resolve the monorepo layout, edit build.framework and the generated profile recipes in .revyl/config.yaml, then run revyl config validate.