Build Great Products
Skool.com/aiapps

DESIGN TOOL · GUIDE

Paper Shaders.

How to add animated shader backgrounds and effects to your website with Paper Shaders — a free, open-source library you can set up without writing code, just by browsing a gallery and handing the result to your AI agent.

6 Jul 2026·7 min read·By Chris Ashby
paper-shaderspapershaderswebgldesignai-tools

01

What is Paper Shaders?

Paper Shadersis a free, open-source library of animated visual effects — flowing gradients, liquid metal, halftone prints, water ripples, grain, and more — that you can drop into any website. It's built by the team behind Paper, a design tool, and lives on GitHub with around 2,800 stars.

A "shader" is a tiny program that runs on your computer's graphics chip and paints moving pixels — the same technology behind video-game visuals. Normally, writing one requires a specialist programming language. Paper Shaders does that hard part for you: each effect is pre-built, pre-polished, and controlled by a handful of simple settings like colors, speed, and scale. You pick an effect from a gallery, tweak sliders until it looks right, and copy out a few lines of code — or hand the whole job to an AI agent.

02

Why use shaders on your site?

The obvious alternatives to a shader background are a static image or a looping video — and both have real costs. An image doesn't move. A video file is heavy, slow to load, and looks blurry when stretched. A shader is generated live on the visitor's device, so it's a few kilobytes instead of megabytes, stays pin-sharp at any screen size, and can run forever without a visible loop.

The library is deliberately built for this job. Its stated goals: give designers a visual way to use common shaders, keep everything zero-dependency (it adds no other code to your project), maximise performance, and work across a wide range of browsers and devices. Typical uses are page backgrounds, effects masked inside text or shapes, animated logo treatments, and filters applied to images.

Looping video background

Megabytes to download, compression artefacts, a visible loop point, and one fixed crop for every screen.
Changing the colours means re-rendering and re-exporting the video.

Paper Shaders background

A few lines of code, rendered live at full resolution on any screen, animating endlessly with no loop.
Changing the colours means editing a list of hex codes.

04

Set it up

Paper Shaders is distributed through npm, the standard package registry websites are built from. If your site is built with React or Next.js (most modern sites made with AI tools are), the install is one command, run in your project folder:

terminal
npm i @paper-design/shaders-react

If that sentence meant nothing to you, that's fine — this is exactly the kind of step an AI agent handles well. In Claude Code, Cursor, or whatever tool you build with, you can simply ask it to install and wire up the shader for you (a ready-made prompt is in the next section). For sites that don't use React, there's a vanilla JavaScript version called @paper-design/shaders that works the same way.

05

Use a shader

Every shader is a ready-made component: you place it on a page like an image, and its settings are written as readable name–value pairs. Here's the mesh gradient, exactly as the official docs show it — even without knowing code, you can spot where the colours, the distortion, and the animation speed live:

your page
import { MeshGradient } from '@paper-design/shaders-react';

<MeshGradient
  width={1280}
  height={720}
  colors={['#e0eaff', '#241d9a', '#f75092', '#9f50d3']}
  distortion={0.8}
  swirl={0.1}
  speed={1}
/>

The workflow for non-coders: pick your effect in the gallery, adjust it until it looks right, hit copy on the code, and give it to your AI agent with a prompt like this:

your ai agent
Add an animated mesh gradient background to my homepage hero
using Paper Shaders (@paper-design/shaders-react). Use my brand
colors, keep the animation slow and subtle, and make sure the
text on top stays readable. Docs with a code example are here:
https://shaders.paper.design/mesh-gradient

Linking the shader's docs page in your prompt matters — it gives the agent the exact component name and settings, so it doesn't guess or invent an outdated version.

06

Tune the controls

Each shader has its own settings (the mesh gradient has distortion and swirl; the halftone has dot size and angle), but a shared set of controls works across all of them, and knowing four is enough:

  • colors — a list of hex codes, the same colour format used everywhere on the web. Swap in your brand palette; most shaders accept up to 10.
  • speed — how fast the animation runs. 1 is normal, lower is calmer, and 0 freezes it completely — which turns any shader into a static texture.
  • scale — the zoom level of the pattern, from fine texture to big soft shapes.
  • frame — with speed at 0, this picks which frozen moment you get. Scrub it until the static composition looks best.

Change a value, save, and the effect updates — no re-exporting, no re-uploading. Iterating on a shader is closer to editing text than editing a video.

07

Or design it in Paper

The library's second big idea is that these shaders are the same ones built into Paper, the design tool made by the same team. You can compose a shader visually on a design canvas — layering it with your type and layout, no code window in sight — and what you make is directly exportable as the same lightweight code, ready for any codebase. Every gallery page has an "open Paper" link that jumps you straight in.

That makes the split simple: design-minded people set the look in Paper or in the gallery's live controls; whoever (or whatever) writes the code just receives a finished snippet. Nothing is lost in translation between the mockup and the site.

08

License and cost

  • Price: free. The library is open source under the Apache 2.0 license — there is no paid tier, no account, and no usage limit.
  • Commercial use is allowed — websites, apps, games, videos, prototypes, and internal tools, all without visible attribution.
  • One condition:if you redistribute the code as part of another shader library, plugin, or tool, keep the included LICENSE and NOTICE files. A visible "Powered by Paper Shaders" credit is appreciated but optional.

The project is actively maintained by Lost Coast Labs (the company behind Paper), with regular fixes and new shaders landing on GitHub.

09

Sources