TSpec
github.com
- Free plan
What TSpec is
TSpec is a free, TypeScript-first testing framework for TypeScript applications. Basic use requires no configuration and includes native TypeScript support. Its assertion package handles synchronous checks and promises that resolve or reject. The mock package provides mock functions, spies, and replacements for object methods. Watch mode reruns tests when files change and can select affected tests. The command-line interface offers test selection, custom configuration, verbosity controls, silence, and timeouts. An optional TypeScript configuration file can define test patterns, ignored paths, timeouts, and output settings. Process exit codes are documented for CI/CD workflows. TSpec runs on Node.js, with Node.js 20 or later required, and installation is documented through npm. The repository identifies the project as MIT licensed. TSpec is in active development, and package publication is described as coming soon, so current use requires building from source. The project is designed specifically for TypeScript developers and does not document parallel execution.
Who it suits
TSpec is aimed at TypeScript developers testing TypeScript applications on Node.js. It fits projects that can build the framework from source and want watch mode, mocks, configurable assertions, and CI exit codes.
Good to know, and what to watch
- Zero-configuration setup for basic use
- Supports synchronous and asynchronous assertions
- Includes mocks, spies, and method replacement
- Watch mode selects affected tests
- MIT licensed and free
- Requires Node.js 20 or later
- Current use requires building from source
- Package publication is not yet available
- Does not support parallel execution
The verdict
TSpec offers TypeScript-focused assertions, mocks, watch mode, and command-line controls in a free MIT-licensed project. Its active-development status and source-build requirement are important considerations before adoption.
What the maker publishes
- Assertions
- Its assertion package includes synchronous assertions and async Promise resolve and reject assertions. source
- CI support
- The README describes process exit codes for use in CI/CD workflows. source
- CLI
- The CLI offers options for test selection, custom configuration, verbosity, silence, and timeouts. source
- Configuration
- Basic usage requires no configuration, and an optional TypeScript config file can set test patterns, ignores, timeouts, and output options. source
- Distribution status
- The project says it is in active development and that package publication is coming soon; current use requires building from source. source
- Installation status
- The README says TSpec is in development and currently requires building from source; package publication is described as coming soon. source
- Intended users
- The project describes itself as designed specifically for TypeScript developers. source
- License
- The repository identifies the project as MIT licensed. source
- Maker
- The GitHub repository is owned by oliver-richman, whose profile identifies him as Oliver Richman and lists London, UK. source
- Mocking
- Its mock package supports mock functions, spies, and replacing object methods. source
- Platform
- The README documents installation through npm and running TSpec from a project or command line. source
- Purpose
- TSpec is a TypeScript-first testing framework for testing TypeScript applications. source
- Runtime requirement
- The listed prerequisite is Node.js 20 or later. source
- Security and compliance
- The opened README does not state any security certification or compliance claim. source
- Setup
- The project describes zero-configuration setup for basic use and native TypeScript support. source
- Watch mode
- Watch mode can rerun tests when files change and select affected tests. source
- What it does
- TSpec is a TypeScript-first testing framework for testing TypeScript applications. source
Checked against the maker's pages on 8 Oct 2026.