{
 "slug": "paper-shaders",
 "name": "Paper Shaders",
 "author": "Paper (paper-design)",
 "density": "full",
 "status": "active",
 "status_note": null,
 "alternatives_page": null,
 "one_liner": "Zero-dependency WebGL shader components: mesh gradients, grain, dithering, liquid metal, god rays, halftone, fluted glass; React or vanilla JS.",
 "category": {
  "slug": "motion-examples",
  "name": "Web animation examples and effects"
 },
 "tags": [
  "Code library",
  "Open source"
 ],
 "styles": [
  "gradient",
  "abstract",
  "dark"
 ],
 "logo_url": "https://agentgid.com/media/avatars/paper-design.png",
 "logo_letter": "P",
 "links": {
  "repo": "https://github.com/paper-design/shaders",
  "website": "https://shaders.paper.design",
  "api_docs": null
 },
 "preview": {
  "kind": "image_grid",
  "src": "https://agentgid.com/assets/paper-shaders/demo.jpg",
  "alt": "A mesh gradient behind a headline, and below it a grain gradient, a dithered sphere and a dot orbit, each frozen at a fixed frame.",
  "caption": "Made by AgentGid with @paper-design/shaders 0.0.82 (npm, vanilla ShaderMount). Apache License 2.0; the README allows use in end products without visible attribution. Colors are the library's default presets, the headline is our own."
 },
 "verdicts": [
  {
   "key": "price",
   "label": "Price",
   "value": "Free",
   "status": "yes",
   "sub": "No paid plan",
   "quote": null,
   "note": "Fully free.",
   "source": {
    "label": "shaders.paper.design",
    "url": "https://shaders.paper.design"
   },
   "n": 1
  },
  {
   "key": "commercial",
   "label": "Commercial use",
   "value": "Yes",
   "status": "yes",
   "sub": "Apache License 2.0",
   "quote": "worldwide, non-exclusive, no-charge, royalty-free, irrevocable",
   "note": "Allowed in commercial websites and apps without visible attribution.",
   "source": {
    "label": "raw.githubusercontent.com",
    "url": "https://raw.githubusercontent.com/paper-design/shaders/main/LICENSE"
   },
   "n": 2
  },
  {
   "key": "credit",
   "label": "Credit the author",
   "value": "Not needed",
   "status": "yes",
   "sub": "Keep the notice in code copies",
   "quote": "You must give any other recipients of the Work or",
   "note": "No credit on screen. Keep the license notice inside the code you ship.",
   "source": {
    "label": "raw.githubusercontent.com",
    "url": "https://raw.githubusercontent.com/paper-design/shaders/main/LICENSE"
   },
   "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 @paper-design/shaders-react. No key or account is needed.",
   "source": {
    "label": "github.com/paper-design/shaders",
    "url": "https://github.com/paper-design/shaders"
   },
   "n": 4
  }
 ],
 "license": {
  "name": "Apache License 2.0",
  "url": "https://raw.githubusercontent.com/paper-design/shaders/main/LICENSE",
  "summary": "Apache 2.0 license. You may use it in paid sites, apps, games and videos without a visible credit. If you pass the code on in another library or tool, keep its LICENSE and NOTICE files.",
  "pages_read": 1,
  "rules": [
   "Pin the exact version (0.0.x has breaking changes).",
   "When redistributing the code, ship the Apache-2.0 LICENSE (and NOTICE if present)."
  ],
  "rows": [
   {
    "label": "Commercial use",
    "value": "Yes",
    "status": "yes",
    "quote": "worldwide, non-exclusive, no-charge, royalty-free, irrevocable",
    "source": {
     "label": "raw.githubusercontent.com",
     "url": "https://raw.githubusercontent.com/paper-design/shaders/main/LICENSE"
    },
    "note": null
   },
   {
    "label": "Credit",
    "value": "Not needed",
    "status": "yes",
    "quote": "You must give any other recipients of the Work or",
    "source": {
     "label": "raw.githubusercontent.com",
     "url": "https://raw.githubusercontent.com/paper-design/shaders/main/LICENSE"
    },
    "note": null
   },
   {
    "label": "Inside your app or game",
    "value": "Can ship inside your app",
    "status": "yes",
    "quote": "worldwide, non-exclusive, no-charge, royalty-free, irrevocable",
    "source": {
     "label": "raw.githubusercontent.com",
     "url": "https://raw.githubusercontent.com/paper-design/shaders/main/LICENSE"
    },
    "note": null
   },
   {
    "label": "Pass the files on to your users",
    "value": "With conditions",
    "status": "cond",
    "quote": "You must give any other recipients of the Work or",
    "source": {
     "label": "raw.githubusercontent.com",
     "url": "https://raw.githubusercontent.com/paper-design/shaders/main/LICENSE"
    },
    "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/paper-shaders/commercial-use/"
 },
 "overview": {
  "heading": "Paper Shaders: moving gradients and textures for pages",
  "body": "Paper Shaders is a free set of ready graphic effects for websites, such as flowing color gradients, grain, dot patterns, dithering and liquid metal. Each effect is drawn live by the visitor's graphics chip, so it can move smoothly or stay still. You or your AI assistant add one as a background, a texture or a filter over a picture, and you may use it in paid products without a visible credit."
 },
 "uses": [
  {
   "title": "A moving gradient behind the hero",
   "text": "Put a slowly flowing blend of your brand colors behind the main heading of a landing page instead of a stock photo.",
   "idea": false,
   "image": null
  },
  {
   "title": "A still background with no running cost",
   "text": "Use the same effects as a fixed picture, for example a grainy gradient card, so the page does not keep redrawing it.",
   "idea": false,
   "image": null
  },
  {
   "title": "Picture filters for photos",
   "text": "Turn a product photo or a portrait into a halftone print, a dithered retro picture or an image behind fluted glass.",
   "idea": false,
   "image": null
  },
  {
   "title": "An animated logo",
   "text": "Show your logo in liquid metal or with a glowing heat wave running through it, for a launch page or a loading screen.",
   "idea": false,
   "image": null
  },
  {
   "title": "Textured dark sections",
   "text": "Give a dark pricing or feature section a dot, dither or grain texture so it does not look flat.",
   "idea": false,
   "image": null
  },
  {
   "title": "Short loops for social posts",
   "text": "Record a few seconds of a moving gradient as a video for a post or a presentation slide.",
   "idea": true,
   "image": null
  }
 ],
 "start": {
  "prompt": "Install @paper-design/shaders-react at exactly 0.0.82 and put a MeshGradient with our brand colors behind the hero heading, with speed 0 when the user prefers reduced motion.",
  "install": "npm i @paper-design/shaders-react@0.0.82 --save-exact",
  "install_note": null,
  "code": [
   {
    "tab": "Step 1",
    "intro": "Pick an effect and a preset on shaders.paper.design, then copy its props into your page.",
    "source": "import {MeshGradient, DotOrbit} from '@paper-design/shaders-react';\n\n<MeshGradient\n    colors={['#5100ff', '#00ff80', '#ffcc00', '#ea00ff']}\n    distortion={1}\n    swirl={0.8}\n    speed={0.2}\n    style={{width: 200, height: 200}}\n/>"
   }
  ]
 },
 "mistakes": [
  {
   "dont": "npm i @paper-design/shaders-react (taking whatever is newest, with a ^ range)",
   "fix": "npm i @paper-design/shaders-react@0.0.82 --save-exact, and update on purpose after reading the changelog",
   "why": "The authors ship breaking changes inside 0.0.x, so a caret range can change props under you.",
   "dont_code": true,
   "fix_code": true
  },
  {
   "dont": "new ShaderMount(el, shader, { u_noiseTexture: getShaderNoiseTexture(), ... }) right after creating the image",
   "fix": "const noise = getShaderNoiseTexture(); await noise.decode(); then pass noise",
   "why": "In the plain JavaScript package the mount throws if an image uniform is not loaded yet; our demo hit this error.",
   "dont_code": false,
   "fix_code": true
  },
  {
   "dont": "Copying Paper Texture props from an older example (colorFront, folds, foldCount, contrast, fade)",
   "fix": "Use the 0.0.81+ names (colorShadow, colorPaper, colorBack, crumples, crumpleCount) as listed on the docs page",
   "why": "Version 0.0.81 rebuilt Paper Texture and renamed or removed these props.",
   "dont_code": false,
   "fix_code": false
  },
  {
   "dont": "A full-screen animated shader on every page with default settings",
   "fix": "Set speed={0} where motion is not needed and lower minPixelRatio or maxPixelCount on large areas",
   "why": "Shaders render at 2x resolution by default and keep animating while speed is above 0.",
   "dont_code": false,
   "fix_code": false
  }
 ],
 "agent": {
  "self_serve": true,
  "self_serve_text": "Agent installs a package or loads it from a CDN",
  "install": "npm install @paper-design/shaders-react",
  "repo": "https://github.com/paper-design/shaders",
  "api_docs": null,
  "api_account": "Not needed. Everything runs on your side.",
  "get_files": "npm install @paper-design/shaders-react@0.0.82 (or @paper-design/shaders for vanilla); tune presets on shaders.paper.design and copy the props.",
  "formats": [
   "jsx",
   "js",
   "glsl"
  ],
  "limits": null,
  "mcp": null,
  "mcp_url": null,
  "credit_line": "Powered by Paper Shaders",
  "rules_text": "- Paper Shaders (Web animation examples and effects, Video references and motion backgrounds, Backgrounds, patterns and shapes). Zero-dependency WebGL shader components: mesh gradients, grain, dithering, liquid metal, god rays, halftone, fluted glass; React or vanilla JS. Price: free; commercial use OK; no credit needed; pass the files on to your users only with conditions. Style: gradient, abstract, dark.\n  Connect: npm @paper-design/shaders-react.\n  Get files: npm install @paper-design/shaders-react@0.0.82 (or @paper-design/shaders for vanilla); tune presets on shaders.paper.design and copy the props (jsx, js, glsl).\n  Not allowed: Pin version\n  Rule: Pin the exact version (0.0.x has breaking changes).\n  Rule: When redistributing the code, ship the Apache-2.0 LICENSE (and NOTICE if present).\n  License: https://raw.githubusercontent.com/paper-design/shaders/main/LICENSE (checked 2026-11-05; details: https://agentgid.com/assets/paper-shaders/)",
  "agent_md": "https://agentgid.com/assets/paper-shaders/agent.md",
  "card_json": "https://agentgid.com/assets/paper-shaders/card.json"
 },
 "popularity": {
  "gid_score": 42,
  "stars": 3983,
  "downloads_7d": 1271638,
  "downloads_7d_label": "1.3M",
  "downloads_change_4w_pct": 20.2,
  "eco": "npm",
  "package": "@paper-design/shaders-react",
  "repo": "paper-design/shaders",
  "agent_projects": 4,
  "agent_projects_total": 4817,
  "downloads_unconfirmed": false,
  "series": {
   "downloads_weekly": [
    [
     "2025-11-17",
     64056
    ],
    [
     "2025-11-24",
     32826
    ],
    [
     "2025-12-01",
     33643
    ],
    [
     "2025-12-08",
     39561
    ],
    [
     "2025-12-15",
     44072
    ],
    [
     "2025-12-22",
     36097
    ],
    [
     "2025-12-29",
     40436
    ],
    [
     "2026-01-05",
     91343
    ],
    [
     "2026-01-12",
     94826
    ],
    [
     "2026-01-19",
     94949
    ],
    [
     "2026-01-26",
     104708
    ],
    [
     "2026-02-02",
     166521
    ],
    [
     "2026-02-09",
     198750
    ],
    [
     "2026-02-16",
     193893
    ],
    [
     "2026-02-23",
     353813
    ],
    [
     "2026-03-02",
     623721
    ],
    [
     "2026-03-09",
     674432
    ],
    [
     "2026-03-16",
     715632
    ],
    [
     "2026-03-23",
     762195
    ],
    [
     "2026-03-30",
     850304
    ],
    [
     "2026-04-06",
     806980
    ],
    [
     "2026-04-13",
     869856
    ],
    [
     "2026-04-20",
     783588
    ],
    [
     "2026-04-27",
     661824
    ],
    [
     "2026-05-04",
     497302
    ],
    [
     "2026-05-11",
     375350
    ],
    [
     "2026-05-18",
     337339
    ],
    [
     "2026-05-25",
     339111
    ],
    [
     "2026-06-01",
     345134
    ],
    [
     "2026-06-08",
     363217
    ],
    [
     "2026-06-15",
     578550
    ],
    [
     "2026-06-22",
     397664
    ],
    [
     "2026-06-29",
     336507
    ],
    [
     "2026-07-06",
     428316
    ],
    [
     "2026-07-13",
     446908
    ],
    [
     "2026-07-20",
     487125
    ],
    [
     "2026-07-27",
     557069
    ],
    [
     "2026-08-03",
     565830
    ],
    [
     "2026-08-10",
     573471
    ],
    [
     "2026-08-17",
     623199
    ],
    [
     "2026-08-24",
     664076
    ],
    [
     "2026-08-31",
     736340
    ],
    [
     "2026-09-07",
     502760
    ],
    [
     "2026-09-14",
     627896
    ],
    [
     "2026-09-21",
     815242
    ],
    [
     "2026-09-28",
     927818
    ],
    [
     "2026-10-05",
     1104377
    ],
    [
     "2026-10-12",
     1011858
    ],
    [
     "2026-10-19",
     849711
    ],
    [
     "2026-10-26",
     1289076
    ],
    [
     "2026-11-02",
     1227356
    ],
    [
     "2026-11-09",
     1271638
    ]
   ],
   "stars": [
    [
     "2026-11-07",
     3924
    ],
    [
     "2026-11-08",
     3926
    ],
    [
     "2026-11-09",
     3936
    ],
    [
     "2026-11-10",
     3946
    ],
    [
     "2026-11-11",
     3954
    ],
    [
     "2026-11-12",
     3961
    ],
    [
     "2026-11-13",
     3965
    ],
    [
     "2026-11-14",
     3969
    ],
    [
     "2026-11-15",
     3976
    ],
    [
     "2026-11-16",
     3981
    ],
    [
     "2026-11-17",
     3983
    ]
   ]
  },
  "stars_flat_since": null,
  "updated_at": "2026-11-17"
 },
 "alternatives": [
  {
   "slug": "paper-shaders",
   "name": "Paper Shaders",
   "why": null,
   "current": true,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  },
  {
   "slug": "threejs-examples",
   "name": "three.js examples",
   "why": "Pick the three.js examples for full 3D scenes, particles and post-processing instead of flat 2D effects.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  },
  {
   "slug": "ogl-examples",
   "name": "OGL examples",
   "why": "Pick OGL when you want to write your own small WebGL effects with a minimal library and commented examples.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  },
  {
   "slug": "gsap",
   "name": "GSAP (GreenSock)",
   "why": "Pick GSAP to animate page elements, text and scrolling rather than drawing shader backgrounds.",
   "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"
  },
  {
   "slug": "lenis",
   "name": "Lenis",
   "why": "Lightweight smooth-scroll library often paired with GSAP ScrollTrigger and WebGL scroll effects.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  }
 ],
 "faq": [
  {
   "q": "Do I have to show \"Powered by Paper Shaders\" on my site?",
   "a": "No. Use in end products needs no visible credit; such a credit is welcome but optional."
  },
  {
   "q": "Can I stop the animation?",
   "a": "Yes. Set speed to 0; the frame value then fixes the picture, and the animation loop does not run."
  },
  {
   "q": "Does it need React?",
   "a": "No. There is a plain JavaScript package and a React package; other frameworks are not supported yet."
  },
  {
   "q": "Why did my old code break after an update?",
   "a": "Releases under 0.0.x can rename props; for example 0.0.81 renamed several Paper Texture settings. Pin one version and read the changelog before you update."
  }
 ],
 "at_a_glance": {
  "latest_version": "0.0.82",
  "last_commit": "2026-11-13",
  "runtime": "React 18 or 19 (peer dependency); a browser with WebGL 2. The plain JavaScript package @paper-design/shaders 0.0.82 has no dependencies.",
  "key_needed": false,
  "formats": "jsx, js, glsl"
 },
 "good_to_know": [
  "The project is still at version 0.0.x and says new releases can break existing code. Always install one exact version.",
  "Effects need a browser with WebGL 2 graphics; plan a plain color or image for very old devices.",
  "Effects render at double resolution by default; lower the pixel ratio or pixel limit for big backgrounds on phones.",
  "The ready components are for React; Vue and other frameworks have no package yet and use the plain JavaScript version."
 ],
 "stack_snippets": [],
 "claims": [
  "Ultra-fast, zero-dependency shaders"
 ],
 "checked": {
  "license_read": "2026-11-05",
  "overview_checked": "2026-11-09",
  "numbers_updated": "2026-11-17",
  "sources": [
   {
    "label": "shaders.paper.design",
    "url": "https://shaders.paper.design/"
   },
   {
    "label": "shaders.paper.design/mesh-gradient",
    "url": "https://shaders.paper.design/mesh-gradient"
   },
   {
    "label": "shaders.paper.design/llms.txt",
    "url": "https://shaders.paper.design/llms.txt"
   },
   {
    "label": "README on GitHub",
    "url": "https://github.com/paper-design/shaders/blob/main/README.md"
   },
   {
    "label": "github.com/paper-design/shaders/blob/main/CHANGELOG.md",
    "url": "https://github.com/paper-design/shaders/blob/main/CHANGELOG.md"
   },
   {
    "label": "github.com/paper-design/shaders/blob/main/NOTICE",
    "url": "https://github.com/paper-design/shaders/blob/main/NOTICE"
   },
   {
    "label": "raw.githubusercontent.com",
    "url": "https://raw.githubusercontent.com/paper-design/shaders/main/LICENSE"
   },
   {
    "label": "github.com/paper-design/shaders/blob/main/packages/shaders/src/shader-mount.ts",
    "url": "https://github.com/paper-design/shaders/blob/main/packages/shaders/src/shader-mount.ts"
   },
   {
    "label": "README on GitHub",
    "url": "https://github.com/paper-design/shaders/blob/main/packages/shaders-react/README.md"
   },
   {
    "label": "npm: @paper-design/shaders",
    "url": "https://registry.npmjs.org/@paper-design/shaders"
   },
   {
    "label": "npm: @paper-design/shaders-react",
    "url": "https://registry.npmjs.org/@paper-design/shaders-react"
   },
   {
    "label": "npm: @paper-design/shaders-react/latest",
    "url": "https://registry.npmjs.org/@paper-design/shaders-react/latest"
   }
  ],
  "unverified": null
 },
 "user_reports": null,
 "url": "https://agentgid.com/assets/paper-shaders/",
 "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."
}
