Domtree - Test Automation

Fixture Builder

Generate clean, consistent and test-ready data fixtures from CSV, JSON, PDF or DOCX documents.

Powered by OpenAI GPT-4o-mini and built in Node.js + TypeScript.

What is Fixture Builder?

Fixture Builder is a lightweight CLI that transforms real data into normalised, ready-to-use fixtures for Cypress, Playwright, or raw JSON tests.

It supports multiple input formats: CSV/JSON ingestion for structured data, and AI-powered extraction for PDF and DOCX documents — turning unstructured documents like reports, tables, and specifications into structured JSON automatically.

Using OpenAI GPT-4o-mini, the AI engine intelligently recognises headers, extracts tables, and structures data from PDF and Word documents, making it perfect for converting legacy documents or specifications into test-ready fixtures.

It combines automation efficiency with human insight — letting teams move faster without compromising product understanding or quality.

Built in Node.js + TypeScript — with schema inference, deterministic masking, AI-powered document extraction, and AI-ready extension points.

Key Features

CSV / JSON Ingestion
Reads and cleans raw data from multiple sources
PDF Extraction
AI-powered extraction from PDF documents - recognises tables and structures automatically
DOCX Extraction
Extract structured data from Word documents - works with tables and key-value formats
AI-Powered Processing
Uses OpenAI GPT-4o-mini to intelligently extract and structure data from unstructured documents
Schema Inference
Automatically detects boolean, numeric, date, email, enum types
Test-Ready Output
Generates fixtures for Cypress, Playwright, or generic JSON
Deterministic Masking
Safely hides PII while keeping tests repeatable
Header Normalisation
Trims, removes BOMs, and converts to camelCase
Configurable Rules
Custom mappings, enrichment, and masking options
Repeatable Builds
Deterministic for stable CI runs

See It In Action

Before: Raw Table

Name	Email	Phone	Age
John Doe	john@example.com	555-0123	28
Jane Smith	jane@example.com	555-0456	32
Bob Wilson	bob@example.com	555-0789	45

Step 1: Structured JSON

[
  {
    "name": "John Doe",
    "email": "john@example.com",
    "phone": "555-0123",
    "age": 28
  },
  {
    "name": "Jane Smith",
    "email": "jane@example.com",
    "phone": "555-0456",
    "age": 32
  },
  {
    "name": "Bob Wilson",
    "email": "bob@example.com",
    "phone": "555-0789",
    "age": 45
  }
]

After: Playwright Fixture

import { test } from '@playwright/test';

export const users = [
  {
    name: "John Doe",
    email: "masked_email_1@example.com",
    phone: "masked_phone_1",
    age: 28
  },
  {
    name: "Jane Smith",
    email: "masked_email_2@example.com",
    phone: "masked_phone_2",
    age: 32
  },
  {
    name: "Bob Wilson",
    email: "masked_email_3@example.com",
    phone: "masked_phone_3",
    age: 45
  }
];

Step-by-Step Instructions

Choose your input format to see specific instructions:

1 Install

npm i -D domtree-fixture-foundry

2 Create Your Input Data

Start with a CSV or JSON file. Example:

mkdir -p data
curl -L -o data/users.csv https://raw.githubusercontent.com/datablist/sample-csv-files/main/files/people/people-100.csv

3 Create Config File

Create domtree.config.json in your project root:

{
  "input": "data/users.csv",
  "frameworks": ["cypress", "playwright", "raw"],
  "outputDir": "dist",
  "datasetName": "users",
  "mask": ["email", "phone"]
}

Key fields:

input - Path to your CSV or JSON file
frameworks - Output formats: cypress, playwright, or raw JSON
outputDir - Folder for generated fixtures
datasetName - Base name for output files
mask - Fields to anonymise deterministically

4 Generate Fixtures

npx domtree-fixtures generate --config domtree.config.json

Result: dist/cypress/fixtures/users.json, tests/fixtures/users.ts, users.json

1 Install

npm i -D domtree-fixture-foundry

2 Set Up Environment for AI (Optional)

For AI-powered extraction, create a .env file:

OPENAI_API_KEY=sk-your-key-here

