Skip to main content
Run a test against your iOS simulator build and save it in your repository.

Setup with coding agent

Paste this prompt into your coding agent from your project directory. It checks setup, runs the wizard when needed, and asks for your app build.
Setup prompt

Prerequisites

Use Node.js 22.12 or later in the 22.x line, or 24 or later, a Momentic account, and a project with a package.json. Run npm init -y if needed; commit it with the lockfile. Remote simulators work from any supported host. Local simulators need macOS, Xcode, Command Line Tools, and idb. See iOS app setup. The wizard’s remote sample needs no local Xcode or app build.
1

Install with the wizard

Run from your project root and complete browser sign-in:
Select iOS. The wizard installs momentic-mobile, writes momentic.config.yaml and a sample under ios/, runs it on a remote simulator, and offers coding agent setup. A passing sample verifies installation, not your app.Already configured? Skip the wizard. See the CLI reference for manual setup.
2

Upload your app

Build a simulator .app, not a device .ipa, with the iOS build instructions. Upload it to a channel and an unused tag:
For a local device instead, configure your simulator.Keep the channel and tag for the next step: they identify the build your test installs. For later builds, choose a new tag. See asset uploads for versioning and upload options.
3

Write and run a test

Open the local editor:
Create a test using channel dev and tag 1.0.0. Add an action such as tapping Sign in, then assert that the sign-in form is visible. Choose an outcome that matches your app. Save the .test.yaml file and run it from the editor, then from the CLI:
4

Review the result

Open the printed dashboard link and check the assertion screenshot. Confirm the run passed and the device shows the expected state. If it fails, inspect the selected build, sign-in state, and assertion, then edit and rerun.Keep the YAML file in version control with your app. The local editor writes the test; the cloud dashboard shows uploaded run results. You don’t need a browser-based mobile editor to run the saved file again from your terminal or CI.
Passed iOS run checking the Momentic Files demo app's empty landing screen

A passing iOS assertion with its simulator screenshot

Choose remote iOS versions or a local runtime in your simulator settings.

Next