Github Links

Dynamic GitHub Badges

Dynamic badges fetch live data from GitHub and display it as a badge.
They support metrics like stars, forks, downloads, commits, and more.

⚠️ Note
This package does not include icons.
Place your own SVGs (with fill="currentColor") in icons/, e.g. icons/star.svg.
Then reference them with /star/.

URL Structure

/github/{owner}/{repo}/{metric}/{style}/{icon}-{iconColor}/{lang}/{backgroundColorMessage}-{textColorMessage}/{backgroundLabelColor}-{textColorLabel}

Example URL	Rendered Badge
`/github/{owner}/{repo}/forks/flat/codefork-white/de/green-black/146eb4-white`

URL Input

You can use special placeholders for flexibility:

Input	Output	Example URL	Badge
Star (asterisk) `*`	Placeholder for default value	`/github/{owner}/{repo}/forks/flat/codefork-white//green-black/-white`

Metrics

⚠️ The following previews are demo outputs only.
Real values are generated dynamically from GitHub.

Metric	Description	Example Badge
`stars`	Number of stars of the repo (`-all` = all public repos)
`license`	License of the repository
`forks`	Number of forks (`-all` = all repos)
`downloads`	Number of downloads (`-latest` latest release, `-all` across all repos)
`issues`	Issues of a repo (`-open` open issues, `-closed` closed issues)
`issues_all`	Issues across all repos
`top_language`	Main language of the repo
`top_language_count-2`	Top 2 languages of the repo (default = 1)
`top_languages_all-2`	Top 2 languages across all repos (default = 1)
`created_at`	Repo creation date
`size`	Repo size in KB
`size_all`	Total repo sizes (all repos)
`push`	Date latest Push (`-time`, `-datetime`, `-lines`, `-info`)
`commit`	Date latest Commit (`-time`, `-datetime`, `-lines`, `-info`)
`lines`	Lines of code (`-added`, `-deleted`)
`milestones`	Repo milestones (`-open`, `-closed`, `-all`)
`release`	Latest release
`releases`	Release count
`watchers`	Repo watchers
`watchers_all`	Watchers across all repos
`repos_count`	Public repos count
`prs`	Pull requests (`-all`, `-merged`, `-mergedall`)
`successrate`	PR merge success rate (`-all` for all repos)
`subscribers`	Subscribers (`-all` for all repos)
`branches`	Branch count (`-all` for all repos)
`files`	Files count (`-all` for all repos)
`projects`	Projects count (`-all` for all repos)
`tags`	Tags count (`-all` for all repos)
`follower`	Followers
`following`	Following
`checkversion@`	Check if given version is up-to-date
`gists`	Gists stats (`-date`, `-forks`, `-list1`, `-listall`)
`sponsors`	Shows the number of sponsors (API only)
`commits`	Output all commits of a repo (`@branchname`, `-all`, `-last`, `-last-info`)
`codesize`	Code size of a repo (`-all`) (only the default branch)
Profil	(API only)
`name`	Displays the profile name
`company`	Displays your Company
`location`	Displays your Location
`status`	Displays your Status
`createdAt`	Display date of account creation (`-since`)
`updatedAt`	Display date of account updated (`-since`)