Skip to content

Text & motionLumen Halo

Text RevealProv1.0.0

A heading or a line of copy that settles in the first time it scrolls into view: words, or the lines they wrap into, rise a little out of a soft blur, once, and then it's just text.

Built on shadcn/ui

.md
pnpm dlx shadcn@latest add @beautiful-ui-pro/lumen-text-reveal

Needs your registry key. Your components.json style picks the Base UI or Radix build: radix-*, new-york and default get Radix, base-* gets Base UI.

Styles didn't apply?

The CLI adds the styles to the CSS file named in components.json (tailwind.css). Check that it points at your global stylesheet, that the project uses Tailwind CSS v4, and that the file is imported in your root layout. Installed by hand: paste styles.css into that file.

Set up the Beautiful UI registry

Free pieces install from their URL with no setup (that URL gives the Base UI build; Radix projects use /r/radix-nova/<name>.json, or add the registries below and the CLI picks your build). Pro pieces need the registries below and BEAUTIFUL_UI_TOKEN in .env.local.

components.json
{
  "registries": {
    "@beautiful-ui": "https://beautiful-ui.dev/r/{style}/{name}.json",
    "@beautiful-ui-pro": {
      "url": "https://beautiful-ui.dev/r/pro/{style}/{name}.json",
      "headers": { "Authorization": "Bearer ${BEAUTIFUL_UI_TOKEN}" }
    }
  }
}

MCP server

claude mcp add --transport http beautiful-ui https://beautiful-ui.dev/api/mcp
Catalog for agents: /llms.txt

Usage

Import it and pass your content. The props that matter most are listed next.

Example
import { TextReveal } from "@/components/ui/lumen/controls/text-reveal";

export function SectionHeading() {
  return (
    <TextReveal as="h2" className="text-3xl font-semibold tracking-tight">
      Every number on one page, and the reason it moved.
    </TextReveal>
  );
}

Props

  • children–

    string

    The text: a string, so it can be split into words.

  • as"p"

    "p" | "h1" | "h2" | "h3" | "h4" | "span" | "div"

    The element.

  • by"word"

    "word" | "line"

    Word by word, or line by line as the text wraps at its width.

  • stagger / delay0.04 or 0.1 / 0

    number

    Seconds between words or lines, and before the first.

  • amount0.35

    number

    How much must be in view before it starts.

  • motion"full"

    "full" | "subtle" | "off"

    full: rise out of a blur; subtle: a fade; off: no reveal. Reduced motion is off.

Source

components/ui/lumen/controls/text-reveal.tsx

This component is included with Pro.

Try the live preview above. Get Pro to install the source.