Skip to main content
Open-source infrastructure testing for IaC

Test infrastructure stacks before they surprise you.

StackTest runs repeatable infrastructure tests across IaC tools and cloud providers, validates outcomes, protects cleanup with ownership checks, and produces CI-friendly reports.

Provider-agnostic core Safety-first cleanup CI-ready reports
bash
$ npm create stacktest@latest
$ cd my-iac-tests
$ stacktest run --config stacktest.yml
planned 3 regions
validated ownership tags
deployed test stack
captured outputs
destroyed test resources
wrote reports/html/index.html
⚠️

Failed test stacks leave expensive leftovers

🔥

Cleanup scripts can delete the wrong resources

🔄

IaC tools differ, but testing workflows repeat

StackTest separates test orchestration from provider-specific logic so every provider can follow the same safe lifecycle.

Lifecycle

How StackTest Works

A standardized, safe infrastructure test execution pipeline.

1

Plan

Read config, expand providers, target regions, and validate inputs.

2

Deploy

Call provider adapters to spin up fresh testing stacks.

3

Validate

Run assertions, verify outputs, and capture cloud events.

4

Cleanup

Safely destroy only resources tagged with ownership metadata.

5

Report

Generate raw JSON, JUnit XML, and visual HTML dashboards.

Core Capabilities

Built for robust infrastructure delivery

Everything you need to validate stacks and keep cloud environments tidy.

🔌

Provider-Agnostic Core

Decoupled planning allows running the exact same test suites across CloudFormation, Terraform, AWS CDK, Pulumi, Kubernetes, and Azure Bicep.

Learn about providers
🛡️

Safe Cleanup by Design

Strict ownership tag verification ensures StackTest only destroys resources it created, leaving existing infrastructure completely untouched.

See safety details
🎛️

Dynamic Parameters

Inject dynamic runtime variables, generate unique resource names, and override parameters dynamically per region and test run.

Explore parameters
📊

CI-Friendly Reporting

Generate raw JSON for custom tools, standard JUnit XML for CI/CD pipeline integration, and beautiful interactive HTML dashboards.

Read about reports
💻

Local-First Development

Test infrastructure directly from your local terminal or IDE with instant feedback loop before pushing code to remote branches.

Install CLI tool
🤖

Agent-Friendly Docs

Pre-packaged configuration rules, strict YAML schemas, and AI-focused guidelines designed to make coding agents extremely productive.

Read Agent guidelines
Simple Setup

Get started in minutes

Define your providers, target regions, templates, and environment variables in a single declarative stacktest.yml file. StackTest handles the execution and cleanup loop automatically.

stacktest.ymlYAML
name: cfn-smoke-test
providers:
  aws-cloudformation:
    regions: [us-east-1, us-west-2]

tests:
  - name: vpc-template
    template: ./templates/vpc.yml
    parameters:
      EnvironmentName: stacktest-dev
StackTest Run Dashboardcfn-smoke-test • Run #142
PASSED
Total Tests3
Passed3
Failed0
Duration2m 45s
aws-cloudformation:us-east-1:vpc-template1m 12s
aws-cloudformation:us-west-2:vpc-template1m 18s
Cleanup verified (0 orphaned resources)15s
Verification & Reports

Deep insights, automated feedback

StackTest outputs full reports designed for both humans and CI integrations. Verify test coverage, inspect parameters, track durations, and confirm cleanup success instantly.

JSONCustom scripting
JUnit XMLCI/CD pipeline test parsing
HTML DashboardInteractive standalone visualizer

Start with one template. Add providers later.

Protect your active infrastructure and start verifying your deployments with safety first.