Note: Ensure .env is in your .gitignore file.

3 Extract Data from PDF

Option A: AI-Powered Extraction (Recommended)

npx domtree-fixtures extract --input data/test.pdf --output data/test.json --ai

✅ AI reads the PDF, recognises headers, and structures tables automatically. Returns clean JSON objects.

Option B: Basic Extraction (Without AI)

npx domtree-fixtures extract --input data/test.pdf --output data/test_raw.json

Returns raw text extraction without AI processing.

4 Create Config File

Update domtree.config.json to use the extracted JSON:

{
  "input": "data/test.json",
  "frameworks": ["cypress", "playwright", "raw"],
  "outputDir": "dist",
  "datasetName": "companies",
  "mask": ["contact", "telephone"]
}

5 Generate Fixtures

npx domtree-fixtures generate --config domtree.config.json

Result: Clean, structured fixtures ready for testing.

1 Install

npm i -D domtree-fixture-foundry

2 Set Up Environment for AI (Optional)

For AI-powered extraction, create a .env file:

OPENAI_API_KEY=sk-your-key-here

Note: Ensure .env is in your .gitignore file.

3 Extract Data from DOCX

Option A: AI-Powered Extraction (Recommended)

npx domtree-fixtures extract --input data/companies.docx --output data/companies.json --ai

✅ Works for both Word tables and paragraph key/value structures. AI automatically infers headers and returns consistent JSON objects.

Option B: Basic Extraction (Without AI)

npx domtree-fixtures extract --input data/companies.docx --output data/companies_raw.json

Returns raw text extraction without AI processing.

4 Create Config File

Update domtree.config.json to use the extracted JSON:

{
  "input": "data/companies.json",
  "frameworks": ["cypress", "playwright", "raw"],
  "outputDir": "dist",
  "datasetName": "companies",
  "mask": ["contact", "telephone"]
}

5 Generate Fixtures

npx domtree-fixtures generate --config domtree.config.json

Result: Clean, structured fixtures ready for testing.

How It Works

Ingests CSV or JSON

Reads your raw data files

Infers Schema

Detects data types automatically

Normalises & Masks

Cleans headers, masks PII, fills missing data

Generates Fixtures

Creates test-ready fixture files

Deterministic + repeatable = high-quality test data that behaves the same in local and CI environments.

Gherkin Generator

Generate comprehensive gherkin test scenarios and test cases from descriptions, user stories or requirement specifications.

Powered by OpenAI GPT-4o-mini and built in Node.js + TypeScript.

View on GitHub npm Package

What is Gherkin Generator?

Gherkin Generator is an AI-powered CLI tool that generates comprehensive test scenarios and test cases from natural language descriptions, user stories, requirements, or feature specifications.

It transforms written requirements into structured test scenarios with steps, expected outcomes, and edge cases — making it easy to create thorough test coverage from documentation.

Using AI-powered analysis, Gherkin Generator understands context, identifies testable behaviors, and generates scenarios in multiple formats including Cypress, Playwright, Jest, or raw JSON test cases.

It combines AI intelligence with human insight — enabling teams to generate comprehensive test scenarios faster while maintaining quality and coverage.

Built in Node.js + TypeScript — with AI-powered scenario generation, multi-framework output, and customisable templates.

Key Features

Natural Language Input
Generate test scenarios from descriptions, user stories, or requirements
AI-Powered Analysis
Intelligently identifies testable behaviors and generates comprehensive scenarios
Structured Scenarios
Generates scenarios with steps, expected outcomes, and edge cases
Multi-Framework Output
Generates test cases for Cypress, Playwright, Jest, or raw JSON
Edge Case Detection
Automatically identifies and includes boundary conditions and error scenarios
Customisable Templates
Configure output format and scenario structure to match your team's needs
Repeatable Generation
Deterministic scenarios for consistent test coverage

See It In Action

Before: Specification Document

SPECIFICATION DOCUMENT: User Authentication System

Version: 1.0
Last Updated: 2025-01-15

OVERVIEW
--------
The application requires a secure authentication system that 
enables registered users to access their accounts through a 
login interface. The system must validate user credentials, 
handle authentication failures gracefully, and implement 
security measures to prevent unauthorised access.

