For the complete documentation index, see llms.txt. Markdown variants are available by appending .md to any URL or sending an Accept: text/markdown header. The dithercn agent skill, for building any dither on the engine, is at /.well-known/agent-skills/dithercn/SKILL.md.
dithercn

Catalog

Every example component built on the dithercn engine, grouped by what it's for.

Each component installs as plain source into components/dithercn/. Drop one into your page as it is, read its source to see how it's made, or point your agent at one and ask for a variation. For anything not here, ask your agent or write your own.

Using an example

Install any example by its registry URL. It brings the engine with it the first time:

$ pnpm dlx shadcn@latest add https://dithercn.dev/r/dither-gradient.json

Backgrounds fill the box you give them. Put one behind your content with absolute inset-0:

import { DitherGradient } from "@/components/dithercn/dither-gradient";
 
export function Hero() {
  return (
    <section className="relative isolate min-h-[480px]">
      <DitherGradient angle={160} className="absolute inset-0 -z-10" />
      <h1>Your headline</h1>
    </section>
  );
}

Backgrounds built on DitherShader share these props:

PropWhat it controlsDefault
matrixThe threshold pattern: "bayer2", "bayer4", "bayer8" or "blue-noise"Varies by component
levelsHow many tones to snap to before ditheringEvery tone the matrix can draw
cellCell size in CSS pixels--dither-cell
paletteColours from paper to ink, two or more--dither-paper, --dither-ink
animateWhether it movestrue
speedHow fast it moves1

Charts and interface pieces take a color from the named palette and a fill of "gradient", "dotted", "hatched" or "solid". Each page lists every prop.