Measured entry
ruixen-cloud-background
A client-side React canvas that renders flowing cloud bands with an OGL WebGL shader and continuously updates them with an animation loop. It ships as a shadcn registry component, uses utility classes through the cn helper, watches its parent for size changes, and accepts explicit theme and render-quality props.



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.
| Build | OK |
|---|---|
| Mount | OK |
| Console errors | 0 |
| Uncaught page errors | 0 |
| Horizontal overflow | clean at 375, 768, 1440 |
| Axe critical | 0 |
| Axe serious | 0 |
| Axe moderate | 0 |
| Axe minor | 0 |
| Gzip marginal | 41.0 KB (106.4 KB build, 65.4 KB baseline) |
| Bare mode | FAIL |
| Provider required | NO |
| Demo used | written from the component source API |
What the harness recorded
BARE BUILD
✗ Build failed in 40.31s error during build: [vite:load-fallback] Could not load <sandbox>/src/lib/utils (imported by src/cut/cloud-background.tsx): ENOENT: no such file or directory, open '<sandbox>/src/lib/utils'
Verdict
A credible drop-in for shader-backed atmosphere, with clean mounting and responsive sizing in the prepared harness. It needs a shadcn-style setup because the bare project cannot resolve its shared utility import. Budget for the OGL dependency and add your own motion fallback.
Use it if
- You want an ambient full-bleed backdrop behind readable page or hero content.
- Your React app already has WebGL-capable clients and can accommodate a continuous render loop.
- You need a decorative canvas that can switch between an explicitly supplied light or dark treatment.
Skip it if
- You need a static background with minimal runtime work or no GPU dependency.
- Your layout cannot provide a positioned parent with a definite rendered height.
- You require built-in reduced-motion handling or automatic theme detection.
- You need the effect to remain meaningful when WebGL is unavailable.
Install
| Declared dependencies | ogl |
|---|---|
| Missing on install | none |
| Bare install | fails once the shadcn-style helpers are removed, so it needs that setup |
| Provider | no provider required in the harness |
In a non-shadcn project, install OGL, provide a cn class-merging helper at the expected utility alias or replace that import, and ensure the utility classes are available. Render it inside a positioned container with an explicit height, and add reduced-motion and WebGL fallback behavior if your product requires them.
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.
Author repository
github.com/ruixenui/ruixen.comAlternatives
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.
- ruixen-loading-circlegradient-glow
- Renders
- YES
- A11y
- 0
- Gzip
- 17.7KB
- Bare
- pass
- Prov
- NO
- eldora-hacker-backgrounddark-futuristic
- Renders
- YES
- A11y
- 0
- Gzip
- 17.8KB
- Bare
- pass
- Prov
- NO
- ruixen-ripple-circlesgradient-glow
- Renders
- YES
- A11y
- 0
- Gzip
- 17.9KB
- Bare
- pass
- Prov
- NO
- ruixen-dual-tone-rain-backgroundunclassified
- Renders
- YES
- A11y
- 0
- Gzip
- 18.4KB
- Bare
- pass
- Prov
- NO
- cultui-lightboardliquid-glass
- Renders
- YES
- A11y
- 0
- Gzip
- 19.6KB
- Bare
- pass
- Prov
- NO
- ruixen-mouse-sparkunclassified
- Renders
- YES
- A11y
- 0
- Gzip
- 20.6KB
- Bare
- pass
- Prov
- NO