Skip to content

AI interfacesLumen Halo

ReasoningProv1.0.0

What a model did before it answered, kept to one quiet line: Thinking with a running clock while it works, its steps open to watch them land, then Thought for 12s with the steps folded away. Each step is waiting, working, done or failed.

Built on shadcn/ui

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

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
Play it

Usage

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

Example
"use client";

import { Reasoning, type ReasoningStep } from "@/components/ui/lumen/controls/reasoning";

export function ReplyThinking({ steps, thinking, startedAt }: { steps: ReasoningStep[]; thinking: boolean; startedAt: number }) {
  return <Reasoning steps={steps} thinking={thinking} startedAt={startedAt} />;
}

// Steps as your model reports them:
export const example: ReasoningStep[] = [
  { id: "read", label: "Read the March invoices", detail: "212 invoices, 3 currencies", status: "done" },
  { id: "match", label: "Match payments to invoices", status: "active" },
  { id: "flag", label: "Flag anything unpaid after 30 days", status: "pending" },
];

Props

  • steps–

    ReasoningStep[]

    { id, label, detail?, status?: pending | active | done | error }.

  • thinkingfalse

    boolean

    Still at work: the line reads Thinking, shimmers and runs a clock.

  • startedAt / duration–

    number (epoch ms) / number (ms)

    For the clock and for Thought for …; both are measured here when omitted.

  • open / defaultOpen / onOpenChange–

    boolean

    Uncontrolled: open while thinking, folded when done, unless the reader chose.

  • children–

    ReactNode

    Free-form reasoning text after the steps.

  • labels–

    Partial<ReasoningLabels>

    thinking, thought(duration), done, steps(n), status words: for other languages.

Source

components/ui/lumen/controls/reasoning.tsx

This component is included with Pro.

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