Skip to main content
Clever Ops

Pointer Galvanometer

A docked galvanometer meters the pointer, a ballistic needle kicks across a graduated arc with cursor speed, a primary peak-hold tick decays behind it. React + Tailwind tokens.

Preview & code

Loading Pointer Galvanometer preview

Installation

pnpm dlx shadcn@latest add @cleverui/cursor-galvanometer

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

Usage

tsx
import { CursorGalvanometer } from '@/components/ui/cursor-galvanometer'
Exampletsx
import { CursorGalvanometer } from '@/components/ui/cursor-galvanometer'

export default function CursorGalvanometerDemo() {
  return (
    <div className="relative min-h-[560px] overflow-hidden">
      <CursorGalvanometer corner="bottom-right" fullScale={2400} peakHold />
      <div className="pointer-events-none relative mx-auto flex min-h-[560px] max-w-3xl flex-col items-center justify-center px-6 py-24 text-center">
        <p className="font-mono text-[11px] uppercase tracking-[0.2em] text-muted-foreground sm:text-xs">
          Spectacle · ballistic needle
        </p>
        <h2 className="mt-4 text-4xl font-semibold tracking-tight text-balance sm:text-5xl">
          Meter the hand.
        </h2>
        <p className="mt-4 max-w-md text-sm leading-relaxed text-muted-foreground">
          A docked galvanometer reads pointer velocity in px/s, soft-knee scale, peak-hold tick,
          and a weighted fall back to zero when you rest.
        </p>
      </div>
    </div>
  )
}

API reference

CursorGalvanometer accepts the following props.

PropTypeDefaultDescription
corner'bottom-right' | 'bottom-left' | 'top-right' | 'top-left''bottom-right'viewport corner the meter docks in
fullScalenumber2400pointer speed in px/s that pegs the needle
peakHoldbooleantrueshow the decaying peak-hold tick

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

Frequently asked questions

How do I install the Pointer Galvanometer component?

Register the @cleverui registry in your components.json ("@cleverui": "https://cleverops.com.au/r/{name}.json"), then run `npx shadcn@latest add @cleverui/cursor-galvanometer`. 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 Pointer Galvanometer require?

Pointer Galvanometer 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 Pointer Galvanometer 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.

Want this built for you?

CleverUI is built by the Clever Ops web team. If you'd rather ship a hand-coded, fast, custom website than assemble one, we build them for Australian businesses every week.

Explore web development services