FUNCTIONAL REQUIREMENTS
-----------------------

1. User Login Process
   - Users must provide a valid email address in the email field
   - Users must provide their associated password in the password field
   - The system must validate the email format before submission
   - Credentials must be verified against the user database
   - Upon successful authentication, users should be redirected 
     to their personalised dashboard
   - Session tokens should be generated and stored securely

2. Error Handling & User Feedback
   - Invalid email format should display: "Please enter a valid email"
   - Incorrect password should display: "Invalid credentials"
   - Non-existent user should display: "Account not found"
   - All error messages should appear prominently below the form
   - Users should remain on the login page when errors occur

3. Security Measures
   - Account lockout after 3 consecutive failed login attempts
   - Locked accounts must display: "Account temporarily locked"
   - Locked accounts should remain locked for 15 minutes
   - All login attempts must be logged with timestamp and IP
   - Passwords must be hashed using bcrypt before storage
   - Session timeout after 30 minutes of inactivity

4. User Experience
   - Login form should be accessible and responsive
   - Loading indicator should appear during authentication
   - Success feedback should briefly show before redirect
   - Form should support keyboard navigation and screen readers

After: Gherkin Scenarios

Feature: User Login
  As a user
  I want to log in to the application
  So that I can access my account and dashboard

  Scenario: Successful login with valid credentials
    Given I am on the login page
    When I enter a valid email "user@example.com"
    And I enter a valid password "SecurePass123"
    And I click the login button
    Then I should be redirected to the dashboard
    And I should see my user profile

  Scenario: Failed login with invalid credentials
    Given I am on the login page
    When I enter an invalid email "wrong@example.com"
    And I enter an invalid password "WrongPass"
    And I click the login button
    Then I should see an error message "Invalid credentials"
    And I should remain on the login page

  Scenario: Account lockout after multiple failed attempts
    Given I am on the login page
    When I attempt to login with invalid credentials
    And I attempt to login with invalid credentials again
    And I attempt to login with invalid credentials a third time
    Then I should see an error message "Account locked"
    And I should not be able to attempt login again

Step-by-Step Instructions

Get started with Gherkin Generator in a few simple steps:

1 Install

npm i -D domtree-scenario-forge

2 Set Up Environment

Create a .env file with your OpenAI API key:

OPENAI_API_KEY=sk-your-key-here

Note: Ensure .env is in your .gitignore file.

3 Create Input File

Create a file with your feature description or user story. Example feature.txt:

Feature: User Login
As a user, I want to log in to the application
so that I can access my account.

Requirements:
- User must enter valid email and password
- System should validate credentials
- On success, redirect to dashboard
- On failure, show error message

4 Generate Scenarios

npx domtree-scenarios generate --input feature.txt --output scenarios.json

Result: Comprehensive test scenarios with steps and expected outcomes.

5 Generate Test Cases

Convert scenarios to framework-specific test cases:

npx domtree-scenarios build --scenarios scenarios.json --framework cypress --output cypress/e2e/login.cy.js

Result: Ready-to-run test files in your chosen framework.

How It Works

Reads Requirements

Parses user stories or feature descriptions

AI Analysis

Identifies testable behaviors and edge cases

Generates Scenarios

Creates structured scenarios with steps and outcomes

Outputs Test Cases

Generates framework-specific test files

AI-powered scenario generation = comprehensive test coverage that scales with your requirements.

