Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/pujux/badge-it

An API serving useful badges for your GitHub Profile README 🚀🎉 Formerly known as git-badges.
https://github.com/pujux/badge-it

badges documentation github-readme readme

Last synced: 6 days ago
JSON representation

An API serving useful badges for your GitHub Profile README 🚀🎉 Formerly known as git-badges.

Awesome Lists containing this project

README

        

# Badge-It

[![GitHub stars](https://img.shields.io/github/stars/pujux/badge-it?color=brightgreen)](https://github.com/pujux/badge-it/stargazers)
[![GitHub issues](https://img.shields.io/github/issues/pujux/badge-it?color=brightgreen)](https://github.com/pujux/badge-it/issues)
[![GitHub forks](https://img.shields.io/github/forks/pujux/badge-it?color=brightgreen)](https://github.com/pujux/badge-it/network)
[![GitHub license](https://img.shields.io/github/license/pujux/badge-it?color=brightgreen)](https://github.com/pujux/badge-it/blob/main/LICENSE)
[![Twitter](https://img.shields.io/twitter/url?url=https%3A%2F%2Fgithub.com%2Fpujux%2Fbadge-it)](https://twitter.com/intent/tweet?text=Wow:&url=https%3A%2F%2Fgithub.com%2Fpujux%2Fbadge-it)

## Table of Contents

- [Usage](#available-badges-🔥)
- [Ideas](#got-an-idea-for-a-badge-)
- [License](#license)

## Available badges 🔥

All endpoints support the parameters you can also use for [shields.io](https://shields.io) badges, you can check out their style documentation [here](https://shields.io/#styles).

Visits Badge


Visits Badge


Returns a badge containing the visitor counter for your repository



Endpoint

https://badges.pufler.dev/visits/{username}/{repo}



Markdown

[![Visits Badge](https://badges.pufler.dev/visits/pujux/badge-it)](https://badges.pufler.dev)

---

Years Badge


Years Badge


Returns a badge containing the number of years you have been a member



Endpoint

https://badges.pufler.dev/years/{username}



Markdown

[![Years Badge](https://badges.pufler.dev/years/pujux)](https://badges.pufler.dev)

---

Repos Badge


Repos Badge


Returns a badge containing the number of your public repositories



Endpoint

https://badges.pufler.dev/repos/{username}



Markdown

[![Repos Badge](https://badges.pufler.dev/repos/pujux)](https://badges.pufler.dev)

---

Gists Badge


Gists Badge


Returns a badge containing the number of your public gists



Endpoint

https://badges.pufler.dev/gists/{username}



Markdown

[![Gists Badge](https://badges.pufler.dev/gists/pujux)](https://badges.pufler.dev)

---

Updated Badge


Updated Badge


Returns a badge that shows when the repository was last updated



Endpoint

https://badges.pufler.dev/updated/{username}/{repo}



Markdown

[![Updated Badge](https://badges.pufler.dev/updated/pujux/badge-it)](https://badges.pufler.dev)

---

Created Badge


Created Badge


Returns a badge that shows when the repository was created



Endpoint

https://badges.pufler.dev/created/{username}/{repo}



Markdown

[![Created Badge](https://badges.pufler.dev/created/pujux/badge-it)](https://badges.pufler.dev)

---

Commits Badge


Commits Badge


Returns a badge that shows the number of commits you have published in a specified periodicity (yearly, monthly, weekly, daily or all)



Endpoint

https://badges.pufler.dev/commits/{periodicity}/{username}



Markdown

[![Commits Badge](https://badges.pufler.dev/commits/monthly/pujux)](https://badges.pufler.dev)

---

Contributors Display


Contributors Display


Returns an SVG that displays all contributors of the specified repository


You can specify size in pixels that will be used for each avatar, padding in pixels that will be used between the avatars, perRow to control how many avatars are shown per row and bots as either 'true' or 'false' to hide bot contributors



Endpoint

https://badges.pufler.dev/contributors/{user}/{repo}?size={number}&padding={number}&perRow={number}&bots={boolean}



Markdown

[![Contributors Display](https://badges.pufler.dev/contributors/pujux/badge-it?size=50&padding=5&perRow=10&bots=true)](https://badges.pufler.dev)

---

Last Stars Display


Last Stars Display


Returns an SVG that displays the last starred repositories of the specified user


You can specify count to control how many starred repositories will be shown, padding in pixels that will be used between the repositories and perRow to control how many repositories will be shown per row



Endpoint

https://badges.pufler.dev/last-stars/{user}?count={number}&padding={number}&perRow={number}



Markdown

[![Last Stars Display](https://badges.pufler.dev/last-stars/pujux?count=6&padding=15&perRow=3)](https://badges.pufler.dev)

## Got an idea for a badge? 😀

Create an [issue](https://github.com/pujux/badge-it/issues/new)!

## License

Badge-It is licensed under the [BSD 3-Clause License](LICENSE).