xeerpe

xeerpe is a TypeScript library for building CSS backgrounds and gradient text with a chainable API. It stacks gradients (linear, radial, conic and mesh), patterns, effects, filters and animations into a single style object that works anywhere inline styles do: React, Vue, Angular or plain JavaScript.

Zero dependencies, fully typed, MIT licensed.

When to use xeerpe

Use it when you want to:

• Layer a background: a mesh gradient with grain, a dotted grid over a glow, or a vignette on top, written as one readable chain instead of a long background declaration.
• Animate a background without writing keyframes by hand: pulse, aurora, shimmer, drift and more, from one method.
• Compute a background in JavaScript: colors, angles and sizes that come from props, state or a theme.
• Start from a preset: more than 200 ready-made backgrounds (metals, gems, sky, neon and more), in one line.
• Fill text with a gradient using the same chain.

A single static linear-gradient is usually simpler as plain CSS, and xeerpe returns inline styles, so it is not a replacement for a hand-written stylesheet.

Installation

npm install xeerpe

Quick start

import { Builder } from 'xeerpe'

const style = new Builder()
  .radialGradient({ from: '#FF7A18', to: 'transparent', position: '75% 25%' })
  .linearGradient({ from: '#1a0b05', to: '#060302', angle: '160deg' })
  .dots({ color: '#FF7A18', size: '24px', opacity: 0.14 })
  .grain({ intensity: 2 })
  .toStyle()

The result is a plain object, so it works anywhere that accepts inline styles:

// React
<div style={style} />

<!-- Vue -->
<div :style="style" />

It also works in Angular and plain JavaScript. See the guide for each framework.

Animated background

Animations ship with a small stylesheet that you import once:

import 'xeerpe/animations.css'

const style = new Builder()
  .meshGradient({
    background: '#04121c',
    layers: [
      { position: '15% 25%', from: 'rgba(16,185,129,0.8)', to: 'transparent', colorToPosition: '60%' },
      { position: '85% 30%', from: 'rgba(56,189,248,0.65)', to: 'transparent', colorToPosition: '55%' },
    ],
  })
  .aurora({ duration: '8s' })
  .toStyle()

Gradient text

const textStyle = new Builder().linearGradient({ from: '#5EB847', to: '#BFD43F', angle: '135deg' }).toTextStyle()

Features

• Gradients: linear, radial, conic, mesh
• Patterns: dots, grid, stars, rays
• Effects: noise, vignette, grain, glow
• Filters: blur, backdrop filters
• Animations: pulse, rotate, breathe, aurora, liquid, plasma, float, drift, shimmer
• Presets: ready-made backgrounds
• Text fills: .toTextStyle() for gradient text
• Typed and validated: fully typed, with validation for colors, angles, sizes and positions
• AI-ready: a Claude Code skill, an AGENTS.md for other coding assistants and an llms-full.txt for chat assistants

Use with AI agents

xeerpe includes ready-made instructions that help AI assistants write correct xeerpe code: the chain API, valid option formats, presets and animations. Pick the one that matches your tool.

Claude Code

Download xeerpe-skill-<version>.zip from the latest release and unzip it into your skills folder. To use it in every project:

unzip xeerpe-skill-<version>.zip -d ~/.claude/skills/

To use it in a single project, unzip it into that project's .claude/skills/ folder instead.

Then start a new Claude Code session and use the skill as /xeerpe. Claude also loads it on its own when you ask for backgrounds, gradients or gradient text.

Other coding assistants

This package ships an AGENTS.md, a plain markdown file that many coding assistants read from the project root (Codex, Cursor and GitHub Copilot, among others). Copy it into your project:

cp node_modules/xeerpe/AGENTS.md ./AGENTS.md

If your tool uses its own file, such as .cursor/rules or .github/copilot-instructions.md, paste the same content there.

Chat assistants

For ChatGPT, Perplexity and similar, share the link xeerpe.io/llms-full.txt in the conversation, or attach the file. It holds the API, validation rules, recipes and every preset. A shorter index is at xeerpe.io/llms.txt.

Documentation

Full guide and API reference at xeerpe.io.

License

Copyright (c) 2026 Nicola Centonze

Released under the MIT License.