Skeleton Reveal

Overview

A skeleton that pulses while loading, then cross-fades and un-blurs into the real content.

This feedback component is intended for interfaces that need a skeleton that pulses while loading, then cross-fades and un-blurs into the real content, form workflows, and support tools. Its implementation is provided as editable source so the final behavior and styling stay inside your project.

Technologies

React

TypeScript

Tailwind CSS

No additional package dependency is declared for this component.

@spectrumui/skeleton-reveal

ACAva ChenDesign review notes — the new empty states look great

Installation

Usage

import { SkeletonReveal } from "@/components/spectrumui/skeleton-reveal"

<SkeletonReveal loading={isLoading} skeleton={<RowSkeleton />}>
  <Row user={user} />
</SkeletonReveal>

API Reference

SkeletonReveal

The Skeleton loader and reveal recipe from transitions.dev (Jakub Antalík), embedded as its namespaced t-skel CSS. The skeleton pulses while loading is true; flipping it to false cross-fades and un-blurs the content in the same slot, and flipping it back snaps to the skeleton without animating the reverse.

Prop	Type	Default	Description
*`loading`	`boolean`	-	While true the skeleton shows and pulses; false reveals the content
*`skeleton`	`ReactNode`	-	Placeholder layer, sized like the content
*`children`	`ReactNode`	-	Real content rendered in the same slot
`pulseCount`	`number`	`1`	Pulse cycles before settling
`pulseDuration`	`number`	`1000`	One pulse cycle in ms
`revealDuration`	`number`	`400`	Cross-fade duration in ms
`className`	`string`	-	Classes for the wrapper

Use cases

interfaces that need a skeleton that pulses while loading, then cross-fades and un-blurs into the real content
form workflows
support tools

Features

Copy-paste source that remains in your repository
TypeScript source included with the component
Tailwind CSS classes editable in the component source
Reduced-motion handling present in the source

Accessibility

The source includes ARIA attributes or roles; preserve them when customizing the component.
The source checks reduced-motion preferences or includes motion-reduce styles.
Test focus order, keyboard operation, labels, contrast, and screen-reader output in the final application context.

Customization

Edit the Tailwind utility classes in the copied source to match your spacing, color, and typography tokens.
Use the documented className surface for local layout adjustments, then edit the source for structural changes.

Animated Alert

An animated alert that displays notifications, warnings, and success messages.

Feedback Card

A feedback card that collects ratings and comments with emoji reactions.

Notification Bell

A bell button that swings on new notifications with a rolling unread badge.

Reaction Bar

A Slack-style emoji reaction bar with animated chips and rolling counts.

Skeleton Reveal FAQ

Is Skeleton Reveal free to use in commercial projects?

Yes. The public Skeleton Reveal source is available under the Apache License 2.0, including for commercial use, subject to the LICENSE terms.

How do I install Skeleton Reveal?

Run npx shadcn@latest add @spectrumui/skeleton-reveal. The page also exposes the source for manual installation.

Does Skeleton Reveal require Motion?

No Motion dependency was detected in the documented source or registry entry for Skeleton Reveal.

Does Skeleton Reveal use shadcn/ui or Radix UI?

No shadcn/ui or Radix UI dependency was detected in the documented Skeleton Reveal source.

Can I use Skeleton Reveal in Next.js?

The documented React source is used in this Next.js application. Keep its use client directive when copying it into the App Router. Install the detected dependencies and verify any application-specific data or image configuration.

What accessibility checks should I run for Skeleton Reveal?

The source includes ARIA markup, reduced-motion handling. Test the finished interface with keyboard and screen-reader workflows.