Skip to Content
DocsQuick Start

Quick start

This guide walks through the first WrightTest workflow:

  1. create a project;
  2. add an environment;
  3. create a browser check;
  4. run the check;
  5. inspect screenshots and trace data.

Before starting, make sure WrightTest is installed and running. If not, follow Installation first.

1. Create a project

Open WrightTest and go to Projects.

Click New Project.

Use a clear project name, for example:

Playwright Website

A project groups browser checks, environments, schedules, alerts, and run history.

After creating the project, open it.

2. Create an environment

Inside the project, open the Environments tab.

Click New Environment.

Create an environment named:

DEV

Add a variable:

BASE_URL=https://playwright.dev

Save the environment.

You can use environment variables in check URLs and steps with double curly braces:

{{BASE_URL}}

3. Create a browser check

Open the Checks tab.

Click New Check.

Use the following values:

  • Check name: Playwright homepage check
  • Environment: DEV
  • Start URL: {{BASE_URL}}
  • Device: Desktop Chrome

A browser check is a browser flow made of actions and assertions.

4. Add basic steps

Add a simple flow that opens the Playwright website and verifies that the page loaded.

Example steps:

  1. Navigate to URL
    • Target: {{BASE_URL}}
  2. Assert title
    • Expected: Playwright

If you want to use the recorder, click Start recording and interact with the browser. WrightTest will capture browser actions and add them as steps, but complex flows may still need manual adjustments.

5. Save the check

Click Save changes.

If any step is incomplete, WrightTest will show validation errors. Fix the highlighted step and save again.

6. Run the check

Click Run check.

WrightTest will start a browser run and execute the steps.

After the run finishes, open the run result.

7. Inspect the run result

The Run Result page shows:

  • run status
  • duration
  • step results
  • screenshots
  • failure summary if the run failed
  • Playwright trace when available

For a successful run, you should see a Passed status.

For a failed run, check:

  • the failed step
  • expected and received values
  • screenshot for the failed step
  • raw error details
  • trace viewer

8. Optional: create a schedule

If the check works correctly, you can run it automatically.

Open the Schedules tab and click New Schedule.

Choose:

  • Target: Playwright homepage check
  • Environment: DEV
  • Cron preset: Every day 2am
  • Status: Active

WrightTest will show the generated cron expression and timezone before saving.

9. Optional: add alerts

Open the Alerts tab.

Add a Telegram or Slack alert channel.

Recommended notification rules:

  • Failed runs: enabled
  • Recovered runs: enabled
  • Passed runs: disabled

This keeps alerts useful without sending a message for every successful run.

What to try next

After completing the first check, you can explore:

InstallationConfiguration