Phase	Focus	Key Features	Status
Phase 1 — Foundation	Establishing reliable, repeatable fixture generation	• CSV + JSON ingestion • Schema inference (boolean, number, date, enum) • Deterministic masking for PII • Header normalisation (`camelCase`, BOM removal) • Cypress / Playwright / Raw JSON outputs • Config-driven CLI • Published on npm	Complete
Phase 2 — Expansion	Broaden supported input types & data flexibility	• File adapters for Excel, PDF, DOCX • `domtree-fixtures extract` command for pre-processing • Plugin architecture for new file formats • Improved validation and data consistency checks	Complete
Phase 3 — Intelligence (AI-Assist)	Integrating AI for smarter, context-aware data	• `--ai-suggest` for LLM-powered schema inference • `--ai-enrich` for contextual, anonymised data filling • AI-driven test scenario generation (user journeys, edge cases) • Human-in-the-loop schema review	Planned
Phase 4 — Experience (Domtree Vision)	Enabling collaboration, visibility & learning	• Web interface for upload, preview, and export • Domtree Cloud for reusable datasets • AI engine that reads PRDs & UX docs to propose test data • Community template sharing	Future
Continuous Enhancements	Refinement, stability & scale	• CI/CD integrations (GitHub Actions, Jenkins) • Config validation and schema typing • CLI UX improvements • Privacy & security modes	Future

Java Test Framework

Prebuilt Playwright automation frameworks for Java developers. Choose the right solution for your team size and needs.

View Documentation

Basic Framework (Available Now)

A robust, minimalistic Playwright test framework designed for startups and small companies. Perfect for teams that need a clean, lightweight solution without unnecessary complexity. Clone the repository from GitHub, install dependencies, and start writing tests immediately.

Ideal for: Small teams, startups, projects with straightforward testing needs, teams new to automation.

View Documentation

Basic Framework Features

The basic framework includes everything you need to get started with UI and API testing, including full Gherkin/BDD support.

Core Features

Full Gherkin Support
Write tests in natural language using Gherkin feature files. The framework automatically maps your scenarios to executable test steps.
Basic Reporting
Built-in HTML reports with screenshots, video recordings, and detailed test execution summaries.
API Testing Support
Test REST APIs alongside your UI tests. Built-in HTTP client with request/response validation and mocking capabilities.
CI/CD Ready
Pre-configured for GitHub Actions, Jenkins, and other CI/CD pipelines. Includes Docker support for containerised test execution.
Comprehensive Documentation
Step-by-step guides, example tests, and best practices to help your team get productive quickly. View full documentation.

Coming Soon

Enterprise Framework

An enterprise-ready Playwright test framework built for large organisations and complex testing requirements. Includes advanced features like distributed test execution, comprehensive reporting dashboards, integration with enterprise tools, and extensive scalability options.

Ideal for: Large teams, enterprise environments, complex test scenarios, organisations requiring advanced reporting and analytics, teams needing extensive integrations.

Enterprise Framework Features

The enterprise framework will include all basic features plus advanced capabilities for large-scale testing operations.

Advanced Features

Advanced Reporting Dashboards
Comprehensive analytics, trend analysis, and customisable dashboards for executive reporting and team insights. Track test results and trends over time with advanced visualisation.
Distributed Test Execution
Run tests across multiple machines and environments simultaneously for faster execution and better resource utilisation.
Enterprise Tool Integrations
Seamless integration with Jira, TestRail, Azure DevOps, and other enterprise tools for complete test lifecycle management.
Scalability & Performance
Built to handle thousands of tests with optimised execution, parallel processing, and resource management.
Security & Compliance
Enterprise-grade security features, audit trails, and compliance reporting for regulated industries.

Self-Healing Agentic Test Framework

Prebuilt Playwright automation framework for .NET developers. Get started in minutes with a production-ready test suite.

View Documentation View on GitHub

What You Get Out of the Box

A production-ready self-healing agentic test automation framework that combines Playwright's powerful browser automation with intelligent healing agents. Write maintainable tests using SpecFlow (Gherkin), leverage Page Object Model patterns, and let AI agents automatically repair broken selectors when your application changes. No more manual selector updates—the framework self-heals.

Core Features

SpecFlow & Gherkin Support
Write tests in natural language using Gherkin feature files with SpecFlow. The framework automatically maps your scenarios to executable test steps using NUnit as the test runner.
Intelligent Healing Agents
Three AI-powered agents work together: Planner generates test plans, Generator creates feature files, and Healer automatically repairs broken selectors when your application's DOM changes. No more manual selector updates.
Page Object Model (POM)
Maintainable selector management with a clean Page Object Model architecture. The Healer agent automatically updates Page Object properties when selectors break, using multiple locator strategies recorded during successful runs.
Allure Reporting
Generate beautiful Allure reports with screenshots, video recordings, and detailed test execution summaries. Track test results and trends over time with comprehensive analytics.
CI/CD Ready
Pre-configured for Azure DevOps, GitHub Actions, and other CI/CD pipelines. Includes Docker support for containerised test execution and environment-specific configuration.
Comprehensive Documentation
Step-by-step guides, example tests, and best practices to help your team get productive quickly.
View full documentation.

