Skip to main content
Tests can be created with the Revyl visual editor. The visual editor is where you build, run, and debug tests against a live device. The editor has four areas:
  • Device Screen (left): live view of the simulator/emulator
  • Editor Panel (center): your test steps with tabs for Editor, YAML, and Variables
  • Device Logs (right): real-time system and app logs
  • Test Controls (top): device info, settings, and the Run Steps button

​
Create a new Test

From the Tests page, click Create test in the top right. Fill in the creation modal:
  • Test Name: a descriptive name for your test
  • Platform: iOS or Android
  • App: select an existing app, or create one inline
  • Tags: optional labels for filtering (e.g., smoke, regression)
  • Advanced Settings: AI config and YAML import (optional)
After clicking Create test, you land in the test editor. Once you’re in the editor, you can add steps and run the test against the app’s active build.

​
Adding Steps

Click a step type button at the bottom of the editor panel to add new steps. Each step type defines a different action or check your test performs. Step types: Instruction, Validation, Extraction, Script, Manual, Loop, Decision, Module. See Step Type Reference for what each type does.

​
Variables

Use variables to avoid hardcoding values like test accounts, URLs, or search terms directly into your steps — define them once and update them in a single place instead of editing every step that uses them. Switch to the Variables tab to create key-value pairs, then reference them in steps with {{var_name}}. For org-wide variables, see Global Variables.

​
Running your test

To run your test, start the device by clicking on the device screen or clicking the Start button. You can then click the Run Steps button to run all of the steps sequentially, or click the play button by each step to run each step individually. The device logs will show what is happening live as each step is running.

​
Device

The device auto-connects when you open the editor. Boot times are typically 1–5 seconds on both iOS and Android (longer if you pick a non-default device target). Use Stop device / Start device to reset. For more on how sessions work, see Sessions.

​
Step Actions

Hover over any step to reveal quick actions: run it individually (useful for iterating on a single action without re-running the whole test), duplicate, delete, or drag to reorder. Test Editor Step Actions

​
Multi-Select

Click and drag across several steps to select them as a group. Selected steps highlight, and a popup toolbar lets you delete, duplicate, or drag the whole group at once — plus:
  • Save as module: turn the selection into a reusable module. Revyl replaces the selected steps with a single Module step pointing at your new library entry.

​
YAML

All tests are saved as YAML files which makes it easy to save to repos, export into CI/CD pipelines, and edit via agents. The YAML tab shows the current YAML representation of your test. See YAML Test Format for more information.