Overview

We are releasing Automated Browser Testing, a feature which allows Tusk to automatically verify that its changes work and provide a video of the test in its PR to make reviews smoother.

To get the most out of Automated Browser Testing, we strongly recommend recording a Jam video showing how to get to the location of the UI change or how to replicate a bug.

Tusk uses the video’s visual and audio, along with the console logs, as input to help it browse through your web app and test the change that was made.

Before You Begin

You need to make sure that you have:

  • Tusk account with a repo for a web app synced
  • Jam account with their browser extension installed
    • Jam has a free plan with unlimited recordings (up to 2 seats). Currently supports Chrome, Edge, Arc, Brave, and Opera.
  • Jam recordings set to be public links
  • Preview environment for each pull request

Reach out to support@usetusk.ai to confirm that your preview environment configs are set up before trying out Automated Browser Testing.

Recording the Video

Here are best practices on how to record the video in a way that allows Tusk to test its changes to the best of its ability.

  1. Click on the Jam extension on your browser toolbar
  2. Make sure to turn on your mic
  3. Click Record tab or Record desktop depending on the screens you want to share Jam chrome extension window
  4. Start the recording from the home page of your web app
  5. While narrating, navigate to the page in the app where the change has to be made
  6. On this page, talk about what the current state and expected state is. If it is a bug, go through the steps to replicate the bug while narrating. Keep the video under 1 minute.
  7. Stop the recording once done
  8. Give the Jam recording a written description
  9. Create an issue directly in your ticketing app or create a shareable link

If you created an external issue (e.g., Linear, Jira) from the Jam recording, you can simply assign the issue to Tusk by adding the “Tusk” label in your ticketing app.

Otherwise, you would need to create the issue in your ticketing app separately and paste the shareable Jam link into the issue description.

Video Example

Here’s an example of a Jam video that we recorded showing a minor UI bug in our app: