bun-test-ui

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

★ 9 Open GitHub ↗

Test runner UI for Bun, similar to Vitest UI

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# bun-test-ui

A visual test runner UI for Bun, similar to [Vitest UI](https://vitest.dev/guide/ui.html).

[![bun-test-ui](https://img.shields.io/npm/v/bun-test-ui)](https://npmx.dev/package/bun-test-ui)

![bun test ui ui](https://raw.githubusercontent.com/Rettend/bun-test-ui/main/docs/images/ui.png)

## Install

```bash
bun add -d bun-test-ui
```

## Usage

```bash
bunx bun-test-ui
```

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

### Options

```bash
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:

```toml
[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](https://github.com/oven-sh/bun/blob/main/packages/bun-inspector-protocol/README.md) to communicate with Bun's test runner via the WebSocket inspector, similar to how `bun-vscode` implements VS Code test runner support.

## Development

```bash
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

bun-test-ui

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README