Harmonograph

Installation

pnpm dlx shadcn@latest add @cleverui/bg-harmonograph

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

Usage

tsx

import { BgHarmonograph } from '@/components/ui/bg-harmonograph'

Exampletsx

import { BgHarmonograph } from '@/components/ui/bg-harmonograph'

export default function BgHarmonographDemo() {
  return (
    <div className="relative min-h-[600px] overflow-hidden">
      <BgHarmonograph />
      <div className="relative mx-auto flex min-h-[600px] max-w-4xl 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 · drawing machine
        </p>
        <h2 className="mt-4 text-4xl font-semibold tracking-tight text-balance sm:text-6xl">
          The pen never closes.
        </h2>
      </div>
    </div>
  )
}

API reference

BgHarmonograph accepts the following props.

Prop	Type	Default	Description
`speed`	`number`	`1`	trace speed multiplier
`ghosts`	`number`	`2`	completed figures kept on the sheet before fading

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

Related components

Chladni Sand

Thousands of sand grains snap into Chladni resonance figures as the plate's mode changes, order out of noise. React canvas background themed entirely by Tailwind tokens.

Dendrite Growth

Seeded random walkers freeze into branching mineral dendrites, an accretion frontier tipped in primary with a live particle counter. React canvas background on Tailwind tokens.

Frost Fern

Window frost grows in from the frame, anisotropic ice needles branch at 60 degrees, growth tips glowing primary before curing to ink. Seeded React canvas background on Tailwind tokens.

Galton Board

A Galton board in drafting ink, beads fall through a hairline peg lattice and build a live bell curve, one primary bead tracing its path. React canvas background on Tailwind tokens.

Glyph Tide

A field of mono glyphs breathing like liquid, character weight and ink density follow a flowing noise tide, with a current of accent glyphs threading through. Canvas, zero deps.

Halftone Pulse

A print-press halftone field, dot radii swell as slow waves travel the grid, and the pointer raises its own ripple. Ink-on-paper texture turned kinetic, canvas-drawn.

Frequently asked questions

How do I install the Harmonograph component?

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

Harmonograph has no npm dependencies beyond React and Tailwind CSS itself, so there is nothing extra to install or keep updated.

Can I theme Harmonograph 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