ShaderGradient
by ruucm and stone-skipper
Animated 3D WebGL gradient backgrounds (waves, spheres, planes) customized in a web editor and exported as React props; also Figma/Framer plugins.
Video references and motion backgrounds Code libraryOpen sourcegradientabstract3d
1. Price: shadergradient.co
Fully free.
shadergradient.coNo quote yet: price is read from the official pages.
2. Commercial use: raw.githubusercontent.com
“MIT © [ruucm](https://github.com/ruucm), [stone-skipper](https://github.com/stone-skipper)”
The MIT license allows use in paid products.
raw.githubusercontent.com3. Credit the author: raw.githubusercontent.com
“MIT © [ruucm](https://github.com/ruucm), [stone-skipper](https://github.com/stone-skipper)”
No credit on screen. Keep the license notice inside the code you ship.
raw.githubusercontent.com4. Agent access: github.com/ruucm/shadergradient
An agent can install it by itself with npm install @shadergradient/react. No key or account is needed.
github.com/ruucm/shadergradientLicense checked Nov 5, 2026 against 1 official page. Tap a verdict to see its source. How we checked Report an error
ShaderGradient: moving 3D color gradients for sites
ShaderGradient draws a soft, slowly moving 3D color gradient, shaped like a wavy plane, a sphere or water, as a background. You set colors and motion in its online editor, then your AI assistant pastes the settings into a React or Vue page. There are also Figma and Framer versions, and the code is free under the MIT license.
Where you can use it
Full-screen hero background in React
Put a moving gradient behind the first screen of a landing page or product site, with your text on top.
Design it by eye, paste the link
A designer tunes colors, shape and speed in the online editor and sends the link; the page reads every setting from that link.
Vue or Nuxt site background
A Vue or Nuxt site gets the same gradients without React, with a plain color shown while the page loads on the server.
Gradients in Figma and Framer
Designers add the gradient in Figma with the plugin, including as a moving GIF, or paste the component link into a Framer page.
Calm background for a pricing page Idea
Use a still frame (animation off) in soft brand colors behind pricing cards, so the page feels designed without moving parts.
Event or launch splash screen Idea
A sphere gradient in the event colors behind the date and the sign-up button on a one-day launch page.
ShaderGradient popularity
Downloads from api.npmjs.org, stars from GitHub, checked Nov 17, 2026. How the Gid Score is calculated
How to start
Tell your AI assistant
“Add a ShaderGradient background to the hero with @shadergradient/react 2.4.20 pinned and the matching @react-three/fiber for our React version; take the settings from this shadergradient.co/customize link, and keep text readable on top.”
Or install it yourself.
npm i @shadergradient/react @react-three/fiber three three-stdlib camera-controls
Show code
Tune the look in the online editor, copy its link and pass it as urlString with control='query'.
<ShaderGradient control='query' urlString='https://www.shadergradient.co/customize?...' />
Mistakes to avoid
npm i @shadergradient/react alonenpm i @shadergradient/react @react-three/fiber three three-stdlib camera-controlsThe 3D libraries are separate peers that the README tells you to install with it.
The README says version 8 is structurally incompatible with the App Router.
import { ShaderGradientCanvas } from '@shadergradient/ui' or expecting controls in @shadergradient/reactVersion 2 ships only the renderer; the UI pieces are a separate, unpublished bundle.
The docs say canvas settings belong on the canvas wrapper.
<ShaderGradientCanvas> in a wrapper with no heightThe canvas takes its parent's size, so a zero-height parent shows nothing.
License
MIT license. The code is under the MIT license, so it is free for personal and paid sites with no visible credit. Keep the MIT notice if you pass the code on.
“MIT © [ruucm](https://github.com/ruucm), [stone-skipper](https://github.com/stone-skipper)” raw.githubusercontent.com
“MIT © [ruucm](https://github.com/ruucm), [stone-skipper](https://github.com/stone-skipper)” raw.githubusercontent.com
“MIT © [ruucm](https://github.com/ruucm), [stone-skipper](https://github.com/stone-skipper)” raw.githubusercontent.com
“MIT © [ruucm](https://github.com/ruucm), [stone-skipper](https://github.com/stone-skipper)” raw.githubusercontent.com
AllowedWith conditionsNot allowedNot stated or not checked yet
Is ShaderGradient free for commercial use? The full answer Not legal advice. Check the license page before you ship.
For your agent
License rules tell your agent what it may do with ShaderGradient. Paste them into your prompt or AGENTS.md.
- ShaderGradient (Video references and motion backgrounds, Backgrounds, patterns and shapes, Web animation examples and effects). Animated 3D WebGL gradient backgrounds (waves, spheres, planes) customized in a web editor and exported as React props; also Figma/Framer plugins. Price: free; commercial use OK; no credit needed. Style: gradient, abstract, 3d.
Connect: npm @shadergradient/react.
Get files: npm install @shadergradient/react (pin 2.4.20) with three/@react-three/fiber; copy the URL/props from the shadergradient.co editor (jsx, js).
Rule: Keep the MIT notice if you redistribute the code.
License: https://raw.githubusercontent.com/ruucm/shadergradient/main/README.md (checked 2026-11-05; details: https://agentgid.com/assets/shadergradient/)
Agent installs a package or loads it from a CDN.
npm install @shadergradient/reactFormats: jsx, js
Background: ShaderGradient (shadergradient.co), MIT LicenseAlternatives
ShaderGradient This page
Pick Vanta.js for ready 3D effects like waves, fog, a net or birds that work with plain script tags, no React.
Pick Granim.js for a small flat animated gradient on a canvas with no 3D library.
Pick tsParticles for particles, confetti or fireworks instead of a gradient.
Hundreds of official three.js WebGL/WebGPU examples (shaders, particles, post-processing, loaders) with full source in the repo's examples folder.
Gallery of React Three Fiber scenes (shaders, portals, caustics, scroll, physics, glass) linked to runnable sandboxes with source.
Questions
Can I use ShaderGradient on a paid site?
Yes. The code is under the MIT license; keep the notice if you pass the code on.
Does it work with Next.js?
Yes. With Next.js 15 and the App Router, use React Three Fiber 9 and React 19; then no extra Next.js settings are needed.
Which shapes can the gradient take?
A plane, a sphere or a water-like plane, set with the type prop.
Does it respect people who turn off motion?
The Vue version freezes the animation when the visitor's system asks for reduced motion.