> ## 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](/docs/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. 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.

## 4. 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](/docs/get-started/migrate-to-simplified-format)
* [`momentic-mobile upgrade`](/docs/cli-reference/momentic-mobile/commands/upgrade)
* [`momentic-mobile run`](/docs/cli-reference/momentic-mobile/commands/run)