Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

TSpec

github.com

  • Free plan
6.5 Club score Visit github.com

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.