badges / badges/shields

Badge request: GitHub activity, per branch

Open
#714 3 comments 10 reactions 0 assignees View on GitHub
good first issue service-badge
Dominant language
JavaScript
Stars
27.2k
Forks
5.6k
Avg merge
1d 8h
Merged PRs (30d)
46

Description

When I'm in the middle of a large re-write on a project, I'd really like to have an obvious “activity is happening ” indicator for the README on the stable / master / production branch. I think a shield could serve this purpose admirably.

There's a couple possibilities I see here, any of which (or all!) could be best implemented:
1. Showing date of the latest commit to the project and/or to that branch, i.e.
![](https://img.shields.io/badge/‘master’_active-yesterday-green.svg), ![](https://img.shields.io/badge/‘master’_active-Tuesday-green.svg), ![](https://img.shields.io/badge/‘develop’_active-last_week-green.svg), or ![](https://img.shields.io/badge/‘develop’_active-four_months_ago-yellowgreen.svg), ![](https://img.shields.io/badge/‘cool--feature’_active-last_year-lightgrey.svg):
`https://img.shields.io/github/activity/USER/REPO.svg`
`https://img.shields.io/github/activity/user/repo/BRANCH.svg`
2. Showing the name of the branch with the most (or most recent?) activity: i.e. ![](https://img.shields.io/badge/active_branch-develop-orange.svg), ![](https://img.shields.io/badge/active_branch-rewrite-orange.svg), etc etc:
`https://img.shields.io/github/active-branch/USER/REPO.svg`
`https://img.shields.io/github/active-branch/user/repo/BRANCH.svg`
3. Showing the number of ‘active’ branches, either by a time-range, or by whatever heuristic GitHub uses for the branches page (if that's exposed): i.e. ![](https://img.shields.io/badge/active_branches-3-green.svg), ![](https://img.shields.io/badge/active_branches-0-lightgrey.svg), etc etc:
`https://img.shields.io/github/active-branches/USER/REPO.svg`

(Could even combine `1.` and `2.` ![](https://img.shields.io/badge/active_branch-‘rewrite’_%28yesterday%29-green.svg), or `2.` and `3.` ![](https://img.shields.io/badge/active_branches-3_%28‘rewrite’%29-green.svg) although those are getting a little long!)

Contributor guide

Open the contributing guide

Research direction

Start by reviewing the three proposed GitHub badge URL forms in the issue and decide which activity behavior and branch semantics are in scope. Done means one clearly selected badge design is implemented with the corresponding GitHub data, documented usage, and verification for the expected activity states.

Written by the indexing model from the issue text.

Assessment

Tech stack
github, javascript
Domain
api, backend
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.