Skip to main content
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.
This guide is for the mobile CLI (momentic-mobile). The web CLI (momentic) has its own v3 upgrade guide. If your repo has both, upgrade each separately.

​
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: 
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: 
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: 
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 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.