Skip to content

Repository files navigation

Progress Bars

A modern web service to generate and embed customizable progress bars anywhere! Create beautiful progress bars with an intuitive UI and embed them in your projects.

🌐 Try it live

Progress Bar Generator

Features

  • Interactive UI: Customize your progress bars with our user-friendly interface
  • Live Preview: See your changes in real-time
  • Dark/Light Mode: Switch between themes for comfortable editing
  • High Contrast Mode: Accessible editing for users with visual impairments
  • Preset Colors & Gradients: Choose from beautiful preset colors and gradient combinations
  • Multi-Color Support: Add multiple colors to create custom gradients
  • Background Gradients: Apply gradients to the background as well
  • Custom Styling: Adjust progress, color, background color, height, width, and border radius
  • Special Effects: Add striped and animated effects to your progress bars
  • Animated Gradients: Make gradients move and shimmer
  • Initial Animation: Control how the progress bar fills on first load
  • PNG & SVG Export: Choose between static PNG or animated SVG
  • Easy Embedding: Copy URL, Markdown, or HTML code with a single click

Quick Start

Simply use our URL with query parameters (supports .svg and .png extensions):

https://progress-bars.entcheneric.com/bar.svg?progress=75&color=%232563eb&width=800&height=50

Or visit our web interface to customize your progress bar visually.

API

GET Endpoint

Generate a progress bar via URL parameters:

GET /bar.svg?progress=75&color=%232563eb&width=800&height=50

POST Endpoint

Generate a progress bar via JSON body (useful for programmatic access):

POST /bar
Content-Type: application/json
{
"progress": 75,
"color": "#2563eb",
"width": 800,
"height": 50
}

Usage Examples

Basic Progress Bar (75% Complete)

https://progress-bars.entcheneric.com/bar.svg?progress=75&width=800&height=50

Basic Progress

Animated Gradient with Stripes

https://progress-bars.entcheneric.com/bar.svg?progress=75&width=800&height=50&colorGradient=red,blue,green&striped=true&animated=true&animationSpeed=1.5

Custom Styled Progress Bar

https://progress-bars.entcheneric.com/bar.svg?progress=80&color=%232563eb&backgroundColor=%23f8fafc&height=50&width=800&borderRadius=10&striped=true&animated=true&animationSpeed=1.5

Use in Markdown

![Progress](https://progress-bars.entcheneric.com/bar.svg?progress=75&color=%2316a34a&width=800&height=50)

Use in HTML

<imgsrc="https://progress-bars.entcheneric.com/bar.svg?progress=75&color=%232563eb&width=800&height=50" alt="Progress Bar">

Customization Parameters

All parameters are optional and have sensible defaults:

ParameterDefaultDescriptionExample
progress0Progress value (0-100)progress=75
color#2563ebColor of the progress bar (when not using gradient)color=%232563eb
colorGradient-Comma-separated colors for gradientcolorGradient=red,blue,green
backgroundColor#f3f4f6Background color of the barbackgroundColor=%23f8fafc
backgroundGradient-Comma-separated colors for background gradientbackgroundGradient=red,blue
height20Height in pixels (5-500)height=30
width200Width in pixels (10-3000)width=200
borderRadius10Border radius in pixels (0-1000)borderRadius=20
stripedfalseAdd striped effectstriped=true
animatedfalseAnimate the stripesanimated=true
gradientAnimatedfalseAnimate the gradientgradientAnimated=true
animationSpeed1Speed multiplier for stripe/pulse animationanimationSpeed=2.5
stripeAnimationSpeed1Speed multiplier for stripe animationstripeAnimationSpeed=2
gradientAnimationSpeed1Speed multiplier for gradient animationgradientAnimationSpeed=3
initialAnimationSpeed1Speed of initial fill animation (0 = instant)initialAnimationSpeed=0.5
formatsvgOutput format: svg or pngformat=png

Common Use Cases

GitHub README Progress

![Project Status](https://progress-bars.entcheneric.com/bar.svg?progress=80&color=%2316a34a&width=800&height=50)

Documentation Status

Documentation: ![60% Complete](https://progress-bars.entcheneric.com/bar.svg?progress=60&color=%23ea580c&width=800&height=50)

Project Milestones

Phase 1: ![Complete](https://progress-bars.entcheneric.com/bar.svg?progress=100&color=%2316a34a&width=800&height=50)
Phase 2: ![In Progress](https://progress-bars.entcheneric.com/bar.svg?progress=45&color=%232563eb&width=800&height=50)
Phase 3: ![Not Started](https://progress-bars.entcheneric.com/bar.svg?progress=0&color=%236b7280&width=800&height=50)

Tips

  • Use URL encoding for special characters in colors (e.g., %232563eb for #2563eb)
  • For gradients, you can use named colors (red, blue, green) or hex values
  • The service is stateless - perfect for dynamic content
  • Works in any environment that can display images from URLs
  • Use the web interface to visually design your perfect progress bar
  • Large widths (>1000px) may require horizontal scrolling in some containers
  • Choose PNG for platforms that don't support SVG animations (e.g., Discord, Slack)
  • Choose SVG for animated progress bars with stripe movement and gradient effects

Contributing

Feel free to contribute! Open issues and PRs are welcome.

License

MIT License - Use it anywhere you like!

Advanced Features

Gradient Colors

Use gradients instead of solid colors for more dynamic progress bars:

![Gradient Progress](https://progress-bars.entcheneric.com/bar.svg?progress=80&width=800&height=50&colorGradient=red,blue,green)

Animated Gradient

Make the gradient pan and shimmer:

![Animated Gradient](https://progress-bars.entcheneric.com/bar.svg?progress=75&width=800&height=50&colorGradient=red,blue&gradientAnimated=true)

Initial Animation

Control how the progress bar fills initially:

  • Set initialAnimationSpeed=0 for instant fill
  • Use higher values for faster fill animation
  • Use lower values for slower fill animation
![Animated Fill](https://progress-bars.entcheneric.com/bar.svg?progress=75&initialAnimationSpeed=0.5&width=800&height=50)

Animation Effects

The progress bar can have animated stripes that move:

  1. First enable stripes with striped=true
  2. Then add animation with animated=true
  3. Control the animation speed with animationSpeed (default: 1)
![Striped Animated](https://progress-bars.entcheneric.com/bar.svg?progress=75&striped=true&animated=true&animationSpeed=1.5&width=800&height=50)

Size Constraints

  • Height: 5px to 500px
  • Width: 10px to 3000px
  • Border Radius: 0px to 1000px (automatically adjusted for height)

Different Styles

High contrast: High Contrast

Extra rounded: Extra Rounded

Thin line: Thin Line

Sunset gradient with stripes: Sunset Gradient

About

A modern web service to generate and embed customizable progress bars anywhere!

Topics

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages