Text RevealPro
Text that arrives word by word or letter by letter, each piece rising out of a clip and a soft blur as it comes into view, on a capped stagger.
oxyn add word-revealShip the work, keep the trail
The preview stays free for everyone. Pro opens the code of every Pro component, screen, agent-app template, block and kit, plus the Pro CLI.
Rendered from Rust at build time · goes live when visible
When to use
- Text that arrives word by word or letter by letter: each piece rises out of a clip and sharpens from a blur (softer for paragraphs) on a stagger capped at 900 ms total, after an optional delay.
- It plays when shown turns true (the host observes the viewport); with once it stays revealed, otherwise it plays again on each entry.
- Pure CSS once rendered, so text is never left hidden by slow scripts.
When not to use
- An agent asks before it acts: use Approval Card instead.
- Several open requests in one card: use Approval pager instead.
- An agent's question in its own card above the composer: use Decision Card instead.
Installation
Text Reveal is part of Oxyn Pro; the preview is free. Pro items install with the oxyn CLI once your licence is signed in; until then Pro members copy the code from this page.
oxyn add word-revealUsage
The preview is free. Pro opens the code of every Pro component, screen and template.
Examples
Heading
Words rise out of a clip and a blur.
Ship the work, keep the trail
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Paragraph
A paragraph with a softer blur; total stagger capped.
Agents finish the work you start, then hand it back with every step written down so you can check it in a minute.
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Chars
Letter by letter.
Ship the work, keep the trail
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Replay
Plays again on each entry.
Ship the work, keep the trail
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
API reference
WordReveal
| Prop | Type | Default | Description |
|---|---|---|---|
textrequired | String | — | Text. |
by | String | "word" | `word` · `char`. |
tag | String | "p" | `h1` · `h2` · `h3` · `p` · `span`. |
stagger_ms | u32 | 40 | Between pieces, ms (total capped at 900 ms). |
delay_ms | u32 | Default::default() | Before the first piece, ms. |
duration_ms | u32 | 700 | Each piece, ms. |
shown | bool | true | In view (host-observed). |
once | bool | true | Reveal only the first time. |
Read from the Rust signature and doc comments.
Keyboard interactions
| Key | Action |
|---|---|
| — | Not interactive |
Accessibility
- The element carries the whole text as its aria-label, so pieces are read as one.
From the spec
- The element carries the full text as aria-label.
Motion & interaction
Timing
- Reduced motion: no rise, blur or stagger; labels and values swap instantly (slot reels land at once, the shimmer band stops and the text stays muted).
Responsive behaviour
- Wraps normally; each word is its own box.
Edge cases (spec)
- Wraps normally.
Notes for AI
- Import
WordRevealfromoxyn_dioxusand includeSTATUS_INDICATOR_CSSplus the token stylesheet once. - There is no GPUI version yet; use the Dioxus component.
- Props to set first:
text. - Keep its states and timings as they ship; restyle it through the CSS variables rather than by hand.