Split Flap

Installation

pnpm dlx shadcn@latest add @cleverui/text-split-flap

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

Usage

tsx

import { TextSplitFlap } from '@/components/ui/text-split-flap'

Exampletsx

import { TextSplitFlap } from '@/components/ui/text-split-flap'

export default function TextSplitFlapDemo() {
  return (
    <div className="relative mx-auto flex min-h-[420px] max-w-3xl flex-col items-center justify-center gap-8 overflow-hidden px-4 py-20 sm:px-6">
      <TextSplitFlap
        as="h1"
        text="GATE B12 OPEN"
        caption="DEPARTURES"
        delay={0.2}
      />
      <p className="max-w-sm text-center text-sm leading-relaxed text-muted-foreground">
        Seeded intermediate glyphs flip left to right with true fold physics, then a primary
        underline confirms the board.
      </p>
    </div>
  )
}

API reference

TextSplitFlap accepts the following props.

Prop	Type	Default	Description
`text`*	`string`	–	board message, uppercased, budget ≤ 24 chars per line
`caption`	`string`	–	mono micro-label above the board, e.g. 'DEPARTURES'
`delay`	`number`	`0.2`	–
`as`	`'h1' \| 'h2' \| 'h3' \| 'p'`	`'h2'`	heading level of the sr-only text

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

Related components

Punch Tape

A punched paper tape feeds through a reader head and your React headline prints glyph by glyph, the encoding visible in the holes. Tailwind tokens; one pass, then stillness.

Compositor's Case

Type set from a visible case, sorts fly from their compartments, land mirrored in the composing stick, and one proof pull flips the React headline readable. Tailwind-token letterpress craft.

Orbit Caption

A mono micro-caption orbits the headline on an elliptical SVG path, slow as a survey satellite, hover or focus eases the orbit to a halt so the caption can be read.

Dot Matrix Print

The headline prints as a dot-matrix raster, a carriage sweeps once and canvas dots sized by ink density pop in column by column. React and Tailwind tokens via probes; one accent word in primary.

Frottage Rubbing

A graphite rubbing over hidden relief, crayon passes sweep the sheet and the React headline surfaces where pigment catches. Canvas text effect themed by Tailwind token probes.

Ink Bleed

Letters develop like ink on wet paper, each glyph starts as a soft bleed and contracts to crisp edges, neighbouring bleeds wicking together mid-pass. One development, then stillness.

Frequently asked questions

How do I install the Split Flap 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-split-flap`. 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 Split Flap require?

Split Flap 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 Split Flap 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