> ## Documentation Index
> Fetch the complete documentation index at: https://momentic.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Local app

> Author, run, and debug web and mobile tests in Momentic's local visual editor.

Launch a visual editor from your Momentic project to build and debug tests
against a live browser or mobile device. The local app runs on Windows, macOS,
and Ubuntu and keeps your test files in your repository.

<Frame caption="Author and run steps with a live interactive browser">
  <img src="https://mintcdn.com/momentic-docs/I8jCFZCGZvEYt8le/images/local-app/local-app-overview.jpg?fit=max&auto=format&n=I8jCFZCGZvEYt8le&q=85&s=6eca0ff8bf70012054f0ab2c5fc67001" alt="Momentic local app showing a test step list, AI action details, a live browser, and browser context tabs" className="w-full" width="2663" height="1192" data-path="images/local-app/local-app-overview.jpg" />
</Frame>

## Launch the local app

Momentic distributes separate npm packages for browser and mobile testing. You
can launch either editor with `npx`, without installing the package globally.

| Target          | npm package       | Command                   |
| --------------- | ----------------- | ------------------------- |
| Browser         | `momentic`        | `npx momentic app`        |
| iOS and Android | `momentic-mobile` | `npx momentic-mobile app` |

Run the command from the directory that contains your `momentic.config.yaml`.
The `app` command starts the local server and opens the GUI in your default
browser. Use `--config` to load a config file from another location.

The editor is cross-platform and supports Windows, macOS, and Ubuntu. Local iOS
Simulator sessions still require macOS and Xcode, but you can use Momentic's
remote iOS simulators from any supported platform.

## Edit tests interactively

Create tests and modules or open existing ones, then edit their settings and
steps in the visual editor. Add, remove, duplicate, and reorder steps with drag
and drop. Undo and redo changes while you shape the flow, then save the test as
a readable YAML file in your project.

You can run the full test or selected steps from the editor as you author. This
keeps the live browser or device next to the test structure so you can confirm
each interaction in context.

<Frame caption="Reorder steps with drag and drop, then undo or redo changes from the toolbar">
  <img src="https://mintcdn.com/momentic-docs/I8jCFZCGZvEYt8le/images/local-app/editor-drag-and-drop.jpg?fit=max&auto=format&n=I8jCFZCGZvEYt8le&q=85&s=1940f3e10e4a1b5fbf333791009a916c" alt="Momentic editor while dragging a While loop between AI actions, with undo and redo controls in the toolbar" className="w-full" width="1114" height="591" data-path="images/local-app/editor-drag-and-drop.jpg" />
</Frame>

## Debug browser and mobile runs

For browser runs, inspect screenshots, the current URL, console output, and
network requests alongside the selected step. For mobile runs, inspect device
screenshots and captured Android logcat or iOS syslog output when logging is
enabled.

The same run view lets you move between steps and compare the page or device
state before and after an action.

<Frame caption="Inspect browser requests and response details without leaving the editor">
  <img src="https://mintcdn.com/momentic-docs/I8jCFZCGZvEYt8le/images/local-app/network-debugging.jpg?fit=max&auto=format&n=I8jCFZCGZvEYt8le&q=85&s=2401703e42207f511c393ede044a0d88" alt="Momentic Network panel showing request filtering, a request waterfall, headers, response details, and timing tabs" className="w-full" width="2109" height="829" data-path="images/local-app/network-debugging.jpg" />
</Frame>

## Manage test settings

Manage test-level settings without editing YAML by hand. For browser tests,
configure options such as the environment, viewport, retries, and browser
behavior. For mobile tests, select app versions and devices, configure retries,
and control device log capture.

The editor writes these settings back to the test file so they remain versioned
with the rest of your test suite.

## Next steps

* Follow the [web quickstart](/docs/quickstart/web) to set up a browser project.
* Follow the [iOS quickstart](/docs/quickstart/ios) or
  [Android quickstart](/docs/quickstart/android) to set up a mobile project.
* See the [`momentic app` command](/docs/cli-reference/momentic/commands/app) and
  [`momentic-mobile app` command](/docs/cli-reference/momentic-mobile/commands/app)
  for every launch option.