https://github.com/guibranco/progressbar
🚀📊 Generates a dynamic progress bar image in SVG format, perfect for badges, dashboards, and visual indicators. Customize colors, sizes, and progress values with ease!
https://github.com/guibranco/progressbar
dynamic dynamic-progress-bar flask hacktoberfest progress progress-bar progressbar python svg
Last synced: 3 months ago
JSON representation
🚀📊 Generates a dynamic progress bar image in SVG format, perfect for badges, dashboards, and visual indicators. Customize colors, sizes, and progress values with ease!
- Host: GitHub
- URL: https://github.com/guibranco/progressbar
- Owner: guibranco
- License: mit
- Created: 2024-08-09T23:01:11.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-04-14T11:48:09.000Z (3 months ago)
- Last Synced: 2025-04-14T12:47:00.132Z (3 months ago)
- Topics: dynamic, dynamic-progress-bar, flask, hacktoberfest, progress, progress-bar, progressbar, python, svg
- Language: Python
- Homepage: http://guilherme.stracini.com.br/progressbar/
- Size: 91.8 KB
- Stars: 63
- Watchers: 1
- Forks: 12
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🚀 Dynamic Progress Bar
Generates a **dynamic progress bar image** (SVG) using **Python**, deployed freely via **Vercel**.
📊 **Preview:**
  
Inspired by [](https://github.com/fredericojordan/progress-bar).
---
## 🔥 Other Projects
- ⭐ [](https://github.com/GoulartNogueira/Star-Rating) **Dynamic Star Rating** - [](https://github.com/GoulartNogueira/Star-Rating)
---
## 🛠️ Usage
This service is deployed on **[Vercel](https://vercel.com)** and accessible via the domain **[progress-bar.xyz](https://progress-bar.xyz)**.
---
## ⚙️ Parameters
| 🔧 Parameter | 📜 Description | 🎯 Default Value |
| ----------------------- | -------------------------------------------------------------------------- | --------------------- |
| `title` | Adds a title to the progress bar | None |
| `scale` | The maximum value that the progress bar represents | 100 |
| `prefix` | A string to add before the progress number | None |
| `suffix` | A string to add after the progress number | `%` |
| `width` | The width of the progress bar in pixels | 100 |
| `color` | The color of the progress bar (hex code without `#`) | `00ff00` (green) |
| `progress_background` | The background color of the progress bar (hex code without `#`) | `ffffff` (white) |
| `progress_number_color` | The color of the progress number (hex code without `#`) | `000000` (black) |
| `progress_color` | The color of the progress bar (hex code without `#`) | Depends on percentage |
| `show_text` | Whether to display or hide the progress text | `true` |
| `style` | The style. One of: `default`, `flat`, `square`, `plastic`, `for-the-badge` | `default` |### Examples
Below are several examples showcasing different ways to generate progress bars.
| 📌 Preview | 🌐 URL |
| ------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|  | [https://progress-bar.xyz/28/](https://progress-bar.xyz/28/) |
|  | [https://progress-bar.xyz/28/?title=progress](https://progress-bar.xyz/28/?title=progress) |
|  | [https://progress-bar.xyz/58/](https://progress-bar.xyz/58/) |
|  | [https://progress-bar.xyz/58/?title=completed](https://progress-bar.xyz/58/?title=completed) |
|  | [https://progress-bar.xyz/91/](https://progress-bar.xyz/91/) |
|  | [https://progress-bar.xyz/91/?title=done](https://progress-bar.xyz/91/?title=done) |
|  | [https://progress-bar.xyz/180/?scale=10&title=mark&prefix=R$&suffix=](https://progress-bar.xyz/180/?scale=10&title=mark&prefix=R$&suffix=) |
|  | [https://progress-bar.xyz/420/?scale=500&title=funds&width=200&color=babaca&prefix=R$&suffix=](https://progress-bar.xyz/420/?scale=500&title=funds&width=200&color=babaca&prefix=R$&suffix=) |
|  | [https://progress-bar.xyz/7/?scale=10&title=mark&suffix=X](https://progress-bar.xyz/7/?scale=10&title=mark&suffix=X) |
|  | [https://progress-bar.xyz/420/?scale=500&title=funds&width=200&color=babaca&suffix=$](https://progress-bar.xyz/420/?scale=500&title=funds&width=200&color=babaca&suffix=$) |
|  | [https://progress-bar.xyz/58/?title=colorful&progress_background=ffc0cb&progress_number_color=000](https://progress-bar.xyz/58/?title=colorful&progress_background=ffc0cb&progress_number_color=000) |
|  | [https://progress-bar.xyz/100/?progress_color=ff3300](https://progress-bar.xyz/100/?progress_color=ff3300) |
|  | [https://progress-bar.xyz/100/?width=100&title=Fixed+color&progress_color=ff3300](https://progress-bar.xyz/100/?width=100&title=Fixed+color&progress_color=ff3300) |
|  | [https://progress-bar.xyz/28/?show_text=false](https://progress-bar.xyz/28/?show_text=false) |
|  | [https://progress-bar.xyz/90/?show_text=false](https://progress-bar.xyz/90/?show_text=false) |---
## 🎨 Styles
We currently support:
| 🎨 Style | 📌 Preview | 🌐 URL |
| --------------------- | -------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
| 🟢 **flat** (default) |  | [https://progress-bar.xyz/100/?style=flat](https://progress-bar.xyz/100/?style=flat) |
| 🔲 **square** |  | [https://progress-bar.xyz/100/?style=square](https://progress-bar.xyz/100/?style=square) |
| 🛡️ **plastic** |  | [https://progress-bar.xyz/100/?style=plastic](https://progress-bar.xyz/100/?style=plastic) |
| 🔖 **for-the-badge** |  | [https://progress-bar.xyz/100/?style=for-the-badge](https://progress-bar.xyz/100/?style=for-the-badge) |
| 🎭 **thin-rounded** (WIP) |  | [https://progress-bar.xyz/100/?style=thin-rounded](https://progress-bar.xyz/100/?style=thin-rounded) |
| 🪞 **neo-glass** (WIP) |  | [https://progress-bar.xyz/100/?style=neo-glass](https://progress-bar.xyz/100/?style=neo-glass) |
| 🎨 **minimal-matte** (WIP) |  | [https://progress-bar.xyz/100/?style=minimal-matte](https://progress-bar.xyz/100/?style=minimal-matte) |---
## 🚀 Deployment
Deploy this project to **Vercel** with a single click:
[](https://vercel.com/import/project?template=https://github.com/guibranco/progressbar)
---
## 🤝 Contributing
Check out [CONTRIBUTING.md](CONTRIBUTING.md) to learn how to contribute!
### 👥 Contributors
![]()
Guilherme Branco Stracini
![]()
ztest95
![]()
David Nwosu
![]()
Eduardo Baptista
![]()
bhosley
### 🤖 Bots
![]()
dependabot[bot]
![]()
github-actions[bot]
![]()
penify-dev[bot]
![]()
Snyk bot
---
## 📜 License
This project is licensed under the **MIT License**.
📄 See [LICENSE](LICENSE) for details.