Measured entry
ruixen-ripple-distortion
A client-side React image treatment shipped as a shadcn registry component. It uses Three.js, WebGL shaders, a texture loader, and a continuous render loop to create cursor-driven ripples, while accepting dimensions and effect controls through 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 | 147.5 KB (213.0 KB build, 65.5 KB baseline) |
| Bare mode | OK |
| Provider required | NO |
| Demo used | written from the component source API |
Verdict
A focused, working effect for decorative imagery, with sensible prop controls and cleanup. Its main tradeoffs are the large Three.js dependency, continuous GPU work, mouse-only response, and lack of an accessible image fallback, so it fits selective showcase use better than routine content imagery.
Use it if
- You need a decorative hero or campaign image that reacts to pointer movement.
- Your product already uses Three.js, so the dependency cost is shared.
- You want direct control over ripple frequency, strength, and speed through React props.
Skip it if
- The image carries content that needs alt text, indexing, or a non-canvas fallback.
- Your page has a strict JavaScript or GPU budget and does not otherwise use Three.js.
- Touch, keyboard, or reduced-motion users need an equivalent interaction out of the box.
- The source image cannot be loaded as a WebGL texture because of cross-origin policy.
Install
| Declared dependencies | three |
|---|---|
| Missing on install | none |
| Bare install | builds and mounts without the shadcn-style helpers |
| Provider | no provider required in the harness |
Copy the client component into the project, install Three.js, and ensure it runs only in the browser with WebGL available. Add equivalent CSS for relative positioning and overflow clipping if Tailwind utilities are unavailable, and provide a separate accessible image or fallback when the visual conveys content.
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 image pattern, ordered by what they measured: mounts first, then clean axe scans, then bare-mode passes, then the smaller bundle.
- magicui-androidskeuomorphism
- Renders
- YES
- A11y
- 0
- Gzip
- 17.8KB
- Bare
- pass
- Prov
- NO
- magicui-iphoneskeuomorphism
- Renders
- YES
- A11y
- 0
- Gzip
- 18.5KB
- Bare
- pass
- Prov
- NO
- magicui-safariskeuomorphism
- Renders
- YES
- A11y
- 0
- Gzip
- 20.8KB
- Bare
- pass
- Prov
- NO
- kibo-image-zoomminimal-flat
- Renders
- YES
- A11y
- 0
- Gzip
- 36.6KB
- Bare
- pass
- Prov
- NO
- ruixen-scroll-tilted-gridunclassified
- Renders
- YES
- A11y
- 0
- Gzip
- 60.5KB
- Bare
- pass
- Prov
- NO
- magicui-lens3d
- Renders
- YES
- A11y
- 0
- Gzip
- 63.5KB
- Bare
- pass
- Prov
- NO