Skip to content
Beautiful UI

Text & motionLumen Halo

Text ShimmerFreev1.0.0

Work in progress, said in text: a narrow band of light passes across muted words, slow enough to read as waiting, and the words settle to full ink when the work is done.

Built on shadcn/ui

.md
Base UIpnpm dlx shadcn@latest add https://beautiful-ui.dev/r/lumen-text-shimmer.json
Radixpnpm dlx shadcn@latest add https://beautiful-ui.dev/r/radix-nova/lumen-text-shimmer.json

Free, no account or key. Use the command for your project's primitives: a radix-*, new-york or default style in components.json is Radix, a base-* style is Base UI. With the @beautiful-ui registry added, @beautiful-ui/<name> picks for you.

Install by hand
  1. 1. No extra packages: React and Tailwind CSS v4 are enough.
  2. 2. Copy the files to these paths (Source below, or save them all as a .zip)
    • components/ui/lumen/controls/text-shimmer.tsx
  3. 3. Paste styles.css into your global CSS, after @import "tailwindcss";
  4. 4. Install what it builds on first: shadcn's cn helper (lib/utils.ts, from npx shadcn init), the theme foundation (its tokens and base styles)
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
Working

Usage

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

Example
"use client";

import { TextShimmer } from "@/components/ui/lumen/controls/text-shimmer";

export function JobStatus({ running }: { running: boolean }) {
  return (
    <p role="status">
      <TextShimmer active={running}>{running ? "Summarising 24 support tickets…" : "Summary ready"}</TextShimmer>
    </p>
  );
}

Props

  • activetrue

    boolean

    Sweeping while true; false settles the text to full ink.

  • duration2

    number

    Seconds per sweep.

  • as"span"

    "span" | "p" | "div"

    The element.

Source

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

122 more Pro pieces in Lumen HaloEvery story chart, block and screen in the same language. Previews are live for everyone; the code comes with Pro.See the plans

More in Text & motion