Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/davidG97/qa-flow/llms.txt

Use this file to discover all available pages before exploring further.

QA Flow is an open-source test automation platform that lets you design, run, and manage Playwright tests through an interactive drag-and-drop canvas. Instead of writing test scripts by hand, you connect nodes representing actions, assertions, and control flow — then execute them with a single click and watch the browser run live.

Quickstart

Launch QA Flow in under two minutes with a single npx command.

Installation

Explore all install options: npx, Docker, and local development.

Editor Overview

Learn how the visual canvas, node palette, and flow editor work.

Node Reference

Browse all 30+ built-in node types — actions, assertions, hooks, and control flow.

What You Can Build

QA Flow covers the full automated testing workflow — from flow design to results analysis:

Design Tests Visually

Drag nodes onto a canvas and connect them to build complete test flows without writing a line of code.

Run in Real Time

Execute tests and watch the browser screencast live in the sidebar as each node runs.

Generate Playwright Code

Export your visual flow as runnable Playwright TypeScript code, or record real interactions to import automatically.

Emulate Any Device

Test on iPhone, Pixel, iPad, Galaxy and more — with custom viewport, locale, timezone, and geolocation.

Review HTML Reports

Every test run produces a Playwright-style HTML report with per-node results, screenshots, and timing.

Manage Team Access

JWT authentication with Admin and User roles. Invite teammates to projects and control who can run tests.

Get Started in Minutes

1

Launch QA Flow

Run a single command — Docker is pulled and started automatically:
npx @davidg97/qa-flow
Then open http://localhost:3001.
2

Log in

Use the default admin credentials: admin@qaflow.com / admin123. Change these before any production deployment.
3

Create a project and design your first flow

Click New Project, drag a Start node onto the canvas, set your target URL, then add action and assertion nodes.
4

Run and review results

Click ▶ Execute and watch the integrated screencast. When the run finishes, open the generated HTML report.
QA Flow runs entirely in your infrastructure — no data leaves your server. The npx command pulls the official Docker image and starts a local instance.

Explore the Docs

Running Tests

Configure execution mode, parallelism, retries, and timeouts.

Real-Time View

Use the integrated screencast or connect your own Chrome via CDP.

Docker Deployment

Deploy with Docker Compose using SQLite or Turso cloud database.

API Reference

Integrate QA Flow programmatically — full REST API documentation.

Build docs developers (and LLMs) love