TestProject — Test Automation Made Easy

Ronnie Schaniel
5 min readMar 15, 2021

TestProject is a free test automation platform for web, mobile, and API testing and is backed by a strong community. In this post we discover TestProject and show the first steps using it for a web site.

Signing Up and Getting The Agent Ready

After a quick signup and login we are presented with a dashboard:

We can see an example project which we will check out in a minute. But first let’s quickly download the agent that will run our tests:

The agent is available for Windows, Linux, MacOS and there is even a version for docker. We have downloaded the MacOS variant and have given it a name.
We start the local agent and click “Register Agent” afterwards. This establishes a connection between the local agent and our account. After a few seconds our Agent’s status switches from “Starting” to “Ready”:

Now that we are set, let’s go back to the example project.

Checking Out the Example Test

When opening the “My First Test” example we are presented with three different tabs:

  • Test let’s you adjust the general settings of the test, e.g. define in which cases screenshots are taken
  • Under Steps you can define the actions that are taken in your test like navigating, clicking, entering text, etc.
  • Finally under Parameters things like URLs and input data are configured

On a first glance in the Steps tab, we see that a navigation happens and afterwards the test executes a login:

Running the Example Test

On the test overview page we are able to run the example test. For that we just click on the play icon:

This will present us with a popup to choose the agent and browser for our web test. Also headless variants are available:

We’re going with Chrome here and confirm the parameters on the next page:

After hitting “Run” an animated circle indicates that the test is running indeed:

A Chrome browser window is opened up where the actual test is executed on the demo web page:

And after a short while the test already finished and a green icon shows us that it was a success:

When navigating to the test report via the green icon, we can see all the details to the test run, e.g. time and steps:

A Failed Test

We also want to see what it looks like when a test fails. So, let’s start the run again and put a wrong password:

In the Chrome browser window during the run we already see that something went wrong with the password input:

And after the test finished we don’t see a green icon this time, but a red one:

On the detail view it’s clear that Step 7 failed:

When expanding the step 7 we also can learn why the step failed (ElementNotVisible) and even have a screenshot available that helps us to troubleshoot:


I was quite impressed by the tool. It has a modern look and quickly allows you to define and run tests. The test report for the failed case was helpful which is often not the case for other test runners.

I was not able to try all the features and plugins TestProject offers. It’s certainly good to consult the docs and browse through the addons to see what is available.

To avoid problems it makes sense to always have the latest Test Agent version on your machine. I ran into a problem once, because I had an outdated version. Otherwise everything was working smoothly.

One part that is often cumbersome is the creation of tests. Also for that TestProject offers something. The record feature allows to create your test in an easy way:

My verdict on TestProject: something you should try out!