> ## 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.

# Upgrading to momentic-mobile v1

> What changed in momentic-mobile 1.0 and how to move your mobile project from a 0.x release.

momentic-mobile 1.0 drops Node.js 20 and changes how test videos are recorded.
This guide covers the breaking changes and how to upgrade.

<Info>
  This guide is for the mobile CLI (`momentic-mobile`). The web CLI (`momentic`)
  has its own [v3 upgrade guide](/get-started/upgrade-to-v3). If your repo has
  both, upgrade each separately.
</Info>

## 1. Use Node.js 22

momentic-mobile 1.0 requires **Node.js 22 or newer** - Node.js 20 has reached
end of life and is no longer supported. Check your version and upgrade if
needed:

```bash theme={null}
node --version   # must be v22 or newer
```

Update the Node version in your CI images and any `.nvmrc` / `engines` field
before upgrading.

## 2. Run the upgrade

From your mobile project root:

```bash theme={null}
npx momentic-mobile@latest upgrade
```

This installs the latest CLI and applies the current recommended project
defaults. Pass `--dry-run` first to preview what would change without writing
anything.

## 3. Reinstall your browsers

momentic-mobile 1.0 bundles **Playwright 1.60.0**, which pins newer browser
builds than earlier releases. `momentic-mobile upgrade` does not download these
for you, and your existing browser binaries were installed for the old
Playwright version, so reinstall them after upgrading to avoid webview launch
errors:

```bash theme={null}
npx momentic-mobile install-browsers chromium
```

`chromium` is required to automate Android webviews. Pass `--all` to install
every supported browser. See
[`momentic-mobile install-browsers`](/cli-reference/momentic-mobile/commands/install-browsers)
for details.

## 4. Breaking changes

* **`--record-video` flag removed.** Use `--video` instead (`--video true` to
  keep every recording, `--video false` to disable). Recording now defaults to
  `on-fail`: a video is captured for every run but kept only when the test
  fails.

## 5. Other changes

These do not require action but are worth knowing:

* AI Action steps default to the V3 agent. Existing steps continue to run
  unchanged.
* New projects pin each AI agent to the latest exact sub-version so defaults
  stay fixed when a newer revision ships.

## Related

* [Simplified format](/get-started/migrate-to-simplified-format)
* [`momentic-mobile upgrade`](/cli-reference/momentic-mobile/commands/upgrade)
* [`momentic-mobile run`](/cli-reference/momentic-mobile/commands/run)