Annotate Callouts

Installation

pnpm dlx shadcn@latest add @cleverui/text-annotate-callouts

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

Usage

tsx

import { TextAnnotateCallouts } from '@/components/ui/text-annotate-callouts'

Exampletsx

import { TextAnnotateCallouts } from '@/components/ui/text-annotate-callouts'

export default function TextAnnotateCalloutsDemo() {
  return (
    <div className="mx-auto flex min-h-[520px] max-w-5xl flex-col justify-center px-4 py-16 sm:px-6 sm:py-24">
      <TextAnnotateCallouts
        notesLabel="Field notes"
        text="Meridian ships a drafting table for product teams, every surface is measured, every accent is earned. Review cycles close in hours, not weeks, because the proof lives next to the claim. The result is a library that reads like it was drawn, not decorated."
        annotations={[
          {
            phrase: 'drafting table',
            note: 'Structural layout primitives, rules, ticks, and mono labels, not glass cards.',
          },
          {
            phrase: 'accent is earned',
            note: 'One primary moment per viewport. Gold as spot color, never as decoration.',
          },
          {
            phrase: 'proof lives next to the claim',
            note: 'Margin apparatus mirrors editorial footnotes: numbered, wired, scroll-timed.',
          },
        ]}
      />
    </div>
  )
}

API reference

TextAnnotateCallouts accepts the following props.

Prop	Type	Default	Description
`text`*	`string`	–	the passage, keep to 2-4 sentences
`annotations`*	`TextAnnotateCalloutsAnnotation[]`	–	1-4 entries; each phrase must be an exact substring of text, notes ≤ 90 chars
`notesLabel`	`string`	`'Notes'`	mono micro-label heading the margin column
`delay`	`number`	`0`	seconds before the first mark sequence starts

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

Referenced types

Typestsx

export interface TextAnnotateCalloutsAnnotation {
  phrase: string
  note: string
}

Related components

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.

Kinetic Type Wall

Editorial kinetic type wall for React, outline echoes of the headline drift in alternating directions while one inked row carries the accent word. Tailwind-token themed; hover eases it to a halt.

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.

Marker Highlight

A marker swipe draws itself behind the key phrase when it scrolls into view, hand-drawn energy with drafting-table restraint, SVG-stroked in the accent ink.

Mono Caption Pair

A display statement locked to its mono caption, the caption types on only after the display settles, caret in primary ink. The library's two voices bound into one component.

Frequently asked questions

How do I install the Annotate Callouts 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-annotate-callouts`. 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 Annotate Callouts require?

Annotate Callouts 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 Annotate Callouts 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