Skip to content

【Be a star, give a star!⭐️】A Node.js service that generates animated gradient SVGs with customizable text overlays. Supports multiple gradient types, animation effects, and includes templates for both standard color schemes and pride flags. Deploy as an API endpoint to create dynamic, animated text displays with smooth gradient backgrounds.

License

Notifications You must be signed in to change notification settings

ChanMeng666/gradient-svg-generator

Repository files navigation

Project Banner

🎨 Gradient SVG Generator

Professional Dynamic SVG Gradient Creator with 180+ Templates

The ultimate gradient SVG generator featuring 140+ gradient types, 180+ professional templates across 22 categories, and real-time preview.
Supports custom colors, multiple animation effects, and extensible template system with advanced visual effects.
One-click FREE deployment of your stunning gradient banners.

Live Demo · Settings Panel · API Documentation · Template Gallery · Issues


🚀 Try Live Demo 🚀


[][vercel-link] [][next-link] [][react-link]

Share Gradient SVG Generator

🌟 Create stunning animated gradient SVGs for your projects. Built for developers, designers, and content creators.

🎬 Live Demo Gallery

[!TIP] Experience the power of our gradient generator with these live examples! Click on any code block to copy.

Neural Network

Neural Network Template - AI-inspired gradient with animated effects

![Neural Network](https://gradient-svg-generator.vercel.app/api/svg?text=Welcome%20to%20Our%20Gallery&template=neural-network&height=120)

✨ Popular Animation Styles

Hologram Matrix

Hologram Matrix

📋 Copy Code
![Hologram Matrix](https://gradient-svg-generator.vercel.app/api/svg?text=Hologram%20Effect&template=hologram-matrix&height=100)
    </details>
  </td>
  <td align="center">
    <img src="https://gradient-svg-generator.vercel.app/api/svg?text=Energy%20Blast&template=energy-blast&height=100" alt="Energy Blast" width="400"/>
    <p><strong>Energy Blast</strong></p>
    <details>
    <summary>📋 Copy Code</summary>
![Energy Blast](https://gradient-svg-generator.vercel.app/api/svg?text=Energy%20Blast&template=energy-blast&height=100)
    </details>
  </td>
</tr>
<tr>
  <td align="center">
    <img src="https://gradient-svg-generator.vercel.app/api/svg?text=Quantum%20Field&template=quantum-field&height=100" alt="Quantum Field" width="400"/>
    <p><strong>Quantum Field</strong></p>
    <details>
    <summary>📋 Copy Code</summary>
![Quantum Field](https://gradient-svg-generator.vercel.app/api/svg?text=Quantum%20Field&template=quantum-field&height=100)
    </details>
  </td>
  <td align="center">
    <img src="https://gradient-svg-generator.vercel.app/api/svg?text=Diamond%20Sparkle&template=diamond-sparkle&height=100" alt="Diamond Sparkle" width="400"/>
    <p><strong>Diamond Sparkle</strong></p>
    <details>
    <summary>📋 Copy Code</summary>
![Diamond Sparkle](https://gradient-svg-generator.vercel.app/api/svg?text=Diamond%20Sparkle&template=diamond-sparkle&height=100)
    </details>
  </td>
</tr>

🎨 Advanced Gradient Effects

Northern Aurora

Northern Aurora

📋 Copy Code
![Northern Aurora](https://gradient-svg-generator.vercel.app/api/svg?text=Aurora%20Borealis&template=northern-aurora&height=90)
    </details>
  </td>
  <td align="center">
    <img src="https://gradient-svg-generator.vercel.app/api/svg?text=Lava%20Flow&template=lava-flow&height=90" alt="Lava Flow" width="300"/>
    <p><strong>Lava Flow</strong></p>
    <details>
    <summary>📋 Copy Code</summary>
![Lava Flow](https://gradient-svg-generator.vercel.app/api/svg?text=Lava%20Flow&template=lava-flow&height=90)
    </details>
  </td>
  <td align="center">
    <img src="https://gradient-svg-generator.vercel.app/api/svg?text=Ocean%20Wave&template=ocean-wave&height=90" alt="Ocean Wave" width="300"/>
    <p><strong>Ocean Wave</strong></p>
    <details>
    <summary>📋 Copy Code</summary>
![Ocean Wave](https://gradient-svg-generator.vercel.app/api/svg?text=Ocean%20Wave&template=ocean-wave&height=90)
    </details>
  </td>
</tr>
🎨 More Demo Examples

🌈 Diversity & Pride Collection

Progress Pride

Progress Pride

![Progress Pride](https://gradient-svg-generator.vercel.app/api/svg?text=Pride%20%26%20Progress&template=progress-pride&height=80)
  </td>
  <td align="center">
    <img src="https://gradient-svg-generator.vercel.app/api/svg?text=Trans%20Rights&template=trans-pride&height=80" alt="Trans Pride" width="350"/>
    <p><strong>Trans Pride</strong></p>
![Trans Pride](https://gradient-svg-generator.vercel.app/api/svg?text=Trans%20Rights&template=trans-pride&height=80)
  </td>
</tr>

💎 Luxury & Material Effects

Golden Leaf

Golden Leaf

![Golden Leaf](https://gradient-svg-generator.vercel.app/api/svg?text=Golden%20Leaf&template=golden-leaf&height=90)
  </td>
  <td align="center">
    <img src="https://gradient-svg-generator.vercel.app/api/svg?text=Royal%20Velvet&template=royal-velvet&height=90" alt="Royal Velvet" width="300"/>
    <p><strong>Royal Velvet</strong></p>
![Royal Velvet](https://gradient-svg-generator.vercel.app/api/svg?text=Royal%20Velvet&template=royal-velvet&height=90)
  </td>
  <td align="center">
    <img src="https://gradient-svg-generator.vercel.app/api/svg?text=Rose%20Gold&template=rose-gold&height=90" alt="Rose Gold" width="300"/>
    <p><strong>Rose Gold</strong></p>
![Rose Gold](https://gradient-svg-generator.vercel.app/api/svg?text=Rose%20Gold&template=rose-gold&height=90)
  </td>
</tr>

🎮 Gaming & Retro Styles

Pixel Art

Pixel Art Retro

![Pixel Art](https://gradient-svg-generator.vercel.app/api/svg?text=Pixel%20Art&template=pixel-art-retro&height=80)
  </td>
  <td align="center">
    <img src="https://gradient-svg-generator.vercel.app/api/svg?text=Neon%20Arcade&template=neon-arcade&height=80" alt="Neon Arcade" width="250"/>
    <p><strong>Neon Arcade</strong></p>
![Neon Arcade](https://gradient-svg-generator.vercel.app/api/svg?text=Neon%20Arcade&template=neon-arcade&height=80)
  </td>
  <td align="center">
    <img src="https://gradient-svg-generator.vercel.app/api/svg?text=Retro%20Wave&template=retro-wave&height=80" alt="Retro Wave" width="250"/>
    <p><strong>Retro Wave</strong></p>
![Retro Wave](https://gradient-svg-generator.vercel.app/api/svg?text=Retro%20Wave&template=retro-wave&height=80)
  </td>
</tr>

🔬 Technology & Future

Cyber Matrix

Cyber Matrix

![Cyber Matrix](https://gradient-svg-generator.vercel.app/api/svg?text=Cyber%20Matrix&template=cyber-matrix&height=80)
  </td>
  <td align="center">
    <img src="https://gradient-svg-generator.vercel.app/api/svg?text=Data%20Stream&template=data-stream&height=80" alt="Data Stream" width="350"/>
    <p><strong>Data Stream</strong></p>
![Data Stream](https://gradient-svg-generator.vercel.app/api/svg?text=Data%20Stream&template=data-stream&height=80)
  </td>
</tr>

Tech Stack Badges:

Important

This project demonstrates advanced SVG generation techniques with 180+ professional templates across 22 categories. It combines modern web technologies with sophisticated animation systems to provide stunning visual effects for any project.

📑 Table of Contents

TOC


🌟 Introduction

We are passionate developers creating next-generation SVG gradient solutions. By adopting modern development practices and cutting-edge animation technologies, we aim to provide users and developers with powerful, scalable, and user-friendly gradient generation tools.

Whether you're a web developer, content creator, or design enthusiast, this project will be your gradient creation playground. Please note that this project is under active development, and we welcome feedback for any issues encountered.

Note

  • No installation required for basic usage
  • Next.js 13+ for local development
  • Vercel account optional for custom deployment
  • 180+ professional templates available
  • Real-time preview and customization
No installation required! Visit our demo to experience it firsthand.
Advanced settings panel with full customization options and live preview.

Tip

⭐ Star us to receive all release notifications from GitHub without delay!

⭐ Star History

✨ Key Features

Experience our extensive template library spanning 22 categories. Our innovative template system provides unprecedented variety through carefully curated color palettes and animation effects. This comprehensive collection delivers professional-grade gradients for any project.

Template Gallery Demo

Diamond Sparkle Template from our Luxury Collection

![Diamond Sparkle](https://gradient-svg-generator.vercel.app/api/svg?text=Template%20Gallery&template=diamond-sparkle&height=120)

Key template categories include:

  • 🌈 Pride Collection: 20+ LGBTQ+ pride flag templates
  • 🔬 Technology: AI, neural networks, cyberpunk aesthetics
  • 🌿 Nature: Sunrise, ocean, forest, aurora effects
  • 💎 Materials: Gold, diamond, marble, crystal textures
  • 🎮 Gaming: Retro, neon arcade, energy blast effects
  • 🎨 Artistic: Watercolor, oil paint, graffiti styles
  • Text Effects: Glitch, typewriter, luminance animations
  • 🌊 Organic: Flowing water, flame, lightning effects
  • 🔮 Experimental: Morphing, dimensional, consciousness streams

Tip

You can also combine templates with custom parameters:

![Custom Neural](https://gradient-svg-generator.vercel.app/api/svg?text=AI%20BRAIN&template=neural-network&height=180&duration=5s)

Revolutionary gradient system that transforms how users create visual effects. With our advanced algorithms and intuitive API, users can generate professional gradients while maintaining perfect animation performance.

Spiral

Spiral

![Spiral](https://gradient-svg-generator.vercel.app/api/svg?text=Spiral&gradientType=spiral&color0=ff00ff&color1=00ffff&height=80)
  </td>
  <td align="center">
    <img src="https://gradient-svg-generator.vercel.app/api/svg?text=Diamond&gradientType=diamond&color0=ffd700&color1=ff6b6b&height=80" alt="Diamond" width="150"/>
    <p><strong>Diamond</strong></p>
![Diamond](https://gradient-svg-generator.vercel.app/api/svg?text=Diamond&gradientType=diamond&color0=ffd700&color1=ff6b6b&height=80)
  </td>
  <td align="center">
    <img src="https://gradient-svg-generator.vercel.app/api/svg?text=Wave&gradientType=wave&color0=4facfe&color1=00f2fe&height=80" alt="Wave" width="150"/>
    <p><strong>Wave</strong></p>
![Wave](https://gradient-svg-generator.vercel.app/api/svg?text=Wave&gradientType=wave&color0=4facfe&color1=00f2fe&height=80)
  </td>
  <td align="center">
    <img src="https://gradient-svg-generator.vercel.app/api/svg?text=Burst&gradientType=burst&color0=fa709a&color1=fee140&height=80" alt="Burst" width="150"/>
    <p><strong>Burst</strong></p>
![Burst](https://gradient-svg-generator.vercel.app/api/svg?text=Burst&gradientType=burst&color0=fa709a&color1=fee140&height=80)
  </td>
</tr>

Available Gradient Types:

  • Basic Types: Horizontal, Vertical, Diagonal, Circular, Radial
  • Advanced Types: Conic, Wave, Spiral, Diamond, Burst, Pulse, Reflection
  • Special Effects: Star, Heart, Galaxy, Lightning, ZigZag, Ripple
  • Future Tech: Hologram, Quantum, Laser Grid, Neural Net, Plasma, Data Stream
  • Artistic: Watercolor, Oil Paint, Ink Splash, Mosaic, Abstract Geometry
  • Luxury: Gold Foil, Diamond, Marble, Platinum, Rose Gold, Crystal, Velvet
  • Organic: Flowing Water, Flame, Clouds, Aurora, Ocean Waves, Forest, Lightning
  • Gaming: Pixel Art, Neon Arcade, Energy Blast, Speed Lines, Boss Battle
  • Experimental: Morphing, Dimensional Portal, Consciousness Stream, Digital Life

* Modern Features

Beyond the core template and gradient systems, this project includes:

  • 💨 Real-time Preview: Live visual feedback with instant updates
  • 🌐 RESTful API: Simple HTTP API for easy integration
  • 🔒 No Registration: Direct usage without sign-up requirements
  • 💎 Modern UI/UX: Beautiful Next.js interface with responsive design
  • 🗣️ Multi-Parameter: Support for unlimited colors and custom sizing
  • 📊 140+ Gradient Types: From basic to advanced visual effects
  • 🔌 Template System: Extensible architecture for custom templates
  • 📱 Mobile Ready: Perfect responsive design for all devices
  • High Performance: Optimized SVG generation with fast API responses
  • 🎨 Color Flexibility: Hex color support with unlimited gradient stops
  • 💾 State Management: Zustand for favorites and recent templates
  • 🚀 Dynamic Imports: Code splitting for optimal performance
  • 📦 Virtualization: Efficient rendering for large template lists

✨ More features are continuously being added as the project evolves.

🛠️ Tech Stack

Next.js
Next.js 13
React
React 18
JavaScript
JavaScript ES6+
Vercel
Vercel
SVG
SVG
Tailwind
Tailwind CSS

Frontend Stack:

  • Framework: Next.js 13 with Pages Router
  • UI Library: React 18 with Hooks
  • Styling: Tailwind CSS + CSS Modules + Custom Animations
  • Icons: React Icons + Lucide Icons
  • State Management: Zustand with persistence
  • Animation: Framer Motion + CSS3 animations

Backend Stack:

  • Runtime: Node.js with Next.js API Routes
  • SVG Generation: Custom SVG engine with advanced filters
  • Animation System: CSS3 animations with SVG SMIL
  • Template System: Modular template architecture

DevOps & Deployment:

  • Deployment: Vercel (recommended) / Netlify / Docker
  • Performance: Server-side rendering + Edge functions
  • Monitoring: Built-in error handling
  • CDN: Vercel Edge Network for global distribution

Tip

Each technology was carefully selected for performance, developer experience, and scalability.

🎨 Template Showcase

Important

Explore our comprehensive template library with 180+ professional designs across 22 categories. Each template is carefully crafted with authentic color palettes and optimized animations.

🌈 Pride Templates (20 Templates)

Celebrate diversity and inclusion with our comprehensive LGBTQ+ pride collection

Template Preview Markdown Code
Progress Pride Progress Pride ![Progress Pride](https://gradient-svg-generator.vercel.app/api/svg?text=Progress%20Pride&template=progress-pride&height=80)
Trans Pride Trans Pride ![Trans Pride](https://gradient-svg-generator.vercel.app/api/svg?text=Trans%20Pride&template=trans-pride&height=80)
Bi Pride Bi Pride ![Bi Pride](https://gradient-svg-generator.vercel.app/api/svg?text=Bi%20Pride&template=bi-pride&height=80)
Pan Pride Pan Pride ![Pan Pride](https://gradient-svg-generator.vercel.app/api/svg?text=Pan%20Pride&template=pan-pride&height=80)
🏳️‍🌈 View All 20 Pride Templates
Template Preview Markdown Code
Lesbian Pride Lesbian Pride ![Lesbian Pride](https://gradient-svg-generator.vercel.app/api/svg?text=Lesbian%20Pride&template=lesbian-pride&height=80)
Nonbinary Pride Nonbinary Pride ![Nonbinary Pride](https://gradient-svg-generator.vercel.app/api/svg?text=Nonbinary%20Pride&template=nonbinary-pride&height=80)
Ace Pride Ace Pride ![Ace Pride](https://gradient-svg-generator.vercel.app/api/svg?text=Ace%20Pride&template=ace-pride&height=80)
Genderfluid Pride Genderfluid Pride ![Genderfluid Pride](https://gradient-svg-generator.vercel.app/api/svg?text=Genderfluid&template=genderfluid-pride&height=80)
Rainbow Pride Rainbow Pride ![Rainbow Pride](https://gradient-svg-generator.vercel.app/api/svg?text=Rainbow%20Pride&template=pride-rainbow&height=80)
Aromantic Pride Aromantic Pride ![Aromantic Pride](https://gradient-svg-generator.vercel.app/api/svg?text=Aro%20Pride&template=aro-pride&height=80)

🔬 Technology Templates

Futuristic and cutting-edge technology-inspired gradients

Template Preview Markdown Code
Neural Network Neural Network ![Neural Network](https://gradient-svg-generator.vercel.app/api/svg?text=Neural%20Network&template=neural-network&height=80)
Cyber Matrix Cyber Matrix ![Cyber Matrix](https://gradient-svg-generator.vercel.app/api/svg?text=Cyber%20Matrix&template=cyber-matrix&height=80)
Quantum Field Quantum Field ![Quantum Field](https://gradient-svg-generator.vercel.app/api/svg?text=Quantum%20Field&template=quantum-field&height=80)
Hologram Blue Hologram Blue ![Hologram Blue](https://gradient-svg-generator.vercel.app/api/svg?text=Hologram%20Blue&template=hologram-blue&height=80)

🌿 Nature Templates

Natural phenomena with authentic earth-inspired color palettes

Template Preview Markdown Code
Sunrise Dawn Sunrise Dawn ![Sunrise Dawn](https://gradient-svg-generator.vercel.app/api/svg?text=Sunrise%20Dawn&template=sunrise-dawn&height=80)
Northern Aurora Northern Aurora ![Northern Aurora](https://gradient-svg-generator.vercel.app/api/svg?text=Northern%20Aurora&template=northern-aurora&height=80)
Ocean Depths Ocean Depths ![Ocean Depths](https://gradient-svg-generator.vercel.app/api/svg?text=Ocean%20Depths&template=ocean-depths&height=80)
Forest Mist Forest Mist ![Forest Mist](https://gradient-svg-generator.vercel.app/api/svg?text=Forest%20Mist&template=forest-mist&height=80)

💎 Material Templates

Realistic material textures and luxury finishes

Template Preview Markdown Code
Gold Luxury Gold Luxury ![Gold Luxury](https://gradient-svg-generator.vercel.app/api/svg?text=Gold%20Luxury&template=gold-luxury&height=80)
Diamond Crystal Diamond Crystal ![Diamond Crystal](https://gradient-svg-generator.vercel.app/api/svg?text=Diamond%20Crystal&template=diamond-crystal&height=80)
Silver Chrome Silver Chrome ![Silver Chrome](https://gradient-svg-generator.vercel.app/api/svg?text=Silver%20Chrome&template=silver-chrome&height=80)
Emerald Gem Emerald Gem ![Emerald Gem](https://gradient-svg-generator.vercel.app/api/svg?text=Emerald%20Gem&template=emerald-gem&height=80)

✨ Text Effect Templates

Special visual text effects with advanced animations

Template Preview Markdown Code
Luminance Glow Luminance Glow ![Luminance Glow](https://gradient-svg-generator.vercel.app/api/svg?text=Luminance%20Glow&template=luminance-glow&height=80)
Rainbow Wave Rainbow Wave ![Rainbow Wave](https://gradient-svg-generator.vercel.app/api/svg?text=Rainbow%20Wave&template=rainbow-wave&height=80)
Glitch Cyber Glitch Cyber ![Glitch Cyber](https://gradient-svg-generator.vercel.app/api/svg?text=Glitch%20Cyber&template=glitch-cyber&height=80)
Typewriter Terminal Typewriter Terminal ![Typewriter Terminal](https://gradient-svg-generator.vercel.app/api/svg?text=Typewriter%20Terminal&template=typewriter-terminal&height=80)

🎮 Gaming Templates

Gaming-inspired retro and modern aesthetics

Template Preview Markdown Code
Pixel Art Retro Pixel Art Retro ![Pixel Art Retro](https://gradient-svg-generator.vercel.app/api/svg?text=Pixel%20Art%20Retro&template=pixel-art-retro&height=80)
Neon Arcade Neon Arcade ![Neon Arcade](https://gradient-svg-generator.vercel.app/api/svg?text=Neon%20Arcade&template=neon-arcade&height=80)
Energy Blast Energy Blast ![Energy Blast](https://gradient-svg-generator.vercel.app/api/svg?text=Energy%20Blast&template=energy-blast&height=80)
Cyberpunk City Cyberpunk City ![Cyberpunk City](https://gradient-svg-generator.vercel.app/api/svg?text=Cyberpunk%20City&template=cyberpunk-city&height=80)

🔧 API Reference

🌐 Base URL

https://gradient-svg-generator.vercel.app/api/svg

📋 Parameters

Parameter Type Default Description Example
text string required Display text text=Hello%20World
height number 120 SVG height in pixels (30-300) height=150
template string - Template name template=neural-network
gradientType string horizontal Gradient type/effect gradientType=spiral
duration string 6s Animation duration duration=8s
color0, color1, ... string 000000 Gradient colors (hex without #) color0=ff0000&color1=00ff00

🎨 Available Gradient Types

// Basic Types (5 types)
'horizontal', 'vertical', 'diagonal', 'circular', 'radial'

// Advanced Types (7 types)
'conic', 'wave', 'spiral', 'diamond', 'burst', 'reflection', 'pulse'

// Special Effects (6 types)  
'star', 'heart', 'zigzag', 'ripple', 'galaxy', 'lightning'

// Future Tech (6 types)
'hologram', 'quantum', 'laserGrid', 'neuralNet', 'plasma', 'dataStream'

// Artistic (7 types)
'watercolor', 'oilPaint', 'inkSplash', 'mosaic', 'abstractGeo', 'graffiti', 'vintage'

// Luxury (7 types)
'goldFoil', 'diamond', 'marble', 'platinum', 'roseGold', 'crystal', 'velvet'

// Organic Nature (8 types)
'flowingWater', 'flame', 'clouds', 'aurora', 'oceanWaves', 'forest', 'lightning', 'mountainMist'

// Gaming (8 types)
'pixelArt', 'neonArcade', 'energyBlast', 'speedLines', 'bossBattle', 'powerUp', 'cyberpunk', 'retroWave'

// Text Effects (5 types)
'luminance', 'rainbow', 'textBox', 'glitch', 'typewriter'

// Experimental (20+ types)
'morphing', 'dimensionalPortal', 'consciousnessStream', 'digitalLife', 'cyberAesthetics'

🚀 Usage Examples

Basic Usage

Basic Gradient

![Basic Gradient](https://gradient-svg-generator.vercel.app/api/svg?text=Basic%20Gradient)

Custom Colors

Custom Colors

![Custom Colors](https://gradient-svg-generator.vercel.app/api/svg?text=Custom&color0=ff0080&color1=8000ff&color2=0080ff)

Template with Customization

Custom Template

![Custom Template](https://gradient-svg-generator.vercel.app/api/svg?text=AI%20Project&template=neural-network&height=180&duration=5s)

Advanced Multi-Color

Rainbow

![Rainbow](https://gradient-svg-generator.vercel.app/api/svg?text=Rainbow&gradientType=spiral&color0=ff0000&color1=ff8000&color2=ffff00&color3=00ff00&color4=0000ff&duration=10s)

🚀 Getting Started

🌐 Using the Web Interface (Recommended)

  1. Visit the Live Application: https://gradient-svg-generator.vercel.app
  2. Choose Your Approach:
  3. Generate & Export: Copy markdown/HTML code with one click

🔗 Direct API Usage

Welcome Banner

![Welcome Banner](https://gradient-svg-generator.vercel.app/api/svg?text=Welcome%20Banner&template=hologram-matrix&height=120)

💻 Local Development

Prerequisites:

  • Node.js 14.0.0 or higher
  • npm/yarn package manager

Quick Setup:

# Clone repository
git clone https://github.com/ChanMeng666/gradient-svg-generator.git
cd gradient-svg-generator

# Install dependencies
npm install

# Start development server
npm run dev

🎉 Success! Open http://localhost:3000 to view the application.

🛳 Deployment

🌐 Vercel Deployment (Recommended)

Deploy with Vercel

Manual Deployment:

# Install Vercel CLI
npm i -g vercel

# Deploy
vercel --prod

🐳 Docker Deployment

# Build Docker image
docker build -t gradient-svg-generator .

# Run container
docker run -p 3000:3000 gradient-svg-generator

docker-compose.yml:

version: '3.8'
services:
  app:
    build: .
    ports:
      - "3000:3000"
    environment:
      - NODE_ENV=production

📖 Usage Guide

Basic Usage Examples

GitHub Profile Headers

Profile Header

![Profile Header](https://gradient-svg-generator.vercel.app/api/svg?text=Welcome%20to%20My%20Profile&template=cyber-matrix&height=200)

Project Banners

Project Banner

![Project Banner](https://gradient-svg-generator.vercel.app/api/svg?text=My%20Awesome%20Project&template=neural-network&height=150)

Social Media Graphics

Social Banner

![Social Banner](https://gradient-svg-generator.vercel.app/api/svg?text=Follow%20Me&template=neon-arcade&height=120)

Advanced Customization

Multi-Color Gradients

Rainbow Spiral

![Rainbow Spiral](https://gradient-svg-generator.vercel.app/api/svg?text=Rainbow&gradientType=spiral&color0=ff0000&color1=ff8000&color2=ffff00&color3=00ff00&color4=0000ff&duration=10s)

Custom Animations

Fast Animation

![Fast Animation](https://gradient-svg-generator.vercel.app/api/svg?text=SPEED&template=energy-blast&duration=2s)

Combined Effects

Combined

![Combined](https://gradient-svg-generator.vercel.app/api/svg?text=CUSTOM&gradientType=hologram&color0=ff00ff&color1=00ffff&color2=ffff00&height=200&duration=4s)

🏗️ Architecture

Project Structure

gradient-svg-generator/
├── src/
│   ├── pages/           # Next.js pages
│   │   ├── api/        # API routes
│   │   ├── create.js   # Creation interface
│   │   └── templates.js # Template gallery
│   ├── components/      # React components
│   ├── utils/          # Utility functions
│   │   └── gradientGenerators/ # Gradient generators
│   ├── templates/      # Template definitions (22 categories)
│   ├── store/          # Zustand state management
│   └── styles/         # CSS modules & Tailwind
└── public/             # Static assets

Key Components

  • Gradient Factory: Central factory pattern for gradient creation
  • Template System: Modular template architecture with auto-registration
  • Generator Categories: Organized gradient generators by type
  • State Management: Zustand for persistent user preferences
  • Performance: Virtualization and dynamic imports for optimization

⌨️ Development

Adding New Templates

// src/templates/myCategory.js
export default [
  {
    name: 'my-template',
    label: 'My Template',
    colors: ['ff0080', '7928ca'],
    gradientType: 'spiral',
    animationDuration: '6s',
    description: 'My custom template'
  }
];

Creating New Gradient Types

// src/utils/gradientGenerators/myGradient.js
export function generateMyGradient(colors, width, height, animationDuration) {
  // Your gradient logic here
}

🤝 Contributing

We welcome contributions! Here's how you can help improve this project:

Areas for Contribution

  • 🎨 New template designs and color palettes
  • ⚡ Additional gradient types and effects
  • 🖥️ UI/UX improvements and new features
  • 🔧 Performance optimizations
  • 📚 Documentation updates and examples
  • 🐛 Bug fixes and testing

Getting Started

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-template)
  3. Make your changes with proper documentation
  4. Test thoroughly across different devices
  5. Submit a pull request with clear description

For major changes, please open an issue first to discuss your ideas.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

Open Source Benefits:

  • ✅ Commercial use allowed
  • ✅ Modification allowed
  • ✅ Distribution allowed
  • ✅ Private use allowed

👥 Team

Chan Meng
Chan Meng

Creator & Lead Developer

🙋‍♀️ Author

Chan Meng


🌟 Ready to Create Something Amazing? 🌟

🎨 Start Creating | ⚙️ Advanced Editor | ⭐ Star on GitHub | 🐛 Report Issues


Made with ❤️ by Chan Meng

Transforming ideas into beautiful gradients, one SVG at a time.


About

【Be a star, give a star!⭐️】A Node.js service that generates animated gradient SVGs with customizable text overlays. Supports multiple gradient types, animation effects, and includes templates for both standard color schemes and pride flags. Deploy as an API endpoint to create dynamic, animated text displays with smooth gradient backgrounds.

Topics

Resources

License

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Sponsor this project

Packages

No packages published