Measured entry

uilayouts-mesh-gradient-background3

background-effectaurora-meshmotion on file

A client-side React background that renders an animated, pointer-reactive shader blob on a full-viewport WebGL canvas. It ships as a shadcn registry component but has no shadcn UI dependency or provider. Its runtime stack is Three.js, React Three Fiber, and Drei, with TypeScript types for Three.js.

Specimen
Motion capture of the mounted demo, recorded by the harness. No audio track.
Harness screenshot of uilayouts-mesh-gradient-background3 at 375 pixels wide
Harness screenshot at 375 pixels wide. This viewport scrolled sideways.
Harness screenshot of uilayouts-mesh-gradient-background3 at 768 pixels wide
Harness screenshot at 768 pixels wide. This viewport scrolled sideways.
Harness screenshot of uilayouts-mesh-gradient-background3 at 1440 pixels wide
Harness screenshot at 1440 pixels wide. This viewport scrolled sideways.

Measured

Every value below was written by the harness on the run that produced the frames above. None of it is derived from the prose.

Harness measurements recorded for uilayouts-mesh-gradient-background3
BuildOK
MountOK
Console errors0
Uncaught page errors0
Horizontal overflowflagged at 375, 768, 1440
Axe critical0
Axe serious0
Axe moderate0
Axe minor0
Gzip marginal275.0 KB (340.4 KB build, 65.4 KB baseline)
Bare modeOK
Provider requiredNO
Demo usedwritten from the component source API

Verdict

The verified build and bare mount are sound, but this is an expensive choice for decoration alone. Use it when the shader effect is central to the page and budget time to fix the observed viewport overflow, add motion safeguards, and test lower-end devices.

Use it if

  • You need a full-screen animated hero backdrop with a fluid organic form.
  • Your React app already carries the React Three Fiber stack for other WebGL work.
  • Pointer-reactive motion is appropriate for the page and the target devices can sustain continuous rendering.

Skip it if

  • You need a lightweight decorative background without a WebGL rendering stack.
  • Horizontal overflow is unacceptable without modifying the full-viewport wrapper.
  • You need built-in reduced-motion behavior or a static fallback.
  • The component must fit inside a card or bounded section without source changes.

Install

Installation record for uilayouts-mesh-gradient-background3
Declared dependenciesthree, @types/three, @react-three/fiber, @react-three/drei
Missing on installnone
Bare installbuilds and mounts without the shadcn-style helpers
Providerno provider required in the harness

Install Three.js, its TypeScript types, React Three Fiber, and Drei. Copy the component into a client-rendered React module, preserve the client directive where applicable, and provide Tailwind utilities or equivalent CSS for the full-viewport wrapper. No shadcn provider or import alias is required.

Source and credit

This page is a review, not a copy. The component source lives with its author and this site does not republish it. Read the license before you use anything.

License
MIT
Record published
2026-08-14

Alternatives

Other published entries for the background-effect pattern, ordered by what they measured: mounts first, then clean axe scans, then bare-mode passes, then the smaller bundle.