{
 "slug": "shadergradient",
 "name": "ShaderGradient",
 "author": "ruucm and stone-skipper",
 "density": "full",
 "status": "active",
 "status_note": null,
 "alternatives_page": null,
 "one_liner": "Animated 3D WebGL gradient backgrounds (waves, spheres, planes) customized in a web editor and exported as React props; also Figma/Framer plugins.",
 "category": {
  "slug": "video-backgrounds",
  "name": "Video references and motion backgrounds"
 },
 "tags": [
  "Code library",
  "Open source"
 ],
 "styles": [
  "gradient",
  "abstract",
  "3d"
 ],
 "logo_url": "https://agentgid.com/media/avatars/ruucm.png",
 "logo_letter": "S",
 "links": {
  "repo": "https://github.com/ruucm/shadergradient",
  "website": "https://shadergradient.co",
  "api_docs": null
 },
 "preview": null,
 "verdicts": [
  {
   "key": "price",
   "label": "Price",
   "value": "Free",
   "status": "yes",
   "sub": "No paid plan",
   "quote": null,
   "note": "Fully free.",
   "source": {
    "label": "shadergradient.co",
    "url": "https://shadergradient.co"
   },
   "n": 1
  },
  {
   "key": "commercial",
   "label": "Commercial use",
   "value": "Yes",
   "status": "yes",
   "sub": "MIT",
   "quote": "MIT © [ruucm](https://github.com/ruucm), [stone-skipper](https://github.com/stone-skipper)",
   "note": "The MIT license allows use in paid products.",
   "source": {
    "label": "raw.githubusercontent.com",
    "url": "https://raw.githubusercontent.com/ruucm/shadergradient/main/README.md"
   },
   "n": 2
  },
  {
   "key": "credit",
   "label": "Credit the author",
   "value": "Not needed",
   "status": "yes",
   "sub": "Keep the notice in code copies",
   "quote": "MIT © [ruucm](https://github.com/ruucm), [stone-skipper](https://github.com/stone-skipper)",
   "note": "No credit on screen. Keep the license notice inside the code you ship.",
   "source": {
    "label": "raw.githubusercontent.com",
    "url": "https://raw.githubusercontent.com/ruucm/shadergradient/main/README.md"
   },
   "n": 3
  },
  {
   "key": "agent_access",
   "label": "Agent access",
   "value": "npm package",
   "status": "info",
   "sub": "Installs without a key",
   "quote": null,
   "note": "An agent can install it by itself with npm install @shadergradient/react. No key or account is needed.",
   "source": {
    "label": "github.com/ruucm/shadergradient",
    "url": "https://github.com/ruucm/shadergradient"
   },
   "n": 4
  }
 ],
 "license": {
  "name": "MIT",
  "url": "https://raw.githubusercontent.com/ruucm/shadergradient/main/README.md",
  "summary": "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.",
  "pages_read": 1,
  "rules": [
   "Keep the MIT notice if you redistribute the code."
  ],
  "rows": [
   {
    "label": "Commercial use",
    "value": "Yes",
    "status": "yes",
    "quote": "MIT © [ruucm](https://github.com/ruucm), [stone-skipper](https://github.com/stone-skipper)",
    "source": {
     "label": "raw.githubusercontent.com",
     "url": "https://raw.githubusercontent.com/ruucm/shadergradient/main/README.md"
    },
    "note": null
   },
   {
    "label": "Credit",
    "value": "Not needed",
    "status": "yes",
    "quote": "MIT © [ruucm](https://github.com/ruucm), [stone-skipper](https://github.com/stone-skipper)",
    "source": {
     "label": "raw.githubusercontent.com",
     "url": "https://raw.githubusercontent.com/ruucm/shadergradient/main/README.md"
    },
    "note": null
   },
   {
    "label": "Inside your app or game",
    "value": "Can ship inside your app",
    "status": "yes",
    "quote": "MIT © [ruucm](https://github.com/ruucm), [stone-skipper](https://github.com/stone-skipper)",
    "source": {
     "label": "raw.githubusercontent.com",
     "url": "https://raw.githubusercontent.com/ruucm/shadergradient/main/README.md"
    },
    "note": null
   },
   {
    "label": "Pass the files on to your users",
    "value": "Allowed",
    "status": "yes",
    "quote": "MIT © [ruucm](https://github.com/ruucm), [stone-skipper](https://github.com/stone-skipper)",
    "source": {
     "label": "raw.githubusercontent.com",
     "url": "https://raw.githubusercontent.com/ruucm/shadergradient/main/README.md"
    },
    "note": null
   },
   {
    "label": "AI training",
    "value": "Not stated",
    "status": "unknown",
    "quote": null,
    "source": null,
    "note": null
   },
   {
    "label": "Bots and bulk downloads",
    "value": "Not stated",
    "status": "unknown",
    "quote": null,
    "source": null,
    "note": null
   }
  ],
  "checked_at": "2026-11-05",
  "commercial_use_page": "https://agentgid.com/assets/shadergradient/commercial-use/"
 },
 "overview": {
  "heading": "ShaderGradient: moving 3D color gradients for sites",
  "body": "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."
 },
 "uses": [
  {
   "title": "Full-screen hero background in React",
   "text": "Put a moving gradient behind the first screen of a landing page or product site, with your text on top.",
   "idea": false,
   "image": null
  },
  {
   "title": "Design it by eye, paste the link",
   "text": "A designer tunes colors, shape and speed in the online editor and sends the link; the page reads every setting from that link.",
   "idea": false,
   "image": null
  },
  {
   "title": "Vue or Nuxt site background",
   "text": "A Vue or Nuxt site gets the same gradients without React, with a plain color shown while the page loads on the server.",
   "idea": false,
   "image": null
  },
  {
   "title": "Gradients in Figma and Framer",
   "text": "Designers add the gradient in Figma with the plugin, including as a moving GIF, or paste the component link into a Framer page.",
   "idea": false,
   "image": null
  },
  {
   "title": "Calm background for a pricing page",
   "text": "Use a still frame (animation off) in soft brand colors behind pricing cards, so the page feels designed without moving parts.",
   "idea": true,
   "image": null
  },
  {
   "title": "Event or launch splash screen",
   "text": "A sphere gradient in the event colors behind the date and the sign-up button on a one-day launch page.",
   "idea": true,
   "image": null
  }
 ],
 "start": {
  "prompt": "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.",
  "install": "npm i @shadergradient/react @react-three/fiber three three-stdlib camera-controls",
  "install_note": null,
  "code": [
   {
    "tab": "Step 2",
    "intro": "Tune the look in the online editor, copy its link and pass it as urlString with control='query'.",
    "source": "<ShaderGradient control='query' urlString='https://www.shadergradient.co/customize?...' />"
   }
  ]
 },
 "mistakes": [
  {
   "dont": "npm i @shadergradient/react alone",
   "fix": "npm i @shadergradient/react @react-three/fiber three three-stdlib camera-controls",
   "why": "The 3D libraries are separate peers that the README tells you to install with it.",
   "dont_code": true,
   "fix_code": true
  },
  {
   "dont": "@react-three/fiber 8 in a Next.js 15 App Router project",
   "fix": "React 19 with @react-three/fiber 9 for the App Router",
   "why": "The README says version 8 is structurally incompatible with the App Router.",
   "dont_code": false,
   "fix_code": false
  },
  {
   "dont": "import { ShaderGradientCanvas } from '@shadergradient/ui' or expecting controls in @shadergradient/react",
   "fix": "Use ShaderGradient and ShaderGradientCanvas from @shadergradient/react and keep the settings in your own state",
   "why": "Version 2 ships only the renderer; the UI pieces are a separate, unpublished bundle.",
   "dont_code": true,
   "fix_code": false
  },
  {
   "dont": "Passing pixelDensity or fov to ShaderGradient",
   "fix": "Put canvas settings such as pixelDensity and fov on ShaderGradientCanvas",
   "why": "The docs say canvas settings belong on the canvas wrapper.",
   "dont_code": false,
   "fix_code": false
  },
  {
   "dont": "<ShaderGradientCanvas> in a wrapper with no height",
   "fix": "Give the wrapper a height (style=\"height: 400px\" or position absolute with inset 0)",
   "why": "The canvas takes its parent's size, so a zero-height parent shows nothing.",
   "dont_code": true,
   "fix_code": false
  }
 ],
 "agent": {
  "self_serve": true,
  "self_serve_text": "Agent installs a package or loads it from a CDN",
  "install": "npm install @shadergradient/react",
  "repo": "https://github.com/ruucm/shadergradient",
  "api_docs": null,
  "api_account": "Not needed. Everything runs on your side.",
  "get_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"
  ],
  "limits": null,
  "mcp": null,
  "mcp_url": null,
  "credit_line": "Background: ShaderGradient (shadergradient.co), MIT License",
  "rules_text": "- 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.\n  Connect: npm @shadergradient/react.\n  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).\n  Rule: Keep the MIT notice if you redistribute the code.\n  License: https://raw.githubusercontent.com/ruucm/shadergradient/main/README.md (checked 2026-11-05; details: https://agentgid.com/assets/shadergradient/)",
  "agent_md": "https://agentgid.com/assets/shadergradient/agent.md",
  "card_json": "https://agentgid.com/assets/shadergradient/card.json"
 },
 "popularity": {
  "gid_score": 36,
  "stars": 3185,
  "downloads_7d": 53380,
  "downloads_7d_label": "53.4K",
  "downloads_change_4w_pct": 28.9,
  "eco": "npm",
  "package": "@shadergradient/react",
  "repo": "ruucm/shadergradient",
  "agent_projects": null,
  "agent_projects_total": null,
  "downloads_unconfirmed": false,
  "series": {
   "downloads_weekly": [
    [
     "2025-11-17",
     2756
    ],
    [
     "2025-11-24",
     3056
    ],
    [
     "2025-12-01",
     3683
    ],
    [
     "2025-12-08",
     3079
    ],
    [
     "2025-12-15",
     4032
    ],
    [
     "2025-12-22",
     2209
    ],
    [
     "2025-12-29",
     3255
    ],
    [
     "2026-01-05",
     4379
    ],
    [
     "2026-01-12",
     4685
    ],
    [
     "2026-01-19",
     4703
    ],
    [
     "2026-01-26",
     5942
    ],
    [
     "2026-02-02",
     8901
    ],
    [
     "2026-02-09",
     7631
    ],
    [
     "2026-02-16",
     7038
    ],
    [
     "2026-02-23",
     7514
    ],
    [
     "2026-03-02",
     8326
    ],
    [
     "2026-03-09",
     7138
    ],
    [
     "2026-03-16",
     9625
    ],
    [
     "2026-03-23",
     9186
    ],
    [
     "2026-03-30",
     9435
    ],
    [
     "2026-04-06",
     8134
    ],
    [
     "2026-04-13",
     8812
    ],
    [
     "2026-04-20",
     9345
    ],
    [
     "2026-04-27",
     7971
    ],
    [
     "2026-05-04",
     8214
    ],
    [
     "2026-05-11",
     11158
    ],
    [
     "2026-05-18",
     11431
    ],
    [
     "2026-05-25",
     12383
    ],
    [
     "2026-06-01",
     24135
    ],
    [
     "2026-06-08",
     25879
    ],
    [
     "2026-06-15",
     24880
    ],
    [
     "2026-06-22",
     27279
    ],
    [
     "2026-06-29",
     29721
    ],
    [
     "2026-07-06",
     33531
    ],
    [
     "2026-07-13",
     25333
    ],
    [
     "2026-07-20",
     28468
    ],
    [
     "2026-07-27",
     31961
    ],
    [
     "2026-08-03",
     30962
    ],
    [
     "2026-08-10",
     23477
    ],
    [
     "2026-08-17",
     23445
    ],
    [
     "2026-08-24",
     22512
    ],
    [
     "2026-08-31",
     26385
    ],
    [
     "2026-09-07",
     18678
    ],
    [
     "2026-09-14",
     21223
    ],
    [
     "2026-09-21",
     34583
    ],
    [
     "2026-09-28",
     38981
    ],
    [
     "2026-10-05",
     29409
    ],
    [
     "2026-10-12",
     24664
    ],
    [
     "2026-10-19",
     32368
    ],
    [
     "2026-10-26",
     35895
    ],
    [
     "2026-11-02",
     42838
    ],
    [
     "2026-11-09",
     53380
    ]
   ],
   "stars": [
    [
     "2026-11-07",
     3093
    ],
    [
     "2026-11-08",
     3094
    ],
    [
     "2026-11-09",
     3105
    ],
    [
     "2026-11-10",
     3120
    ],
    [
     "2026-11-11",
     3128
    ],
    [
     "2026-11-12",
     3140
    ],
    [
     "2026-11-13",
     3153
    ],
    [
     "2026-11-14",
     3165
    ],
    [
     "2026-11-15",
     3172
    ],
    [
     "2026-11-16",
     3175
    ],
    [
     "2026-11-17",
     3185
    ]
   ]
  },
  "stars_flat_since": null,
  "updated_at": "2026-11-17"
 },
 "alternatives": [
  {
   "slug": "shadergradient",
   "name": "ShaderGradient",
   "why": null,
   "current": true,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  },
  {
   "slug": "vanta-js",
   "name": "Vanta.js",
   "why": "Pick Vanta.js for ready 3D effects like waves, fog, a net or birds that work with plain script tags, no React.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  },
  {
   "slug": "granim-js",
   "name": "Granim.js",
   "why": "Pick Granim.js for a small flat animated gradient on a canvas with no 3D library.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  },
  {
   "slug": "tsparticles",
   "name": "tsParticles",
   "why": "Pick tsParticles for particles, confetti or fireworks instead of a gradient.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  },
  {
   "slug": "threejs-examples",
   "name": "three.js examples",
   "why": "Hundreds of official three.js WebGL/WebGPU examples (shaders, particles, post-processing, loaders) with full source in the repo's examples folder.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  },
  {
   "slug": "react-three-fiber-examples",
   "name": "React Three Fiber examples",
   "why": "Gallery of React Three Fiber scenes (shaders, portals, caustics, scroll, physics, glass) linked to runnable sandboxes with source.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  }
 ],
 "faq": [
  {
   "q": "Can I use ShaderGradient on a paid site?",
   "a": "Yes. The code is under the MIT license; keep the notice if you pass the code on."
  },
  {
   "q": "Does it work with Next.js?",
   "a": "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."
  },
  {
   "q": "Which shapes can the gradient take?",
   "a": "A plane, a sphere or a water-like plane, set with the type prop."
  },
  {
   "q": "Does it respect people who turn off motion?",
   "a": "The Vue version freezes the animation when the visitor's system asks for reduced motion."
  }
 ],
 "at_a_glance": {
  "latest_version": "2.4.20",
  "last_commit": "2026-09-23",
  "runtime": "React 18 or 19 (peer ^18.2.0 || ^19.0.0) with three >=0.158.0 and a matching @react-three/fiber 8.x/9.x; Next.js 15 App Router needs React 19 + R3F 9. Vue: @shadergradient/vue 0.1.0 with Vue 3.5, TresJS 5, three 0.180+.",
  "key_needed": false,
  "formats": "jsx, js"
 },
 "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."
 ],
 "stack_snippets": [],
 "claims": [],
 "checked": {
  "license_read": "2026-11-05",
  "overview_checked": "2026-11-10",
  "numbers_updated": "2026-11-17",
  "sources": [
   {
    "label": "shadergradient.co",
    "url": "https://shadergradient.co"
   },
   {
    "label": "raw.githubusercontent.com",
    "url": "https://raw.githubusercontent.com/ruucm/shadergradient/main/README.md"
   },
   {
    "label": "raw.githubusercontent.com",
    "url": "https://raw.githubusercontent.com/ruucm/shadergradient/main/packages/shadergradient-vue/README.md"
   },
   {
    "label": "npm: @shadergradient/react/latest",
    "url": "https://registry.npmjs.org/@shadergradient/react/latest"
   },
   {
    "label": "npm: @shadergradient/react",
    "url": "https://registry.npmjs.org/@shadergradient/react"
   },
   {
    "label": "npm: @shadergradient/vue/latest",
    "url": "https://registry.npmjs.org/@shadergradient/vue/latest"
   },
   {
    "label": "npm: @shadergradient/react/2.4.20",
    "url": "https://registry.npmjs.org/@shadergradient/react/2.4.20"
   }
  ],
  "unverified": null
 },
 "user_reports": null,
 "url": "https://agentgid.com/assets/shadergradient/",
 "note": "Written by AgentGid from the official pages in checked.sources; quotes are copied from those pages. status: yes | cond | no | unknown | info. Prices and vendor claims are as reported on the checked date. Not legal advice."
}
