Quick Start
Embed a real-time badge in your profiles or projects. Just replace USERNAME with a GitHub username.
http://github-commit-badge-api.vercel.app/commits?account=USERNAME
Live example for "octocat":
Interactive Badge Builder
Use the controls below to customize your badge in real-time. The URL will update automatically.
/commits?account=octocat&theme=dark
Parameter Reference
Combine these query parameters to further customize your badge.
Core
account GitHub username (required).
period Values: week, month, quarter, half, year.
Appearance
theme Select from a list of color presets.
style Badge shape and style. Values: flat, plastic, etc.
color Custom hex color (e.g., 4f46e5) to override theme.
Enhancements
icon Values: fire, rocket, trophy, etc.
animated Values: pulse, glow, slide.
sparkline Show mini activity graph (true).
border Enable border outline (true).
Theme Gallery & Examples
Dracula & Rocket
?theme=dracula&icon=rocket
Gradient & Sparkline
?theme=gradient&sparkline=true
Neon with Glow
?theme=neon&animated=glow
For The Badge Style
?theme=ocean&style=for-the-badge