# Paper Shaders — card for AI agents

Zero-dependency WebGL shader components: mesh gradients, grain, dithering, liquid metal, god rays, halftone, fluted glass; React or vanilla JS.

Category: Web animation examples and effects (also: Video references and motion backgrounds, Backgrounds, patterns and shapes) · maker Paper (paper-design) · checked 2026-11-05 · style: gradient, abstract, dark

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

## License
Apache License 2.0 — https://raw.githubusercontent.com/paper-design/shaders/main/LICENSE

- commercial: **yes** (Commercial use OK)
  > worldwide, non-exclusive, no-charge, royalty-free, irrevocable
  (https://raw.githubusercontent.com/paper-design/shaders/main/LICENSE)
- attribution: **no** (No credit needed)
  > You must give any other recipients of the Work or
  (https://raw.githubusercontent.com/paper-design/shaders/main/LICENSE)
- in app: **yes** (Can ship inside your app)
  > worldwide, non-exclusive, no-charge, royalty-free, irrevocable
  (https://raw.githubusercontent.com/paper-design/shaders/main/LICENSE)
- redistribute: **conditions** (Pass the files on to your users only with conditions)
  > You must give any other recipients of the Work or
  (https://raw.githubusercontent.com/paper-design/shaders/main/LICENSE)

## Rules to follow
- Pin the exact version (0.0.x has breaking changes).
- When redistributing the code, ship the Apache-2.0 LICENSE (and NOTICE if present).

## 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 @paper-design/shaders-react@0.0.82 (or @paper-design/shaders for vanilla); tune presets on shaders.paper.design and copy the props. (sign-in: none)
- Formats: jsx, js, glsl
- Not allowed: Pin version

## How to connect
- Package (npm/PyPI)
- npm: `npm install @paper-design/shaders-react`
- Repository: https://github.com/paper-design/shaders
- Website: https://shaders.paper.design

## Notes
Already used by AgentGid's background-generator recipe (same pinned version 0.0.82).

## Numbers (AgentGid data)
- Gid Score: 42
- GitHub stars: 3,983
- Downloads last week: 1,271,638
- Used in 4 public projects set up for AI coding agents

## Lines to paste into your prompt or AGENTS.md

```
- 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.
  Connect: npm @paper-design/shaders-react.
  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).
  Not allowed: Pin version
  Rule: Pin the exact version (0.0.x has breaking changes).
  Rule: When redistributing the code, ship the Apache-2.0 LICENSE (and NOTICE if present).
  License: https://raw.githubusercontent.com/paper-design/shaders/main/LICENSE (checked 2026-11-05; details: https://agentgid.com/assets/paper-shaders/)
```

## Links
- AgentGid page: https://agentgid.com/assets/paper-shaders/
- Is it free for commercial use? https://agentgid.com/assets/paper-shaders/commercial-use/
- Source: https://shaders.paper.design/
- Source: https://raw.githubusercontent.com/paper-design/shaders/main/LICENSE
- Source: https://registry.npmjs.org/@paper-design/shaders-react/latest


## Paper Shaders: moving gradients and textures for pages

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.

### Where to use it
- A moving gradient behind the hero: Put a slowly flowing blend of your brand colors behind the main heading of a landing page instead of a stock photo.
- A still background with no running cost: Use the same effects as a fixed picture, for example a grainy gradient card, so the page does not keep redrawing it.
- Picture filters for photos: Turn a product photo or a portrait into a halftone print, a dithered retro picture or an image behind fluted glass.
- An animated logo: Show your logo in liquid metal or with a glowing heat wave running through it, for a launch page or a loading screen.
- Textured dark sections: Give a dark pricing or feature section a dot, dither or grain texture so it does not look flat.
- Short loops for social posts: Record a few seconds of a moving gradient as a video for a post or a presentation slide. (idea, not from the official pages)

### How to start
- Install the React package, or the plain JavaScript one, with an exact version.

```
npm i @paper-design/shaders-react@0.0.82 --save-exact
```

- Pick an effect and a preset on shaders.paper.design, then copy its props into your page.

```
import {MeshGradient, DotOrbit} from '@paper-design/shaders-react';

<MeshGradient
    colors={['#5100ff', '#00ff80', '#ffcc00', '#ea00ff']}
    distortion={1}
    swirl={0.8}
    speed={0.2}
    style={{width: 200, height: 200}}
/>
```


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

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

Checked 2026-11-09 against: https://shaders.paper.design/, https://shaders.paper.design/mesh-gradient, https://shaders.paper.design/llms.txt, https://github.com/paper-design/shaders/blob/main/README.md, https://github.com/paper-design/shaders/blob/main/CHANGELOG.md, https://github.com/paper-design/shaders/blob/main/NOTICE, https://raw.githubusercontent.com/paper-design/shaders/main/LICENSE, https://github.com/paper-design/shaders/blob/main/packages/shaders/src/shader-mount.ts, https://github.com/paper-design/shaders/blob/main/packages/shaders-react/README.md, https://registry.npmjs.org/@paper-design/shaders, https://registry.npmjs.org/@paper-design/shaders-react, https://registry.npmjs.org/@paper-design/shaders-react/latest

### Mistakes to avoid
- Don't: npm i @paper-design/shaders-react (taking whatever is newest, with a ^ range) → Do: npm i @paper-design/shaders-react@0.0.82 --save-exact, and update on purpose after reading the changelog (The authors ship breaking changes inside 0.0.x, so a caret range can change props under you.)
- Don't: new ShaderMount(el, shader, { u_noiseTexture: getShaderNoiseTexture(), ... }) right after creating the image → Do: const noise = getShaderNoiseTexture(); await noise.decode(); then pass noise (In the plain JavaScript package the mount throws if an image uniform is not loaded yet; our demo hit this error.)
- Don't: Copying Paper Texture props from an older example (colorFront, folds, foldCount, contrast, fade) → Do: Use the 0.0.81+ names (colorShadow, colorPaper, colorBack, crumples, crumpleCount) as listed on the docs page (Version 0.0.81 rebuilt Paper Texture and renamed or removed these props.)
- Don't: A full-screen animated shader on every page with default settings → Do: Set speed={0} where motion is not needed and lower minPixelRatio or maxPixelCount on large areas (Shaders render at 2x resolution by default and keep animating while speed is above 0.)

### Questions
- Do I have to show "Powered by Paper Shaders" on my site? No. Use in end products needs no visible credit; such a credit is welcome but optional.
- Can I stop the animation? Yes. Set speed to 0; the frame value then fixes the picture, and the animation loop does not run.
- Does it need React? No. There is a plain JavaScript package and a React package; other frameworks are not supported yet.
- Why did my old code break after an update? 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.

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