Skip to content
Back

Skeleton revealPro

Loading skeletons that grow into the real content block by block: each placeholder stretches to the content's box while it fades and the content sharpens out of a blur.

oxyn add skeleton-reveal
AT
Atlas · run 248
refactor/auth-refresh · 4 min

Added a single-flight lock around refresh() so two tabs share one request, and a retry for the call that waited. 148 tests pass.

Toggle Loading to watch blocks resolve one after another.

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

  • A card or panel whose content arrives a moment later: the skeleton should already be the shape of the content, then become it block by block instead of swapping all at once.

When not to use

  • Grey shapes the size of what they stand in for, one sheen sweeping across all of them in step (or a staggered pulse), shown only after a short delay, then a crossfade into the content: use Skeleton instead.
  • Fourteen text-glyph loaders (braille, sand, blocks, scanner…) that settle into a check, a warning or a cross when the agent finishes, waits or fails: use Glyph loader instead.
  • A dot and a label for any of the 13 agent states, as a pill, inline or a dot alone: use Status indicator instead.

Installation

Skeleton 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 skeleton-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

Resolve

Blocks resolving in order.

AT
Atlas · run 248
refactor/auth-refresh · 4 min

Added a single-flight lock around refresh() so two tabs share one request, and a retry for the call that waited. 148 tests pass.

Toggle Loading to watch blocks resolve one after another.

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

Loading

Size-matched skeletons.

Loading

Toggle Loading to watch blocks resolve one after another.

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

Fast

A 40 ms stagger, no chart.

AT
Atlas · run 248
refactor/auth-refresh · 4 min

Added a single-flight lock around refresh() so two tabs share one request, and a retry for the call that waited. 148 tests pass.

Toggle Loading to watch blocks resolve one after another.

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

SkeletonReveal

PropTypeDefaultDescription
loadingrequiredbool—Loading.
staggeru3240Ms between blocks (40).
loading_labelString"Loading"Status read while loading.
widthf32340.0Width px.
childrenrequiredElement—`MorphBlock`s and layout.

MorphBlock

PropTypeDefaultDescription
indexrequiredusize—Order in the reveal.
widthString"100%"Skeleton width (`100%`, `64px`).
heightf3212.0Skeleton height px (or the lines' height).
radiusString"6"Corner radius px; `circle` for an avatar.
linesOption<usize>Default::default()Text lines (each a bar in its line box; the last of several is shorter).
line_heightf3220.0Line height px.
classStringDefault::default()Extra class.
childrenElementDefault::default()The loaded content.

Read from the Rust signature and doc comments.

Accessibility

  • aria-busy with a hidden status while loading; content isn't rendered until ready, so nothing half-loaded is read.
  • Blocks keep reading order.
From the spec

While loading the region is aria-busy with a hidden status; content is not rendered until ready, so nothing half-loaded is announced. Reduced motion fades without stretching or blur.

Motion & interaction

Each placeholder stretches to the real content's box and fades while the content sharpens out of a 4 px blur; blocks start stagger apart in reading order (avatar, title, meta, body, chart, buttons).

Timing
TransitionDurationEasingReduced motion
Block morph300 msease.out120 ms fade, no blur
Stagger40 ms (Arc)—0
Back to loadinginstant—instant

Responsive behaviour

  • Blocks size to their content once loaded; skeleton widths take percentages.
Edge cases (spec)

Blocks that load faster than the stagger still wait their turn. Text blocks set their line count; the last of several lines is shorter. Very long content grows the card after the morph.

Notes for AI

  • Import SkeletonReveal, MorphBlock from oxyn_dioxus and include PRIMITIVES_CSS plus the token stylesheet once.
  • A GPUI version exists: SkeletonRevealEl in oxyn_gpui.
  • Props to set first: loading, children, index.
  • 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