BlinqIO Documentation

Automate Your First Test with BlinqIO ​

After you sign up, the Get started page walks you through recording and running your first automated test.

Before you begin

  • Make sure you have the BlinqIO Client installed during sign-up.
  • Close any extra tabs or unnecessary applications to improve speed.

1. Set the application URL ​

Select Set application URL, then choose one of these options:

  • Enter your own URL. Example: https://www.example.com
  • Use our Demo Test App. This opens the BlinqIO demo shopping site with login, product, cart, and checkout pages.

selectAppURL

Demo credentials

Username: blinq_user
Password: let_me_in

2. Record a scenario ​

  1. Select Start recording. The AI Recorder opens with your application in a new browser window. RecordASceanrioOnboarding

  2. Perform the steps you want to automate in the browser. The AI Recorder captures clicks, typing, and navigation. shopping-website-demo-vid

    Example flow on the demo app:

    1. Log in with the demo credentials.
    2. Add a few items to the cart.
    3. Open the cart.
    4. Check out and fill shipping details.
    5. Log out.

Recording tips

  • Wait for each page or UI state to load before the next action.
  • Use clear, repeatable paths. Avoid random clicks or hover-only interactions.
  • If your app uses pop-ups, allow them for the Recorder session.

3. Generate code and save ​

The AI Recorder converts your actions into a parameterized test. A test includes a high‑level business description in Gherkin and Playwright JavaScript code.

  1. Select Generate code & Save. generate-code-save
  2. Enter a Feature name and Scenario name, then select Continue. name feature and scenario

4. Run the scenario ​

After saving your scenario, run it from your project.

  1. Go to the Features page in your account. This is the same page where you viewed the generated scenario. image-20250619110819612

  2. Select Execute to open the application launch window. image-20250619111253723

  3. In the launch window, select Execute scenario. The BlinqIO Editor opens and runs your test in a new browser window. run-test

After the run

When the test completes, the Editor console shows: Command finished, you can exit this window...

If the Editor does not open

  • Make sure the BlinqIO Client is running.
  • Allow the app through your firewall if prompted.
  • Quit and reopen the Client, then try Execute scenario again.

5. View the code ​

View the generated Playwright code for any scenario.

  1. Go to Features.

  2. Select the feature and then the scenario you created.

  3. Select View code in the scenario toolbar to bring up the code viewer window. CleanShot 2025-08-18 at 12.14.06@2x

  4. You can now view the generated code for each step of the test.

    image-20250818122855010

6. View reports ​

BlinqIO generates a detailed report after each run, including:

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

Open your test report:

  1. Go to the reports page and select the scenario report to open its detailed view. image-20250619114325373

  2. Select a step to expand it and view its actions. Screenshots for each action appear on the right. getting-started-1

  3. Open Console and Network logs for deeper insights and debugging.