Skip to content
Back

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-reveal

Ship the work, keep the trail

The code is part of Oxyn Pro

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.

Get Pro

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.

Terminal
oxyn add word-reveal

Usage

Dioxus · rust
The code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

Examples

Heading

Words rise out of a clip and a blur.

Ship the work, keep the trail

Code Pro
The code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

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 code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

Chars

Letter by letter.

Ship the work, keep the trail

Code Pro
The code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

Replay

Plays again on each entry.

Ship the work, keep the trail

Code Pro
The code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

API reference

WordReveal

PropTypeDefaultDescription
textrequiredString—Text.
byString"word"`word` · `char`.
tagString"p"`h1` · `h2` · `h3` · `p` · `span`.
stagger_msu3240Between pieces, ms (total capped at 900 ms).
delay_msu32Default::default()Before the first piece, ms.
duration_msu32700Each piece, ms.
shownbooltrueIn view (host-observed).
oncebooltrueReveal only the first time.

Read from the Rust signature and doc comments.

Keyboard interactions

KeyAction
—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 WordReveal from oxyn_dioxus and include STATUS_INDICATOR_CSS plus 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.

Guides

Oxyn · 74 free components · 264 Pro components · 96 screens · 20 blocks · Dioxus and GPUI