Measured entry

uilayouts-mesh-shadergradient

background-effectaurora-meshmotion on file

A client-side animated mesh background built from ShaderGradientCanvas and ShaderGradient. It ships as a shadcn registry component, fills the viewport through Tailwind classes, and depends on @shadergradient/react for the rendered sphere, camera, lighting, grain, and motion.

Specimen
Motion capture of the mounted demo, recorded by the harness. No audio track.
Harness screenshot of uilayouts-mesh-shadergradient at 375 pixels wide
Harness screenshot at 375 pixels wide. This viewport scrolled sideways.
Harness screenshot of uilayouts-mesh-shadergradient at 768 pixels wide
Harness screenshot at 768 pixels wide. This viewport scrolled sideways.
Harness screenshot of uilayouts-mesh-shadergradient 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-shadergradient
BuildOK
MountOK
Console errors0
Uncaught page errors0
Horizontal overflowflagged at 375, 768, 1440
Axe critical0
Axe serious0
Axe moderate0
Axe minor0
Gzip marginal297.4 KB (362.8 KB build, 65.4 KB baseline)
Bare modeOK
Provider requiredNO
Demo usedwritten from the component source API

Verdict

It builds and mounts cleanly without a provider, and the shader delivers a distinctive dark, grainy color field. Still, its viewport-sized wrapper overflows every tested layout and the dependency is costly, so it fits selective hero use better than a default site background.

Use it if

  • You need a cinematic animated backdrop for a hero or campaign page.
  • Your app already accepts client-rendered WebGL effects and their runtime cost.
  • You can place foreground content in a separate layer and tune the shader colors to the page.

Skip it if

  • You need a contained background that must not overflow its section or viewport.
  • Your bundle budget cannot absorb a large shader dependency.
  • You need built-in reduced-motion behavior or a static fallback.
  • Your audience commonly uses devices or browsers where WebGL effects are unreliable.

Install

Installation record for uilayouts-mesh-shadergradient
Declared dependencies@shadergradient/react
Missing on installnone
Bare installbuilds and mounts without the shadcn-style helpers
Providerno provider required in the harness

In a non-shadcn project, install @shadergradient/react, copy the client component, and provide Tailwind utilities or equivalent styles for its viewport wrapper. Add overflow containment, a reduced-motion or static fallback, and ensure the component renders only on the client where WebGL is available.

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.