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
| Prop | Type | Default | Description |
|---|---|---|---|
| value | number | — | 0–100. Leave undefined for indeterminate. |
| width | number | 16 | Bar length in braille cells. |
| label | string | — | Text before the bar. Also the accessible name. |
| showValue | boolean | true | Show the percentage after the bar (determinate only). |
| speed | number | 1 | Playback multiplier for the indeterminate snake. |
| className | string | — | Classes for the row. Set text size here; the bar scales with it. |