Skip to content

Jemeni11/Gradie

Repository files navigation


Logo

Gradie

Turn any image into a vibe.
Explore the repo »

Table of Contents

Introduction

Gradie is a design tool that extracts the most prominent colors from an image and turns them into a smooth, beautiful gradient.

(back to top)

Features

These features can change at any time. Their existence depends on me having enough time or motivation to implement them all tbh.

  • 🖼️ Upload or paste any image (drag & drop, file select, camera on mobile, or paste directly)
  • 🎨 Extracts dominant colors from the uploaded image
  • 🌈 Creates a smooth gradient using the extracted palette
  • 🔄 Multiple gradient types (linear, radial, conic)
  • 🎯 Advanced gradient controls (angle adjustment, radial shapes, positioning)
  • 🔧 Offers multiple gradient strategies, detailed below
  • 📁 Works with uploaded files or pasted images
  • 📋 Copy gradient as CSS
  • ⚙️ Download gradient as image
  • ⚠️ Smart error handling and file validation

(back to top)

How It Works

  1. You upload or paste an image.
  2. Gradie extracts a palette of the most prominent colors.
  3. The first color in the palette is considered the dominant color.
  4. You choose a Gradie Mode (see Modes for all modes).
  5. Customize your gradient with advanced controls like angle, position, and shape options.
  6. Gradie generates a smooth gradient using your selection.
  7. You export it as CSS or download the image.

(back to top)

Modes

Gradie supports several modes for generating gradients from your image. Each one starts with the most prominent color (palette[0]) and builds from there.

Mode Name Description
Default Most prominent color + second-most prominent.
Surprise Me! Most prominent color + a random pick from the rest of the palette.
Bold Pop Most prominent color + the most visually contrasting color in the palette. Great for high-impact, energetic gradients.
Soft Sweep Most prominent color + the palette color with the most different hue.
Full Blend Uses all five palette colors to create a multi-stop gradient.
Custom You choose any two colors from the extracted palette to create your own combo.

(back to top)

Built With

(back to top)

Why did I build this?

I saw a nice-looking image, thought the colors in it would look nice as a gradient background, and here we are!

(The image is the cover art for mike's the lows. album, if you're wondering 🫡)

(back to top)

Contributing

Contributions are welcome! If you'd like to improve Gradie, please feel free to submit a pull request.

(back to top)

Wait a minute, who are you?

Hello there! I'm Emmanuel Jemeni, and I am a Frontend Developer.

You can find me on various platforms:

If you'd like, you can support me on GitHub Sponsors or Buy Me A Coffee.

(back to top)

License

MIT License

(back to top)

Changelog

Changelog

(back to top)

Releases

No releases published

Sponsor this project

  •  

Packages

No packages published

Contributors 2

  •  
  •