Coming Soon

C# Test Framework

Prebuilt Playwright automation framework for .NET developers. Get started in minutes with a production-ready test suite.

What You Get Out of the Box

Download a complete, ready-to-use Playwright test framework built specifically for C# and .NET. No configuration headaches—just clone, install dependencies, and start writing tests.

Core Features

Full Gherkin Support
Write tests in natural language using Gherkin feature files. The framework automatically maps your scenarios to executable test steps.
Advanced Reporting
Built-in HTML reports with screenshots, video recordings, and detailed test execution summaries. Track test results and trends over time.
Fixture & Data Management
Integrated fixture builder for generating test data. Support for CSV, JSON, and database-driven test scenarios.
API Testing Support
Test REST APIs alongside your UI tests. Built-in HTTP client with request/response validation and mocking capabilities.
CI/CD Ready
Pre-configured for Azure DevOps, GitHub Actions, and other CI/CD pipelines. Includes Docker support for containerised test execution.
Comprehensive Documentation
Step-by-step guides, example tests, and best practices to help your team get productive quickly.

Playwright

C#

Coming Soon

TypeScript Test Framework

Prebuilt Playwright automation framework for TypeScript developers. Get started in minutes with a production-ready test suite.

What You Get Out of the Box

Download a complete, ready-to-use Playwright test framework built specifically for TypeScript. No configuration headaches—just clone, install dependencies, and start writing tests.

Core Features

Full Gherkin Support
Write tests in natural language using Gherkin feature files. The framework automatically maps your scenarios to executable test steps with full type safety.
Advanced Reporting
Built-in HTML reports with screenshots, video recordings, and detailed test execution summaries. Track test results and trends over time.
Fixture & Data Management
Integrated fixture builder for generating test data. Support for CSV, JSON, and database-driven test scenarios with TypeScript interfaces.
API Testing Support
Test REST APIs alongside your UI tests. Built-in HTTP client with request/response validation and mocking capabilities.
CI/CD Ready
Pre-configured for GitHub Actions, Jenkins, and other CI/CD pipelines. Includes Docker support for containerised test execution.
Comprehensive Documentation
Step-by-step guides, example tests, and best practices to help your team get productive quickly.

Playwright

TypeScript

Ship Faster with Confidence

Upcoming Automation Projects

Enterprise Java Framework

TypeScript Framework Release

Web Interface for Tools

Domtree Cloud Integration

Tools

Agentic

Automation Frameworks

Fixture Builder

What is Fixture Builder?

Key Features

See It In Action

Step-by-Step Instructions

1 Install

2 Create Your Input Data

3 Create Config File

4 Generate Fixtures

1 Install

2 Set Up Environment for AI (Optional)

3 Extract Data from PDF

4 Create Config File

5 Generate Fixtures

1 Install

2 Set Up Environment for AI (Optional)

3 Extract Data from DOCX

4 Create Config File

5 Generate Fixtures

How It Works

Ingests CSV or JSON

Infers Schema

Normalises & Masks

Generates Fixtures

Gherkin Generator

What is Gherkin Generator?

Key Features

See It In Action

Step-by-Step Instructions

1 Install

2 Set Up Environment

3 Create Input File

4 Generate Scenarios

5 Generate Test Cases

How It Works

Reads Requirements

AI Analysis

Generates Scenarios

Outputs Test Cases

Test Automation Roadmap

Java Test Framework

Basic Framework (Available Now)

Basic Framework Features

Core Features

Enterprise Framework

Enterprise Framework Features

Advanced Features

Self-Healing Agentic Test Framework

What You Get Out of the Box

Core Features

C# Test Framework

What You Get Out of the Box

Core Features

TypeScript Test Framework

What You Get Out of the Box

Core Features