StackTest is a provider-agnostic infrastructure testing framework. Deploy infrastructure templates across one or more regions or environments, validate whether they succeed, capture detailed event logs, clean up resources safely, and generate clean reports.
Inspired by the core concepts of taskcat, StackTest extends infrastructure testing to support multiple infrastructure providers and IaC frameworks dynamically (e.g. AWS CloudFormation, AWS CDK, Terraform) with a core emphasis on safety and isolation.
- Provider-Agnostic Core: Modular design decouples test planning and orchestration from cloud-specific logic.
- Safety First: Destructive cleanup operations are strictly gated by ownership tagging verification to ensure StackTest never deletes your external infrastructure.
- Dynamic Parameter Resolution: Inject dynamic variables (such as UUIDs, randomized passwords, project names, and region references) into deployment configurations before running tests.
- Rich Reporting: Outputs comprehensive JSON reports, JUnit XML for CI integrations, portable HTML reports, and a local dashboard for run history and event debugging.
Install the CLI using npm or pnpm:
npm install --save-dev @stack-test/cli
# or
pnpm add -D @stack-test/cliVerify your test matrices and parameters locally using the dry-run command:
npx stacktest planExecute test runs locally using a mock provider harness (zero cloud dependencies):
npx stacktest run --provider fakeInspect run history, deployment events, and raw artifacts from a local-only dashboard:
npx stacktest dashboardEverything runs on your machine and reads from .stacktest/runs.
packages/core: Core planning, dynamic resolver, and run orchestration engine.packages/cli: Thin CLI wrapper exposing command-line interfaces.packages/dashboard: Local dashboard server and web UI.packages/provider-aws-cloudformation: AWS CloudFormation target deployment provider (Phase 3).examples/: Runnable sandboxes (CFN, Terraform, multi-stage composition).schemas/stacktest.schema.json: Generated JSON Schema forstacktest.yaml(from Zod).docs/: Design decisions, roadmap milestones, and phased execution backlogs.
This project is licensed under the MIT License. See LICENSE for details.