# ShaderGradient — card for AI agents

Animated 3D WebGL gradient backgrounds (waves, spheres, planes) customized in a web editor and exported as React props; also Figma/Framer plugins.

Category: Video references and motion backgrounds (also: Backgrounds, patterns and shapes, Web animation examples and effects) · maker ruucm and stone-skipper · checked 2026-11-05 · style: gradient, abstract, 3d

## Price
- Price: Free
- Free tier: Fully free.

## License
MIT — https://raw.githubusercontent.com/ruucm/shadergradient/main/README.md

- commercial: **yes** (Commercial use OK)
  > MIT © [ruucm](https://github.com/ruucm), [stone-skipper](https://github.com/stone-skipper)
  (https://raw.githubusercontent.com/ruucm/shadergradient/main/README.md)
- attribution: **no** (No credit needed)
  > MIT © [ruucm](https://github.com/ruucm), [stone-skipper](https://github.com/stone-skipper)
  (https://raw.githubusercontent.com/ruucm/shadergradient/main/README.md)
- in app: **yes** (Can ship inside your app)
  > MIT © [ruucm](https://github.com/ruucm), [stone-skipper](https://github.com/stone-skipper)
  (https://raw.githubusercontent.com/ruucm/shadergradient/main/README.md)
- redistribute: **yes** (Can pass the files on to your own users)
  > MIT © [ruucm](https://github.com/ruucm), [stone-skipper](https://github.com/stone-skipper)
  (https://raw.githubusercontent.com/ruucm/shadergradient/main/README.md)

## Rules to follow
- Keep the MIT notice if you redistribute the code.

## Can an AI agent use it by itself?
**Yes** · package: Agent installs a package or loads it from a CDN

## 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. (sign-in: none)
- Formats: jsx, js

## How to connect
- Package (npm/PyPI)
- npm: `npm install @shadergradient/react`
- Repository: https://github.com/ruucm/shadergradient
- Website: https://shadergradient.co

## Notes
No LICENSE file detected by GitHub's API; MIT stated in the README and in npm metadata.

## Numbers (AgentGid data)
- Gid Score: 36
- GitHub stars: 3,185
- Downloads last week: 53,380

## Lines to paste 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/)
```

## Links
- AgentGid page: https://agentgid.com/assets/shadergradient/
- Is it free for commercial use? https://agentgid.com/assets/shadergradient/commercial-use/
- Source: https://raw.githubusercontent.com/ruucm/shadergradient/main/README.md
- Source: https://registry.npmjs.org/@shadergradient/react/latest
- Source: https://shadergradient.co


## 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 to 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: Use a still frame (animation off) in soft brand colors behind pricing cards, so the page feels designed without moving parts. (idea, not from the official pages)
- Event or launch splash screen: A sphere gradient in the event colors behind the date and the sign-up button on a one-day launch page. (idea, not from the official pages)

### How to start
- Install the React package with its 3D peers (three.js and React Three Fiber).

```
npm i @shadergradient/react @react-three/fiber three three-stdlib camera-controls
```

- Pick the React Three Fiber version for your setup; Next.js 15 with the App Router needs version 9 with React 19.
- 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?...' />
```


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

### Good to know
- It needs three.js and React Three Fiber next to it, in versions that match your React and framework.
- The lighting files for the env light mode load from the project's own hosted copy unless you host them yourself.
- The canvas sizes itself to its parent block, so give that block a height; the Vue guide says so outright.
- Only the gradient itself is a package you install; the control panel used by the Figma and Framer versions is not published.
- The license is stated in the README and the package data; the code folder has no separate license file.

Checked 2026-11-10 against: https://shadergradient.co, https://raw.githubusercontent.com/ruucm/shadergradient/main/README.md, https://raw.githubusercontent.com/ruucm/shadergradient/main/packages/shadergradient-vue/README.md, https://registry.npmjs.org/@shadergradient/react/latest, https://registry.npmjs.org/@shadergradient/react, https://registry.npmjs.org/@shadergradient/vue/latest, https://registry.npmjs.org/@shadergradient/react/2.4.20

### Mistakes to avoid
- Don't: npm i @shadergradient/react alone → Do: 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.)
- Don't: @react-three/fiber 8 in a Next.js 15 App Router project → Do: React 19 with @react-three/fiber 9 for the App Router (The README says version 8 is structurally incompatible with the App Router.)
- Don't: import { ShaderGradientCanvas } from '@shadergradient/ui' or expecting controls in @shadergradient/react → Do: 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.)
- Don't: Passing pixelDensity or fov to ShaderGradient → Do: Put canvas settings such as pixelDensity and fov on ShaderGradientCanvas (The docs say canvas settings belong on the canvas wrapper.)
- Don't: <ShaderGradientCanvas> in a wrapper with no height → Do: 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.)

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

---
AgentGid's catalog is curated: every entry was checked against the maker's official pages (registry, repository, license and pricing pages) on the date shown; a license value shows the quote it stands on wherever AgentGid has one. Usage numbers come from AgentGid's own scan of public repositories set up for AI coding agents. Claims by makers are reported, not tested by AgentGid.
