gstats

GitHub stats cards for your README. Contributions, streaks and languages, rendered as SVG on the edge.

If it is useful to you, a star helps other people find it — github.com/rondrft/gstats.

Build your card

username

design terminal heatmap pass press gauge vinyl

theme phosphor amber ice mono light

locale en es

language mode bytes repos

languages shown 1 2 3 4 5 6 7 8

at most 8 here

modules

total streak best langs

options

scanlines animate credit bar style

colour overrides reset to theme

ring

accent

background

html markdown

copy

Every parameter. Anything invalid falls back to its default.

username	a GitHub login	required
card	terminal, heatmap, pass, press, gauge, vinyl	terminal
theme	phosphor, amber, ice, mono, light	phosphor
ring	hex — the contribution and record rings	theme
accent	hex — the streak ring and its icon	theme
bg	hex, or transparent	theme
text	hex — the numbers and language rows	theme
muted	hex — the labels	theme
border	hex, or none to hide the frame	theme
radius	corner radius, 0 to 24	6
hide	total, streak, best, langs — comma separated	nothing hidden
langs_count	at most this many, 1 to 8. Some designs draw fewer (press 4, gauge 4, vinyl 3, heatmap none), and so does a profile whose remaining languages are under 0.5% or on the by-product list — include_langs brings those back	4
lang_mode	bytes, or repos to count what each language leads	bytes
exclude_langs	languages to drop, comma separated	none
include_langs	bring back HTML, CSS, Shell and the rest	none
lang_style	blocks or bars	blocks
scanlines	CRT banding over the background	true
animate	draw-on animation	true
locale	label language: en or es	en
tz	IANA zone the streak day ends in	Anywhere on Earth
show_credit	a small project credit on the card	false
cache_seconds	how long a client may reuse the card, 1800 to 86400	instance default

Designs and themes

Two independent axes. Pick a design and every theme below redraws in it; each cell loads the pairing into the generator above.

Before you embed this

This instance is best effort. It runs on one GitHub token with a shared budget of 5,000 requests per hour, and it is not on call for anyone. If your README matters to you, deploy your own — it takes about five minutes and gives you your own budget. Self-hosting guide.