Chladni Sand

Installation

pnpm dlx shadcn@latest add @cleverui/bg-chladni-sand

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

Usage

tsx

import { BgChladniSand } from '@/components/ui/bg-chladni-sand'

Exampletsx

import { BgChladniSand } from '@/components/ui/bg-chladni-sand'

export default function BgChladniSandDemo() {
  return (
    <div className="relative min-h-[600px] overflow-hidden">
      <BgChladniSand />
      <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 · resonance plate
        </p>
        <h2 className="mt-4 text-4xl font-semibold tracking-tight text-balance sm:text-6xl">
          Sand finds the nodes.
        </h2>
      </div>
    </div>
  )
}

API reference

BgChladniSand accepts the following props.

Prop	Type	Default	Description
`grains`	`number`	`2600`	sand grain budget on desktop, halved on coarse pointers
`cycle`	`number`	`9`	seconds between plate mode changes
`speed`	`number`	`1`	migration speed multiplier

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

Related components

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.

Pendulum Field

A mounting rail of hairline pendulums swinging at incommensurate periods, phase waves travel down the row, nearly align, and disperse again. One primary bob keeps the beat. Canvas, zero deps.

Flow Field

A storm of ink streams advected through an evolving flow field, one stream in seven burns in the accent, and a fine pointer bends the current around itself. Canvas, 60fps-budgeted.

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.

Frequently asked questions

How do I install the Chladni Sand 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-chladni-sand`. 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 Chladni Sand require?

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

Can I theme Chladni Sand 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