Docs/Getting Started

Cloud Quickstart

Spin up an Assrt Cloud workspace and run your first test in the browser.

Assrt Cloud runs your tests on managed browsers so you can author, schedule, and review runs entirely from the web. This guide sets up a workspace and runs a first test without installing anything locally.

1. Create a workspace

  1. Sign in at app.assrt.ai.
  2. Create a new workspace and name it after your project.
  3. Invite teammates by email, or come back to this later.

2. Connect a target

A target is the URL (or set of URLs) Assrt will test against. For a public staging environment, just paste the URL. For a private environment, set environment variables or upload auth state.

Protected environments
Most teams point Cloud at a staging deploy. If staging is behind basic auth, add the credentials as workspace secrets and reference them from the Login step.

3. Author a test in the editor

Open the test editor and describe what you want to verify. Assrt proposes a sequence of steps you can accept, edit, or replace.

text
Open the home page.
Click "Sign up".
Fill in a new email and password.
Verify the welcome screen appears.

4. Run and review

Hit Run. Cloud streams the browser in real time and records every step with a screenshot, DOM snapshot, and network trace. Failed steps can be replayed in isolation.

5. Schedule or trigger from CI

  1. Schedule: set a cron on the test or suite to run it on a cadence.
  2. On push: connect a GitHub repo and trigger runs on every commit.
  3. From CLI/CI: use assrt run --cloud to kick off runs and stream results back to your pipeline.