BlinqIO Documentation

Automate Your First Test with AI Recorder ​

This guide shows you how to add new tests, automate them using AI Recorder, run the tests, and view reports. By the end, you'll have a working test scenario and a clear understanding of BlinqIO's AI-powered test automation workflow.

Verify your project and environment ​

Your current project and the selected environment are listed at the top. You can verify or change these settings before you move to the next steps.

CleanShot_2025_12_08_18_25_32

Add a new feature and scenario ​

BlinqIO AI Test Engineer organizes tests into features and scenarios. A feature is a collection of one or more related test scenarios, like Shopping Cart, Login, Checkout, or Profile. A test scenario is an individual test case that consists of your automated steps.

NOTE

Test scenarios count toward your license.

To add a new feature, select the + button next to Features. This adds a new feature to your project along with a scenario called Scenario 1.

CleanShot_2025_12_08_18_10_15

You can rename this feature and scenario if you'd like, or proceed to the next step.

CleanShot_2025_12_08_18_13_42

Launch the AI Recorder (web) ​

Make sure the newly added scenario is selected, and then select the AI button to launch the web-based AI Recorder.

CleanShot_2025_12_08_18_20_13

Record test steps ​

You can now perform your test steps in the browser. The AI Recorder automatically converts them into a readable scenario and generates Playwright test code in the background.

For your first test, we recommend recording a simple test with 5-8 steps.

TIP

Wait for each page or UI state to load before the next action. Use clear, repeatable actions and avoid random selections.

Here's a sample flow if you're using our demo application:

Log in with the demo credentials. (expand to view GIF)

CleanShot_2025_12_08_18_31_34

Add a few items to the cart. (expand to view GIF)

CleanShot_2025_12_08_18_33_14

Open the cart and add a quick assertion. (expand to view GIF)

CleanShot_2025_12_08_18_35_08

Checkout and fill in shipping details. (expand to view GIF)

CleanShot_2025_12_08_18_37_14

Log out. (expand to view GIF)

CleanShot_2025_12_08_18_39_52

By the end, you should have a few recorded steps similar to what you see below.

image-20251208184442582

Save your scenario ​

Select Save to save your work. This commits the generated scenario and the Playwright code to the Git branch that powers your project. You'll be redirected back to the features page.

CleanShot_2025_12_08_18_47_39 ​

Run your scenario ​

On the features page, select the blue play button to run the scenario. This opens the AI Terminal and starts running your test.

CleanShot_2025_12_08_18_53_13

View Run Report ​

After the test completes, you're redirected to Run report on the reports page, which contains:

  • Step-by-step execution details
  • Screenshots for every action
  • Run duration and status
  • Run duration and status
  • Environment and test data
  • Console and network logs

CleanShot_2025_12_08_18_57_16

View the generated code (optional) ​

One of BlinqIO's most powerful features is that it generates real, production-ready Playwright code. All of this code lives in a Git repository, and you can even connect your own Git repository instead of using BlinqIO's.

To view the generated code, select the View Code button for your scenario.

image-20251120115533841

ViewCodeGif

Next Steps ​

Now that you've successfully created and run your first automated test, it's time to dig deeper into the AI Recorder. Learn about the different assertions, custom steps, and parameterization options so you can craft your perfect test.

Start by reviewing: AI Recorder Basics