Terms of Use

Last updated: 19 March 2026

Agreement

By accessing or using BarBuilder ("the Service"), available at barbuilder.dev, you agree to these terms. If you do not agree, please do not use the Service.

Description of Service

BarBuilder is a free, open-source API that generates SVG progress bar images from URL parameters. The Service includes:

  • The SVG generation API at api.barbuilder.dev
  • The web-based visual builder at barbuilder.dev/builder
  • Documentation and guides

Permitted Use

You may use BarBuilder for any lawful purpose, including personal, commercial, and open-source projects. No account or API key is required.

Typical uses include:

  • Embedding progress bars in GitHub READMEs and documentation
  • Displaying status indicators on websites and dashboards
  • Generating badges for CI/CD pipelines
  • Any other use that embeds SVG images via URL

Prohibited Use

You may not:

  • Abuse the Service — send excessive automated requests designed to degrade performance for other users
  • Circumvent rate limits — deliberately bypass rate limiting mechanisms
  • Inject malicious content — attempt to exploit URL parameters for XSS, injection, or other attacks
  • Misrepresent the Service — imply that BarBuilder endorses or is affiliated with your product or organisation
  • Redistribute the API — proxy, mirror, or resell the API as your own service (forking the open-source code for self-hosting is fine)

Rate Limiting

To ensure fair access for all users, the API enforces rate limits on cache misses. Cached responses (the vast majority of requests) are unlimited. If you exceed rate limits, you will receive a 429 Too Many Requests response with a Retry-After header.

If you anticipate high-volume usage, consider self-hosting using the open-source code.

Availability & Warranty

BarBuilder is provided "as is" and "as available", without warranty of any kind, express or implied, including but not limited to warranties of merchantability, fitness for a particular purpose, or non-infringement.

We make reasonable efforts to keep the Service running reliably, but we do not guarantee:

  • Uninterrupted or error-free operation
  • Any specific level of uptime or availability
  • That the Service will continue to exist indefinitely

If the Service is discontinued, we will make reasonable efforts to provide advance notice.

Limitation of Liability

To the fullest extent permitted by law, BarBuilder and its contributors shall not be liable for any indirect, incidental, special, consequential, or punitive damages, or any loss of profits or revenue, whether incurred directly or indirectly, arising from your use of the Service.

Our total liability for any claim arising from or relating to the Service shall not exceed the amount you paid to use the Service (which is zero).

Intellectual Property

Our code

The BarBuilder source code is released under the MIT Licence. You are free to fork, modify, and self-host it.

Generated SVGs

SVG images generated by the API are not copyrighted by us. You may use them freely without attribution. Icon shapes are derived from Bootstrap Icons, which are released under the MIT Licence.

Your content

Any text you pass as labels or parameters remains yours. We do not claim ownership of content you generate through the Service.

Open Source

BarBuilder is an open-source project. The source code is available at github.com/chrisgorvan/barbuilder.dev. Contributions are welcome under the terms of the MIT Licence.

Changes to These Terms

We may update these terms from time to time. Changes will be posted on this page with an updated "Last updated" date. Continued use of the Service after changes constitutes acceptance of the revised terms.

Contact

If you have questions about these terms, please open an issue on our GitHub repository.