Skip to content
Agents tracked: 502 Releases (7d): 613 Agent status: 4 with issuesSince last limit reset: Claude 7d · Codex 5d For AI agents: Markdown Updated Nov 18, 2026

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

GitHub repoWebsite

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.com

License 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

36 / 100
Gid Score, same scale as developer tools
3,185
GitHub stars
53.4K
npm downloads, last 7 days
+28.9% in 4 weeks
ShaderGradient: downloads per weeknpm, @shadergradient/react 53,380
ShaderGradient: GitHub starsruucm/shadergradient 3,185

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 alone
npm i @shadergradient/react @react-three/fiber three three-stdlib camera-controls

The 3D libraries are separate peers that the README tells you to install with it.

@react-three/fiber 8 in a Next.js 15 App Router project
React 19 with @react-three/fiber 9 for the App Router

The README says version 8 is structurally incompatible with the App Router.

import { ShaderGradientCanvas } from '@shadergradient/ui' or expecting controls in @shadergradient/react
Use ShaderGradient and ShaderGradientCanvas from @shadergradient/react and keep the settings in your own state

Version 2 ships only the renderer; the UI pieces are a separate, unpublished bundle.

Passing pixelDensity or fov to ShaderGradient
Put canvas settings such as pixelDensity and fov on ShaderGradientCanvas

The docs say canvas settings belong on the canvas wrapper.

<ShaderGradientCanvas> in a wrapper with no height
Give the wrapper a height (style="height: 400px" or position absolute with inset 0)

The 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.

Commercial use
Yes

“MIT © [ruucm](https://github.com/ruucm), [stone-skipper](https://github.com/stone-skipper)” raw.githubusercontent.com

Credit
Not needed

“MIT © [ruucm](https://github.com/ruucm), [stone-skipper](https://github.com/stone-skipper)” raw.githubusercontent.com

Inside your app or game
Can ship inside your app

“MIT © [ruucm](https://github.com/ruucm), [stone-skipper](https://github.com/stone-skipper)” raw.githubusercontent.com

Pass the files on to your users
Allowed

“MIT © [ruucm](https://github.com/ruucm), [stone-skipper](https://github.com/stone-skipper)” raw.githubusercontent.com

AI training
Not stated
Bots and bulk downloads
Not stated

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.

License rules
- 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/)
Can an agent use it by itself?
Yes.

Agent installs a package or loads it from a CDN.

Install
npm install @shadergradient/react
How an agent gets files
npm install @shadergradient/react (pin 2.4.20) with three/@react-three/fiber; copy the URL/props from the shadergradient.co editor.

Formats: jsx, js

API, key or account
Not needed. Everything runs on your side.
MCP server
None found
Credit line, if you want one
Background: ShaderGradient (shadergradient.co), MIT License
This card for machines

Alternatives

ShaderGradient This page

Free Commercial OK npm

Vanta.js

Pick Vanta.js for ready 3D effects like waves, fog, a net or birds that work with plain script tags, no React.

Free Commercial OK npm

Granim.js

Pick Granim.js for a small flat animated gradient on a canvas with no 3D library.

Free Commercial OK npm

tsParticles

Pick tsParticles for particles, confetti or fireworks instead of a gradient.

Free Commercial OK npm

three.js examples

Hundreds of official three.js WebGL/WebGPU examples (shaders, particles, post-processing, loaders) with full source in the repo's examples folder.

Free Commercial OK npm

React Three Fiber examples

Gallery of React Three Fiber scenes (shaders, portals, caustics, scroll, physics, glass) linked to runnable sandboxes with source.

Free Commercial OK npm

All video references and motion backgrounds

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.