Goo Cursor Trail

Installation

pnpm dlx shadcn@latest add @cleverui/cursor-goo-trail

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

Usage

tsx

import { CursorGooTrail } from '@/components/ui/cursor-goo-trail'

Exampletsx

import { CursorGooTrail } from '@/components/ui/cursor-goo-trail'

export default function CursorGooTrailDemo() {
  return (
    <div className="relative min-h-[560px] overflow-hidden">
      <CursorGooTrail />
      <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 · draw with it
        </p>
        <h2 className="mt-4 text-4xl font-semibold tracking-tight text-balance sm:text-5xl">
          Ink that follows you home.
        </h2>
        <p className="mt-4 max-w-md text-sm leading-relaxed text-muted-foreground">
          Six blobs on lagging springs, one goo filter. On touch screens it becomes a lava lamp.
        </p>
      </div>
    </div>
  )
}

API reference

CursorGooTrail accepts the following props.

Prop	Type	Default	Description
`blobs`	`number`	`6`	number of blobs in the chain (3–8)
`size`	`number`	`56`	diameter of the lead blob in px

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

Related components

Glyph Wake

The pointer leaves a wake of mono glyphs, characters condense along the path, hold for a breath, and evaporate. Typography as vapor trail.

Ink Comet

The cursor tows a comet of ink, a canvas particle tail that thickens with speed, sheds droplets on hard turns, and dries to nothing when you stop.

Survey Crosshair

Full-viewport drafting crosshair, hairline axes track the pointer with mono coordinate readouts in the margins, and hovering targets snaps brackets around them.

Drafting Arm

A drafting-machine arm bolted to the viewport corner reaches the pointer, two hairline links solved by real IK, joint discs, and spring lag. React page companion on Tailwind tokens.

Echo Rings

Every click drops a stone in the page, concentric hairline rings ripple out from the point and dissolve, with a soft accent pulse at the center. Sonar for the UI.

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.

Frequently asked questions

How do I install the Goo Cursor Trail 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-goo-trail`. 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 Goo Cursor Trail require?

Goo Cursor Trail 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 Goo Cursor Trail 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