UNRIFT

A lightweight, fast TypeScript test framework with ESM-first design.

Documentation · Getting Started · API Reference

Features

• ESM-first with CJS fallback
• TypeScript native — esbuild-powered transforms, no separate compile step
• Familiar API — describe / it / expect (Jest/Vitest compatible)
• Rich matcher set — deep equality, toMatchObject, toHaveProperty, numeric, async, and more
• Extensible matchers via expect.extend()
• Async assertions — resolves / rejects with full .not support
• Test modifiers — .only, .skip, .todo
• Bail mode and configurable timeouts
• JSON output for CI integration
• Programmatic API — runEngine for use in custom tooling
• Zero config — works out of the box

Install

npm install -D unrift
# or
pnpm add -D unrift
# or
yarn add -D unrift

Quick Start

// math.spec.ts
import { describe, it, expect } from "unrift";

describe("math", () => {
  it("adds numbers", () => {
    expect(1 + 2).toBe(3);
  });

  it("compares objects", () => {
    expect({ a: 1 }).toEqual({ a: 1 });
  });
});

npx unrift

For more examples, see the Quick Start guide.

Documentation

Visit unrift.pages.dev for the full documentation:

• Installation
• Configuration
• CLI
• Matchers
• Hooks
• Custom Matchers
• Async Testing
• Migrating from Jest
• Programmatic API

License

MIT