Beautiful Stats
for your README
Auto-updating GitHub profile stats — projects, commits, issues, PRs, orgs and more. Set up in 60 seconds.
Everything in your README,
automatically.
Drop 7 comment markers into your README. The workflow fills them in every 6 hours.
Auto-refreshes every 6 hours
A GitHub Actions workflow runs on a schedule. Your README is always up-to-date without lifting a finger.
Your PAT never leaves GitHub
Your Personal Access Token is stored as a repo secret, encrypted by GitHub. The stats website uses only the public GitHub API.
Fully customisable sections
Choose which sections to include, how many repos to show, and whether to display orgs, issues, and PRs.
Public stats dashboard
Share stuffzez.github.io/Stats/stats.html?user=YOU — a live dashboard using only public data.
One-click setup
Enter your PAT, pick your options, and we generate the exact YAML and README markers you need to paste.
Shields.io + readme-stats
Uses industry-standard badge services so everything looks great on both light and dark GitHub themes.
Ready in 60 seconds.
Fill in the form to generate your personalised workflow file and README markers.
Create a PAT
GitHub → Settings → Developer Settings → Fine-grained tokens. Grant Contents: Read/Write + Metadata: Read on your profile repo.
Fill in the form →
Enter your username, paste your PAT, and choose which sections to include.
Copy the workflow file
Create .github/workflows/update-readme.yml in your profile repo and paste it in.
Add the secret
Repo Settings → Secrets → Actions → New secret. Name: GH_PAT, value: your token.
Add markers to README
Paste the generated comment markers wherever you want each section. Run the workflow manually to test.
⚙️ Generate Your Config
View anyone's stats.
The stats page uses only GitHub's public API — no PAT needed. Works for any public profile.
Or share your stats page: stuffzez.github.io/Stats/stats.html?user=YOUR_USERNAME