Reqnroll Documentation

Reqnroll is an open-source .NET test automation tool to practice Behavior Driven Development (BDD).

Reqnroll is a .NET port of Cucumber and it is based on the SpecFlow framework and code base. You can find more information about the goal of the Reqnroll project and the motivations to create it on the Reqnroll website.

Reqnroll enables writing executable specifications for BDD using Gherkin, the widely-accepted feature file specification format. With that you can define the requirements using Given-When-Then style scenarios and turn them to automated tests in order to verify their implementation.

Reqnroll works on all major operating systems (Windows, Linux, macOS), on all commonly used .NET implementations (including .NET Framework 4.6.2+ and .NET 8.0). For executing the automated scenarios, Reqnroll can use MsTest, NUnit or xUnit. On Reqnroll projects you can work using Visual Studio 2022, Visual Studio Core and Rider, but you can also use Reqnroll without any IDE.

Since Reqnroll has been based on SpecFlow, you can use your SpecFlow knowledge to work with Reqnroll and it is also very easy to port an existing SpecFlow project to Reqnroll. You can check out our detailed migration guide.

This documentation provides a comprehensive source of information about how to use Reqnroll. We also recommend you to follow the news and the blog on the Reqnroll website.

How to use the documentation

Documentation is in progress

We are currently in progress of reviewing and restructuring the documentation ported from SpecFlow. If you find any glitches, please help with fixing it in our GitHub repository. Each page contains a small ✏️ (edit) icon to perform quick edits.

The documentation is structured in a way that you can find all relevant information quickly.