testform.

Declare, plan, apply, and reconcile in Git.

Declarative test framework: zero mandatory SaaS servers and zero Test Drift. Manage your entire QA lifecycle, version every test suite as source code, and ensure immutable cryptographic traceability in every commit.

npmGlobal Installation

v1.1.0 • verified

>npm i -g @fromeroc9/testform@beta

Test Drift

0.0% Drift

Synced via Git SHA

Per-Seat Cost

$0 / Dev

100% free local & CI runs

Immutable Ledger

SHA-256

Tests sealed in Git commit

Setup Time

< 30 sec

Native CLI, zero server

workbench@testform:~/specs

# features/todo.case.feature
@testcase
Feature: TodoMVC Task Management
  As an application user
  I want to manage my task list
  To organize my daily activities

  @tc-001
  Scenario: Create a new task in TodoMVC
    Given the browser opens URL "${var.e2e_app_url}"
    When the user enters task "Learn Testform and TaC"
    And presses Enter key
    Then the task list contains 1 item
    And the task text is "Learn Testform and TaC"

  @tc-002
  Scenario: Mark task as completed
    Given at least exists 1 task in the list
    When the user clicks the checkbox
    Then the task status changes to completed

# suites/sprint24.run.feature
@testrun
@tr-001
Feature: Sprint 24 Regression Suite

  Rule: features/todo.case.feature
    Scenario: @tc-001
      * mark status = passed

    Scenario: @tc-002
      * mark status = pending

  Rule: features/api_todo.case.feature
    Scenario: @tc-003
      * mark status = passed

# plans/release_v1.plan.feature
@testplan
@tp-001
Feature: Release 1.0 Quality Plan

  # Declarative binding of test suites
  Rule: suites/sprint24.run.feature
  Rule: suites/api_contract.run.feature

UTF-8 • Git Blame TrackedHEAD: commit c4d8a1

terminalconsole

PHASE 1 / 4|SHA: 0x8a4b...INIT

Backend: Local / State Synced

+ 1 to add~ 0 modified- 0 drift

Deterministic Plan Engine • v1.1.0

Continuous Quality Architecture

Why Testform: The New Paradigm of QE

Testform does not seek to break your existing suites or frameworks; it evolves quality engineering (QE) by integrating natively into Git. Complement your current tools and prepare your infrastructure with zero vendor lock-in.

sync_disabled

1. Eliminate Test Drift

Zero desynchronization between your codebase and test cases. Every change in your contracts triggers an immediate discrepancy alert before deployment.

verifiedZero State Discrepancy

credit_card_off

2. Zero Seat Costs

Run freely on your local machine and CI/CD runners without paying abusive $70/mo license fees for every developer or tester making commits.

payments100% Free Core Engine

source_environment

3. Git as Single Source of Truth

Your test specifications live in Git branches, participate in standard Pull Request reviews, and follow real semantic versioning rules.

mergePR-First Quality Flow

history_edu

4. Git Blame & Native Auditability

Audit through real commits and granular line-by-line Git blame on every test case. Zero opaque proprietary signatures: every change has a verified author and SHA.

commitGranular Git Blame Audit

cloud_sync

5. Total Data Sovereignty

Your specs and execution artifacts live in your repo or your own storage bucket (AWS S3, MinIO, GCS). Zero secret leaks to third-party SaaS.

keySelf-Hosted S3 / MinIO

lock_open

6. Zero Lock-In & Total Portability

Define tests in Gherkin or YAML completely unchained. Store specs in your own repositories and compile cleanly for any modern test runner.

tuneDeclarative Extensibility

Pipeline Guard

Block Drift Before Merge: Strict PR Verification

GitHub Actions and GitLab CI automatically execute testform plan and testform diff --remote on every Pull Request.

If a developer modifies endpoint logic or services without updating linked tests, CI detects the desynchronization and alerts the team in real time. Zero manual sync work, zero scattered spreadsheets.

check_circleReal-time speculative change analysis

check_circleAutomated reconciliation between Git and GitHub Projects

check_circleImmutable cryptographic seal verified in commit

terminal.github/workflows/ci.yml

GitHub Actions

name: "Testform State & Drift Validation"
on:
  pull_request:
    branches: [ main, release/* ]

jobs:
  testform-drift-guard:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout Repository Code
        uses: actions/checkout@v4

      - name: Setup Node.js Runtime
        uses: actions/setup-node@v4
        with:
          node-version: '20.x'

      - name: Install Testform Engine CLI
        run: npm i -g @fromeroc9/testform@beta

      - name: Initialize Backend
        run: testform init

      - name: Execute Speculative Drift Plan
        run: testform plan

      - name: Audit Remote State Synchronization
        run: testform diff --remote

check_circleExit Code 0: Clean Test State MatrixPR Drift Guard: Active

Economic Model for Engineering Leads

Instant Impact & ROI Calculator

Contrast the hidden cost of paying SaaS QA licenses against the open adoption of Test-as-Code.

Engineering & QA Team Size50 Engineers

5 devs50 devs100 devs200+ devs

Current Monthly SaaS Cost Per Seat$60 USD / mo

$30/mo$60/mo (Average)$90/mo$120/mo

infoCalculation based on traditional licenses (TestRail, Zephyr, Xray, PractiTest):

• Engineers do not need read/write accounts on external platforms: everything flows through Git.

• Includes a conservative estimate of 1.5 hours saved per engineer per week on manual sync tasks.

Testform Core: 100% direct license savings with unlimited test runs.

Net Annual License Savings

$36,000

USD eliminated from recurring spend

Testform Spend: $0100% Seat Cost Reduction

Manual Hours Saved

3,900 hrs / yr

Manual reconciliations eliminated

schedule

Technical & Operational Matrix

Hybrid Benchmark: Testform vs Traditional SaaS

Compare point-by-point the agility, costs, and data sovereignty of a Test-as-Code architecture versus the legacy disconnected SaaS model.

Evaluation Criteria	testform. (Declarative TaC)	Traditional SaaS (Legacy QA)
attach_moneyCost Model	$0 / Seat Zero cost per developer and no execution quotas	$50 - $85 / mo Mandatory per-user license fees
commitSource of Truth	Native Git Specs versioned in PRs, branches, and commits	Isolated Web UI Third-party database disconnected from source code
warningDrift Detection	Automated in CI/CD `testform diff --remote` alerts and blocks misaligned merges	Manual & Nonexistent Relies on testers memory to update web portals
fingerprintAudit & Traceability	Git Blame + SHA-256 Ledger Immutable cryptographic seal verified by hash	Proprietary Volatile Logs Editable by admins, no digital signature
cloud_doneStorage & Sovereignty	100% Your Own Repo & Cloud Your data resides in your cloud (S3, GCS, Azure, or local)	Vendor Closed Cloud Risk of vendor lock-in and sensitive data leakage
terminalCI/CD Pipeline Integration	Pipeline First (Native GitHub Actions & GitLab CI) Governs QA lifecycle directly in your workflows via CLI	Rigid Plugins / Limited Webhooks Requires slow sync tools, third-party tokens, and proprietary SDKs

terminal

Start governing your tests as infrastructure

Install the official CLI, run your first testform init, and protect your pipeline against desynchronization in under two minutes.

$npm i -g @fromeroc9/testform@beta

menu_bookRead Documentation codeCLI Reference ★GitHub (Open Source)

Open Source Apache-2.0 • Compatible with any modern testing stack