Skip to content

background · WebGL

NoiseField

A slow, living backdrop for a hero, drawn on the GPU, with a still poster where motion is off.

WebGL2 domain-warped noise hero background

  • WebGL
  • Reduced motion: static
  • 2.76 KB gzip
  • 1 WebGL context
  • Layout shift 0.0017
View the source Spec sheet as Markdown

Install

Install
pnpm dlx shadcn@4.21.1 add @frictionborn/noise-field

Playground

Palette
Your code
import { NoiseField } from "@/components/ui/noise-field";

<NoiseField />

In a full example

The full example loads as you scroll to it.

Accessibility

  • The poster, scrim and canvas layers are aria-hidden; the root element and children are not. There is no built-in pause button: pause with the paused prop or the runtime pauseAll()/resumeAll(). The scrim lowers background luminance behind children but contrast is not computed; verify text contrast for your colours.
  • Keyboard: None; the component has no interactive elements. Poster, scrim and canvas layers are aria-hidden; children keep their own semantics.
  • Touch: No touch listeners. Coarse pointers with low-end hints get the tier 1 poster; other coarse-pointer devices run WebGL at tier 2.
  • WCAG criteria it is built for: 2.2.2, 2.3.1

Props

PropTypeDefaultWhat it does
colors[string, string, string]["var(--background, Canvas)","var(--primary, CanvasText)","var(--accent, GrayText)"]Three CSS colours: background, primary, accent. Resolved to RGB for the shader and used to build the CSS poster.
speednumber1Multiplier on animation time.
scalenumber1.8Domain frequency scale for the procedural noise octaves.
intensitynumber1Colour vibrancy and octave blending contrast.
scrimbooleantrueRenders a radial scrim of the first colour (25% centre to 80% edge opacity) over the canvas to lower background luminance behind children. Does not guarantee text contrast; verify for your colours.
pausedbooleanfalseFreezes this instance's animation loop. The global pauseAll() also stops it.
timenumbernoneOptional. No default. Overrides the internal clock with a fixed time value (deterministic screenshots and tests).
maxTiernumber3Hard ceiling on the capability tier (0 to 3); the tier is the minimum of this and the runtime tier.
reducedMotionbooleannoneOptional. No default (follows prefers-reduced-motion). true forces the static poster. false only skips the prop-level check: under prefers-reduced-motion the runtime tier is still 0, so WebGL still does not start. Leave unset.
classNamestring""Extra classes on the root div, appended after the built-in Tailwind utility classes.
styleReact.CSSPropertiesnoneOptional. No default. Inline styles on the root div, merged after the built-in background colour (consumer wins).
refReact.Ref<HTMLDivElement>noneReceives the root <div> that holds the poster and the canvas.
childrenReact.ReactNodenoneOptional. No default. Content layered above the poster, canvas and scrim.
palette"fire" | "ice" | "neon" | "mono" | "custom"noneColours from a palette (DESIGN.md A8): fire, ice, neon, mono, or custom (reads --fb-heat-0..4). Overrides colors; leave it out to keep the host's tokens.

Measured on the bench

Measured by the automated bench at commit 801163e on 2026-10-21. These numbers are written by the bench, never by hand.

MeasureResult
Size, gzip2.76 KB at load, 3.45 KB loaded later
Layout shift0.0017
Frames when nothing should moveoff screen 0, hidden tab 0, reduced motion 0
axe accessibility scan0 serious, 0 critical

Browsers it ran in

Automated Playwright runs, some with device emulation. Results from physical phones and tablets are still pending, so none are listed.

EnvironmentTierResultDateNotes
Chromium Desktop (SwiftShader)3pass2026-10-2123 passed, 0 failed
Chromium Mobile (Pixel 7 emulation)2pass2026-10-2122 passed, 0 failed
Firefox Desktop3pass2026-10-2120 passed, 0 failed
WebKit Desktop3pass2026-10-2120 passed, 0 failed
WebKit Mobile (iPhone 14 emulation)2pass2026-10-2120 passed, 0 failed

On different devices

Reduced motion (static): Renders the static CSS gradient poster with no WebGL context and no animation frames. Under prefers-reduced-motion the runtime tier is 0, so WebGL does not start.

TierWhat it does
T3 FullWebGL2 at DPR <= 2.0, full render scale, 4 octaves (fine pointer with hover, no low-end hints)
T2 StandardWebGL2 at DPR <= 1.5, 0.75 render scale, 2 octaves (coarse pointer without low-end hints, or fine pointer with low-end hints or viewport < 480px)
T1 LiteCSS gradient poster only (coarse pointer with low-end hints: deviceMemory <= 2 or <= 4 cores)
T0 StaticCSS gradient poster only, no WebGL (server render, prefers-reduced-motion, Save-Data, no WebGL2, or frame-guard downgrade)

Content Security Policy

  • Works without 'unsafe-eval'.
  • Needs no reveal gate.
  • Sets inline style attributes, so allow style-src-attr 'unsafe-inline'.

Goes well with