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-labelThe 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
- 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.
oxyn add shimmer-labelUsage
The preview is free. Pro opens the code of every Pro component, screen and template.
Examples
Sweep
A calm band across the words.
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Labels
A changed label rises in.
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Paused
Inactive: muted text, no sweep.
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
API reference
SweepText
| Prop | Type | Default | Description |
|---|---|---|---|
textrequired | String | — | Label. |
active | bool | true | Sweep while work goes on. |
duration_ms | u32 | 1800 | One pass, ms. |
Read from the Rust signature and doc comments.
Keyboard interactions
| Key | Action |
|---|---|
| — | 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
SweepTextfromoxyn_dioxusand includeSTATUS_INDICATOR_CSSplus the token stylesheet once. - A GPUI version exists:
ShimmerElinoxyn_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.