Grain Gradient

A grainy, out-of-focus blend of saturated colour, like a long-exposure photo. The grain is rendered per pixel, so it stays sharp at any size.

Made for launch day

grain-gradient-demo.tsx

import { GrainGradient } from "@/components/grain-gradient";

export function GrainGradientDemo() {
  return (
    <GrainGradient className="flex h-[360px] items-end p-8">
      <h2 className="text-3xl font-semibold tracking-tight text-white">
        Made for launch day
      </h2>
    </GrainGradient>
  );
}

Installation

pnpm dlx shadcn@latest add https://gradients.sh/r/grain-gradient.json

Usage

import { GrainGradient } from "@/components/grain-gradient";

<GrainGradient className="h-[480px]">{children}</GrainGradient>;

The gradient fills its box, so give it a height. Children render on top.

Props

Prop	Type	Default
`children` Content layered on top of the gradient.	`ReactNode`	`—`
`colors` Two to six colours: hex, oklch(), names or var(--token).	`[string, string, ...string[]]`	`["#ffd8b4", "#e0703b", "#8a2c1d", "#2b1015"]`
`background` Base colour under the gradient.	`string`	`"#070505"`
`speed` 0 to 2. How fast the gradient moves. 0 holds it still.	`number`	`0.6`
`loopSeconds` 4 to 30. The animation repeats exactly every loopSeconds.	`number`	`16`
`scale` 0.25 to 4. Noise frequency: higher means smaller shapes.	`number`	`1`
`warp` 0 to 1. Domain-warp strength.	`number`	`0.55`
`grain` 0 to 1. Film grain.	`number`	`0.5`
`blur` 0 to 1. Softness.	`number`	`0.55`
`seed` Integer seed for the noise field.	`number`	`7`
`dither` Ordered 4×4 Bayer dither.	`{ enabled?: boolean; cell?: number; levels?: number }`	`{ enabled: false, cell: 3, levels: 8 }`
`interaction` 0 to 1 influence of the pointer and of scroll velocity.	`{ pointer?: number; scroll?: number }`	`{ pointer: 0.25, scroll: 0.15 }`
`maxDpr` Device pixel ratio cap for the canvas.	`number`	`1.5`
`reducedMotion` "respect" shows one still frame when the user prefers reduced motion.	`"respect" \| "ignore"`	`"respect"`
`className` Classes for the outer element. Size it here; the gradient fills it.	`string`	`—`