Staggered Text Reveal

Installation

pnpm dlx shadcn@latest add @cleverui/text-reveal-stagger

Requires the @cleverui registry in your components.json, a one-off, two-line setup.

Usage

tsx

import { TextRevealStagger } from '@/components/ui/text-reveal-stagger'

Exampletsx

import { TextRevealStagger } from '@/components/ui/text-reveal-stagger'

export default function TextRevealStaggerDemo() {
  return (
    <div className="mx-auto flex min-h-[480px] max-w-3xl flex-col justify-center gap-12 px-6 py-24">
      <div>
        <p className="mb-4 font-mono text-[11px] uppercase tracking-[0.2em] text-muted-foreground">
          split by word
        </p>
        <TextRevealStagger
          as="h1"
          text="Every pixel earns its place."
          className="text-4xl sm:text-5xl"
        />
      </div>
      <div>
        <p className="mb-4 font-mono text-[11px] uppercase tracking-[0.2em] text-muted-foreground">
          split by character
        </p>
        <TextRevealStagger as="h2" splitBy="char" text="Precision, revealed." delay={0.4} />
      </div>
    </div>
  )
}

API reference

TextRevealStagger accepts the following props.

Prop	Type	Default	Description
`text`*	`string`	–	–
`as`	`'h1' \| 'h2' \| 'h3' \| 'p' \| 'span'`	`'h2'`	rendered element, keep heading levels semantic in context
`splitBy`	`'word' \| 'char'`	`'word'`	split granularity; words read better for sentences, chars for short display lines
`delay`	`number`	`0`	seconds before the sequence starts

…plus everything from React.HTMLAttributes<HTMLElement>: className, event handlers, aria attributes and the rest pass straight through.

Related components

Weight Emphasis

A sentence that makes its point through mass, up to three emphasis words set heavier in primary ink, revealed last in the stagger. Rhythm through weight, not color spam.

Baseline Wave

A wave travels the baseline once, characters lift and settle as it passes, like a breeze crossing the line. One pass, then stillness.

Blur Focus

Words rack into focus one after another, a camera pulling the sentence sharp. Blur, opacity and a breath of letter-spacing resolve in reading order.

Split Slide

Multi-line text where alternating lines slide out of their masks from opposite edges with a skew that straightens on landing, editorial title-card energy.

Annotate Callouts

Inline annotation system, marked phrases carry numbered mono superscripts wired to margin notes that reveal as each mark scrolls into view. Editorial footnotes, live on the page.

Line Echo

A display line trailed by two faint offset echoes of itself that converge into one crisp line on view, print misregistration settling into register. One pass, then stillness.

Frequently asked questions

How do I install the Staggered Text Reveal component?

Register the @cleverui registry in your components.json ("@cleverui": "https://cleverops.com.au/r/{name}.json"), then run `npx shadcn@latest add @cleverui/text-reveal-stagger`. The shadcn CLI copies the source into your project, you own the code from that point. You can also copy the source directly from this page.

What dependencies does Staggered Text Reveal require?

Staggered Text Reveal uses motion on top of React and Tailwind CSS. You don't need to install it manually, the shadcn CLI resolves and installs npm dependencies automatically when you add the component.

Can I theme Staggered Text Reveal to match my brand?

Yes. The component is styled entirely with Tailwind utilities over standard design tokens (primary, background, muted, border), so it inherits your existing shadcn/ui theme automatically. Change your CSS variables and the component follows, no source edits needed for palette, radius, or fonts.

Preview & code