bun-test-ui

A visual test runner UI for Bun, similar to Vitest UI.

Install

bun add -d bun-test-ui

Usage

bunx bun-test-ui

This starts the UI at http://localhost:51205 and auto-opens your system browser.

Options

bunx bun-test-ui [pattern] [options]

Options:
  -p, --port <number>  Port to run on (default: 51205)
  --no-watch           Disable watch mode
  --no-open            Don't auto-open browser

Config

The CLI reads your bunfig.toml for test configuration:

[test]
root = "./tests/real"

For this repository:

• tests/demo contains UI demo tests (including intentional failures)
• tests/real contains the actual project test suite

Watch mode watches the current directory:

• Test file changes → Only that test file is re-run
• Source file changes → All tests are re-run

How it works

Uses bun-inspector-protocol to communicate with Bun's test runner via the WebSocket inspector, similar to how bun-vscode implements VS Code test runner support.

Development

bun install

# Dev server with HMR
bun run dev

# Dev server against real tests
bun run dev:real

# Run real tests (default)
bun test

# Run demo tests (includes intentional failures)
bun run test:demo

# Build for prod
bun run build

# Run prod CLI
bun run start

License

MIT