Guilloche Engine

Installation

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

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

Usage

tsx

import { BgGuilloche } from '@/components/ui/bg-guilloche'

Exampletsx

import { BgGuilloche } from '@/components/ui/bg-guilloche'

export default function BgGuillocheDemo() {
  return (
    <div className="relative min-h-[600px] overflow-hidden">
      <BgGuilloche />
      <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 · security engraving
        </p>
        <h2 className="mt-4 text-4xl font-semibold tracking-tight text-balance sm:text-6xl">
          The plate precesses.
        </h2>
      </div>
    </div>
  )
}

API reference

BgGuilloche accepts the following props.

Prop	Type	Default	Description
`layers`	`number`	`3`	rosette layers, clamped 2-4
`speed`	`number`	`1`	precession speed multiplier

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

Related components

Meander Belt

A river reworks its floodplain, curvature-driven bank migration, neck cutoffs, oxbow lakes drying to scars. Geomorphology as a live React SVG background on Tailwind design tokens.

Moire Veil

Two hairline gratings drift over each other, breeding large moire interference fringes from pixel-scale motion. A pure CSS/SVG React background themed by Tailwind design tokens.

Seismograph Drum

A strip-chart seismograph, ruled paper scrolls beneath fixed pens while seeded events swell in primary with mono magnitude stamps. Hybrid SVG and CSS React background on Tailwind tokens.

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.

Crosshatch Drift

Engraver's cross-hatching as weather, drifting lobes of ruled shading build chiaroscuro where they overlap. CSS-only React background on Tailwind tokens, zero per-frame JavaScript.

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.

Frequently asked questions

How do I install the Guilloche Engine 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-guilloche`. 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 Guilloche Engine require?

Guilloche Engine 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 Guilloche Engine 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