The flow starts with a launchApp step and uses named elements (text, label, id) alongside actions (tap, type, scroll, wait, assert) that operate on the live screen and are re-evaluated every 500 ms.

Building a flow proceeds from launchApp, adding steps with human-readable element names, validating against the live UI, and replaying on both Android and iPhone.

A single file supports both platforms through a shared envelope and platformIs blocks to handle genuine differences, with a validator ensuring accuracy by naming steps, fields, and correcting errors.

Benefits include readable diffs, easier fixes when elements are renamed, and the ability for anyone, including AI agents, to author or edit tests with live validation and versioned updates.

RobotActions markets itself as a platform for running mobile tests on real devices and offers integrations with TestRail, Jira, and Azure DevOps, plus options for AI-assisted authoring and validation.

Selectors are defined as { using: ..., value: ... }, using common bases like text, label, and id, with platform-specific selectors wrapped in platform blocks when needed.

For browser flows, the environment uses platform: 'web' with a similar envelope and actions, and supports environment variables like {{BASE_URL}} for web tests.

A JSON-based mobile test format enables a single file to run on Android and iPhone by focusing on element-based selectors and live screen checks rather than coordinates or recordings.

The validator provides practical guidance, detailing how errors are reported (step, field, message) and how updates preserve test IDs and history, with references to related blog posts and the RobotActions site.

Recording and JSON exports are compatible: a flow recorded on a real device can be exported to JSON and edited, or created manually and then exported, noting that screen-position actions are not represented in JSON.

The article outlines concrete steps for editing tests when app text changes (e.g., Sign in becomes Log in) using an export, edit, and import/update workflow with version history.