Skip to content
Back

Text shimmerPro

Ongoing work shown as a calm band of light across the words while active, one pass per duration with a pause between passes; a changed label rises in.

oxyn add shimmer-label
Reading the repository
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

  • Ongoing work as a calm band in the current text colour sweeping over a muted base while active, one pass per duration_ms with a pause between passes (the CSS animation pauses and resumes in place); a changed label rises in with a soft blur.
  • Complements the engine-driven TextShimmer (agent states, stall).

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 shimmer 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 shimmer-label

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

Sweep

A calm band across the words.

Reading the repository
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

Labels

A changed label rises in.

Reading the repository
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

Paused

Inactive: muted text, no sweep.

Reading the repository
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

SweepText

PropTypeDefaultDescription
textrequiredString—Label.
activebooltrueSweep while work goes on.
duration_msu321800One pass, ms.

Read from the Rust signature and doc comments.

Keyboard interactions

KeyAction
—Not interactive

Accessibility

  • Plain text; the sweep is decoration.
From the spec
  • Plain text.

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

  • Inline.
Edge cases (spec)
  • Inline.

Notes for AI

  • Import SweepText from oxyn_dioxus and include STATUS_INDICATOR_CSS plus the token stylesheet once.
  • A GPUI version exists: ShimmerEl in oxyn_gpui.
  • Props to set first: text.
  • It reads a clock (now) for live timers; pass one clock for the whole page rather than one per component.
  • 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