🎨 Gradient Background Generator

A lightweight, seed-based gradient and blob shape generator.
It creates unique, reproducible gradient images from any input string.

✨ Features

• 🎯 Seed-based: same input → same output.
• 🌈 Customizable gradients: linear or radial gradients.
• 💧 Organic shapes (blobs): configurable count, blur, and alpha.
• 🎨 Color schemes: complementary colors with evenly spaced hues.
• 🔄 Deterministic randomness: colors and positions are reproducible.
• 🖼 Canvas-based: outputs data:image/png URLs ready for tags.

🚀 Installation

Install from npm

npm i gradient-seed-generator

🔧 Usage

Basic example

import { gradient } from 'gradient-background';
const img = document.createElement('img');
img.src = gradient('John Doe');
document.body.appendChild(img);

With options

const imageDataUrl = gradient('John Doe', {
size: 512,
shapes: true,
theme: 'dark',
gradientType: 'radial'
});

📚 API

gradient(seedString: string, options?: GradientOptions): string

Generates a base64 PNG image from the given seed.

Options:

• size (number, default: 256): Canvas size in pixels (width = height).
• shapes (boolean, default: true): Enable or disable organic blob shapes.
• theme (string): Predefined color scheme: dark, vibrant, pastel.
• gradientType (string, default: linear): Gradient type: linear or radial.

🎨 Example Output