Examples

Every example is a small, self-contained app in the repo's examples/ directory — clone the repo, bun install, and run any of them directly. They double as copy-paste starting points; each one uses seeded fake data so it runs identically everywhere. The recordings below are generated from the committed tape files with VHS.

Common keys in all examples: ↑/↓ or j/k to move, g/G to jump top/bottom, q to quit.

logship — log explorer

A tail-style log viewer over 12,847 lines: colored levels, service names, and a live position footer via onViewportChange.

bun examples/logs.tsx

gitscope — commit browser

A tig-style history browser: SHAs, conventional-commit subjects, authors, and relative dates, with keyExtractor keyed on the SHA.

bun examples/commits.tsx

podwatch — pod dashboard

A Kubernetes-flavored status board: colored health states, restart counts, and a summary header derived from the same data.

bun examples/pods.tsx

termmail — two-line inbox

An inbox with itemHeight={2} — sender/subject/time on the first line, a dimmed preview on the second. Shows multi-line items staying perfectly aligned while scrolling.

bun examples/inbox.tsx

Feature playground

The original interactive demo exercises the component's mechanics directly — cycle t through fixed, tiny (height={2}), and height="auto" modes to see the height budget behavior live.

bun examples/demo.tsx