GradFlow

Beautiful animated WebGL gradients for React. Create stunning, performant gradient backgrounds with multiple animation styles.

Features

• 🎨 7 Gradient Types: Linear, Conic, Animated, Wave, Silk, Smoke, and Stripe
• 🚀 High Performance: WebGL-powered rendering with optimized shaders
• 🎛️ Fully Customizable: Control colors, animation speed, scale, and noise
• 📱 Responsive: Automatically adapts to container size
• 🔧 TypeScript Support: Fully typed API
• 🎭 Easy Integration: Simple npm install and import

Demo

Visit gradflow.meera.dev to see GradFlow in action and experiment with different configurations.

Installation

npm install gradflow

Quick Start

import { GradFlow } from 'gradflow'

function App() {
  return (
    <div className='relative h-screen'>
      <GradFlow />
      {/* Your content here */}
    </div>
  )
}

Usage Examples

With Custom Configuration

import { GradFlow } from 'gradflow'

function App() {
  return (
    <GradFlow
      config={{
        color1: { r: 226, g: 98, b: 75 },
        color2: { r: 255, g: 255, b: 255 },
        color3: { r: 30, g: 34, b: 159 },
        speed: 0.4,
        scale: 1,
        type: 'stripe',
        noise: 0.08,
      }}
    />
  )
}

Using Hex Colors

import { GradFlow } from 'gradflow'

function App() {
  return (
    <GradFlow
      config={{
        color1: '#e2624b',
        color2: '#ffffff',
        color3: '#1e229f',
      }}
    />
  )
}

Using Presets

import { GradFlow, PRESETS } from 'gradflow'

function App() {
  return <GradFlow config={PRESETS.cosmic} />
}

Available presets: cosmic, matrix, electric, inferno, mystic, cyber, neon, plasma

API Reference

GradFlow Component

| Prop | Type | Default | Description | | ----------- | --------------------- | ---------------- | ----------------------------- | | config | GradientConfigInput | DEFAULT_CONFIG | Gradient configuration object | | className | string | '' | Additional CSS classes |

GradientConfigInput

All properties are optional. You can use either hex strings or RGB objects for colors.

type GradientConfigInput = {
  color1?: string | RGB // First gradient color
  color2?: string | RGB // Second gradient color
  color3?: string | RGB // Third gradient color
  speed?: number // Animation speed (0-2)
  scale?: number // Pattern scale (0.5-3)
  type?: GradientType // Gradient pattern type
  noise?: number // Noise intensity (0-0.5)
}

type RGB = {
  r: number // 0-255
  g: number // 0-255
  b: number // 0-255
}

Gradient Types

• linear - Classic linear gradient with wave distortion
• animated - Dynamic flowing patterns with rotation
• conic - Circular/radial gradient patterns
• wave - Wave-based undulating patterns
• silk - Smooth silk-like flowing textures
• smoke - Organic smoke-like patterns
• stripe - Warped stripe patterns (default)

Utility Functions

Color Conversion

import { hexToRgb, rgbToHex, normalizeColor } from 'gradflow'

// Convert hex to RGB
const rgb = hexToRgb('#ff0000') // { r: 255, g: 0, b: 0 }

// Convert RGB to hex
const hex = rgbToHex({ r: 255, g: 0, b: 0 }) // '#ff0000'

// Normalize color (accepts both string and RGB)
const normalized = normalizeColor('#ff0000') // { r: 255, g: 0, b: 0 }

Random Colors

import { randomRGB, generateRandomColors } from 'gradflow'

// Generate single random RGB color
const color = randomRGB()

// Generate random gradient colors
const colors = generateRandomColors()
// Returns: { color1: RGB, color2: RGB, color3: RGB }

Performance Tips

• Use scale values between 0.5-2.0 for optimal performance
• Lower noise values (< 0.2) perform better
• Consider using will-change: transform CSS for smooth animations
• The component automatically limits device pixel ratio to 2 for performance

Requirements

• React >= 18.0.0
• react-dom >= 18.0.0
• Modern browser with WebGL support

Browser Support

GradFlow works in all modern browsers that support WebGL:

• Chrome 56+
• Firefox 51+
• Safari 15+
• Edge 79+

License

MIT License - feel free to use in your projects!

Credits

Created by Meer

Note: This component requires WebGL support. It gracefully handles unsupported environments but won't render gradients in very old browsers.