GitHub Profile Stats -- mini badges, sparklines, and badge styles

Free, real-time GitHub stat cards, badges, and charts -- drop a URL into your README and you're done. No tokens, no setup.

ghstats.dev

Star History

---

Copy-paste gallery

Standard card

[![](https://ghstats.dev/api/card?username=YOUR_USERNAME&theme=tokyonight)](https://github.com/rowkav09/GitHub-profile-stats)

Compact grids (3 / 4 / 6)

[![](https://ghstats.dev/api/card?username=YOUR_USERNAME&theme=radical&size=compact&compact_count=3)](https://github.com/rowkav09/GitHub-profile-stats)
[![](https://ghstats.dev/api/card?username=YOUR_USERNAME&theme=catppuccin&size=compact&compact_count=4)](https://github.com/rowkav09/GitHub-profile-stats)
[![](https://ghstats.dev/api/card?username=YOUR_USERNAME&theme=forest&size=compact&compact_count=6)](https://github.com/rowkav09/GitHub-profile-stats)

Languages (bar, stacked, grid, horizontal list, vertical list)

[![](https://ghstats.dev/api/langs?username=YOUR_USERNAME&theme=dracula&layout=bar)](https://github.com/rowkav09/GitHub-profile-stats)
[![](https://ghstats.dev/api/langs?username=YOUR_USERNAME&theme=ocean&layout=stacked)](https://github.com/rowkav09/GitHub-profile-stats)
[![](https://ghstats.dev/api/langs?username=YOUR_USERNAME&theme=radical&layout=horizontal_list)](https://github.com/rowkav09/GitHub-profile-stats)
[![](https://ghstats.dev/api/langs?username=YOUR_USERNAME&theme=catppuccin&layout=vertical_list)](https://github.com/rowkav09/GitHub-profile-stats)
[![](https://ghstats.dev/api/langs?username=YOUR_USERNAME&theme=tokyonight&layout=grid)](https://github.com/rowkav09/GitHub-profile-stats)

Mini badges (drop anywhere)

Any metric, any colour, any style -- perfect for sprinkling through a README.

[![](https://ghstats.dev/api/mini?username=YOUR_USERNAME&metric=stars&style=for-the-badge)](https://github.com/rowkav09/GitHub-profile-stats)
[![](https://ghstats.dev/api/mini?username=YOUR_USERNAME&metric=commits&color=0ea5e9&style=for-the-badge)](https://github.com/rowkav09/GitHub-profile-stats)
[![](https://ghstats.dev/api/mini?username=YOUR_USERNAME&metric=streak&color=f97316&style=for-the-badge)](https://github.com/rowkav09/GitHub-profile-stats)
[![](https://ghstats.dev/api/mini?username=YOUR_USERNAME&metric=followers&label=Community&color=22c55e&style=for-the-badge)](https://github.com/rowkav09/GitHub-profile-stats)

Pass label=... to override the default label text and style=... to switch between flat, flat-square, for-the-badge, plastic, and minimal (see the table below).

Badge styles -- pick a look

Style	Preview
flat
flat-square
for-the-badge
plastic
minimal

Apply with ?style=for-the-badge on /api/mini or /api/badge. Works alongside color and label.

Activity sparkline (7--90 days)

[![](https://ghstats.dev/api/sparkline?username=YOUR_USERNAME&days=30&width=420)](https://github.com/rowkav09/GitHub-profile-stats)

Quick colour override

https://ghstats.dev/api/card?username=YOUR_USERNAME&bg=0f0f23&text=cccccc&title_color=ffff66&icon_color=ff6644

---

30-second setup

1. Create a public repo named your-username on GitHub and add a README.md.
2. Paste an embed from the gallery above. Done.

Need tweaks? Use the on-page editor to toggle stats, themes, borders, titles, and copy Markdown/HTML instantly.

---

Options cheat sheet

Card ( /api/card )

• username (required)
• theme default default
• Layout: size=default|compact, compact_count=3|4|6, show_emoji=true
• Visibility: hide=stars,issues,..., show_ring, show_icons, hide_title, hide_border
• Styling: bg, text, title_color, icon_color, border_color, border_radius, custom_title, order

Languages ( /api/langs )

• layout=bar|stacked|horizontal_list|vertical_list|grid, max_langs (1--12)
• hide_border, hide_title, custom_title, border_radius, theme overrides as above

Mini badges ( /api/mini )

• metric=stars|commits|prs|issues|hours|streak|week|followers|repos|contributions
• label (override text), color (value side), theme (for errors)
• style=flat|flat-square|for-the-badge|plastic|minimal (default flat)

Counter badge ( /api/badge )

• style=flat|flat-square|for-the-badge|plastic|minimal (default flat)

Visits badge ( /api/visits )

• style=flat|flat-square|for-the-badge|plastic|minimal (default flat)

Note: hours is currently WIP and is an estimate, not exact tracked coding time.

Sparkline ( /api/sparkline )

• days (7--90), width (180--800), height (40--240), line_color, fill_color, title, hide_border, border_radius

---

Themes

Default, Light, Radical, Tokyo Night, Dracula, Nord, Gruvbox, Catppuccin, Ocean, Sunset, Forest, Midnight, Night Owl, Solarized, Ayu, Rose Pine, Kanagawa, Material Palenight.

---

FAQ

• Token needed? Yes -- the GitHub GraphQL API requires a valid token. Set GITHUB_TOKEN, GH_TOKEN, or GITHUB_ACCESS_TOKEN.
• Refresh rate? Tiered by endpoint so slower-moving badges can stay cached longer while activity-focused embeds refresh sooner.
• Free? Yes. MIT licensed.
• Where to tweak without URLs? ghstats.dev/builder.

Cache policy

• /api/card and activity-oriented mini badges (commits, prs, issues, streak, week, contributions) are cached for about 30 minutes at the edge.
• /api/langs, /api/badge, and slower-moving mini badges like followers and repos are cached for about 6 hours at the edge.
• stars mini badges are cached for about 24 hours at the edge.
• /api/visits is intentionally uncached so counters increment on every request.

---

Contributing & support

• PRs welcome -- see CONTRIBUTING.md.
• Like it? Drop a star on the repo: GitHub.

---

License

MIT