Thinking UI

Braille ProgressPRO

A compact progress line built from braille cells: a flowing snake while waiting, dot-by-dot fill when the total is known.

Code

1 file · 190 lines of TypeScriptPRO

Braille Progress is part of Pro

Get its source, the one-paste agent prompt and all 113 components, for a one-time $99.

Motion notes

  • Each braille cell is a 2×4 dot grid, so determinate mode gets 8 steps per character: a 16-cell bar resolves 128 positions. Dots fill each column bottom-up, so the leading edge rises rather than blinks.
  • Indeterminate mode runs a snake along a travelling sine wave: a two-dot-thick head in full ink, a muted trail whose last third dissolves into every other dot.
  • Three stacked layers in the same mono cells (dim track, muted trail, bright head) give per-dot contrast from single-color text. Value changes tween on the layout spring.
  • Updates write to the DOM directly and only while on screen. Exposes role=progressbar with aria-valuenow when determinate; reduced motion jumps straight to the value and freezes the snake.

Usage

Example
<BrailleProgress label="Installing" value={progress} />

  <BrailleProgress label="Thinking" width={12} />

  <StatusPill icon={<BrailleProgress width={3} />} label="Indexing" size="sm" />

Props

PropTypeDefaultDescription
valuenumber—0–100. Leave undefined for indeterminate.
widthnumber16Bar length in braille cells.
labelstring—Text before the bar. Also the accessible name.
showValuebooleantrueShow the percentage after the bar (determinate only).
speednumber1Playback multiplier for the indeterminate snake.
classNamestring—Classes for the row. Set text size here; the bar scales with it.