Quickstart - Revyl Documentation

1. Create an App

Head to Apps and click Create app. Give it a name, pick iOS or Android, and upload your first build.

Or connect Expo to auto-sync every EAS build. See Apps for more, or the framework guides for platform-specific build instructions.

What do you want to do next?

Great for QA engineers and anyone writing regression tests.

Create a test

Go to Tests, click Create test, give it a name, and pick the app you just uploaded.

Add steps

In the test editor, add natural-language steps:

Run it

Click Run Steps. The device boots and the AI agent executes each step against your app.

Read the report

Every run produces a report: pass/fail, video replay, step-by-step results, device logs, network traces, and an AI-generated summary.

Next: learn about step types, modules, and workflows to group tests together.

Great for automation engineers and anyone who wants tests in their pipeline.

Install the CLI

curl -fsSL https://revyl.com/install.sh | sh

Or use brew, pipx, uv, or pip. See CLI install.

Authenticate and init

revyl auth login
revyl init

Creates a .revyl/ directory with your project config and test YAMLs.

Sync and run

revyl tests sync        # pull tests from Revyl to your repo
revyl tests run my-test # run a test from the terminal

Commit the YAML to git. CI can now run revyl tests run on every PR.

Dev loop

For iteration, revyl dev gives you hot reload against a live device. Edit the YAML, save, and it re-runs. See the Dev Loop guide.

Next: see CI/CD integration and the full command reference.

Great for developers who want their coding agent to handle the testing.

Install the CLI

curl -fsSL https://revyl.com/install.sh | sh

Authenticate

revyl auth login

Point your agent at it

Open your project in Cursor, Claude Code, Codex, or any coding agent. Prompt it with something like:

Revyl is installed. My app is uploaded as "MyApp". Write a test
that covers the login flow, run it, and iterate until it passes.

The agent uses the CLI to start sessions, explore your app, write tests, run them, and debug failures.

What agents can do with Revyl:

Next: see the CLI overview for everything agents can do.

The mental model for Revyl

Install and use from the terminal