How do I add a GitHub stats card to my profile README?

Enter your GitHub username in the generator, pick a theme and size, toggle which stats to show, then copy the generated Markdown snippet and paste it into your profile README.md file.

How often are the GitHub statistics refreshed?

Stats are cached for 30 minutes per user to keep load times fast and stay within GitHub's API rate limits, so your commits and stars stay up to date without slowing the card down.

Which themes are supported by this GitHub stats generator?

50+ themes are supported, including Radical, Dracula, Nord, Gruvbox, Tokyo Night, Synthwave, Monokai, Solarized (light and dark), One Dark, and several flag-inspired themes.

Can I hide specific stats, like pull requests or the grade ring?

Yes. Every row on the card — name, grade ring, stars, commits, pull requests, issues, contributed-to, and account age — has its own toggle, so you can show exactly the stats you want.

Is this GitHub stats card generator free to use?

Yes, it's completely free. Previewing and copying the embed code is free; star the GitHub repository to keep your README card showing live stats.

README cards · 100+ themes · live GraphQL data

Dynamic GitHub Stats Generator for Profile README

Generate real-time stats cards for your GitHub profile README. Pick from over 100 dark & light themes, choose which stats to show, preview it instantly and copy the embed code. No sign-up.

How to Add GitHub Stats to Your Profile README in 3 Steps

Turn your GitHub profile into a live developer portfolio.

Enter GitHub Username

Type your GitHub handle into the input box above. The API queries GitHub's GraphQL engine for your contributions, repositories, stars, and commits.

Customize Theme & Metrics

Select from over 100 developer-favorite themes like Catppuccin, Dracula, or Tokyo Night. Toggle specific stats on or off to tailor the card.

Copy & Paste Embed Code

Click "Copy" on the Markdown snippet and paste it into your special GitHub profile repository (yourname/yourname/README.md). It updates automatically.

Why Developers Choose Insane GitHub Stats Generator

An open-source stats card generator that stays out of your way.

100+ Aesthetic Themes

From Catppuccin Mocha to Cyberpunk 2077, Nord, and Monokai Pro, match your exact code editor syntax and terminal palette.

Real-Time GraphQL Data

Fetches commit counts, PRs, opened issues, stars received, and repositories contributed to via the official GitHub APIs.

Grade Ring & Work Profile

An S+ to C grade from your activity, plus a plain-language verdict (Excellent to Very Bad) and an estimated Top % ranking.

Crisp Vector SVG

Pure SVG with embedded typography and scalable curves. Looks pin-sharp on high-DPI, Retina, and 4K screens.

Granular Visibility Toggles

Enable or disable any row, and choose whether stars from repos you contributed to count toward your total.

Edge Caching & Zero Setup

30-minute edge caching avoids GitHub API rate limits while keeping every README load fast.

Explore Popular Themes

Click any theme to preview it on your card:

Frequently Asked Questions

Everything you need to know about GitHub stats cards and profile README optimization.

How do I add the stats card to my GitHub README?

Copy the Markdown snippet from the output section above and paste it anywhere in your personal README.md inside your special username repository. GitHub renders the SVG automatically.

How often do my GitHub stats refresh?

Stats are cached at the edge for 30 minutes. That keeps images fast in your README, protects against GitHub rate limits, and still refreshes every half hour.

Do I need to star the repository?

Previewing and copying the embed code is free. The card in your README shows a short star prompt until you star the repo, then switches to your live stats. It's free and open-source, and stars help other developers find it.

Does it count private commits and contributions?

GitHub only reveals public stats to external APIs by default. To include private contributions, enable "Include private contributions on my profile" in your GitHub profile settings.

Can I use this card on personal portfolio websites?

Yes. Both Markdown and raw HTML <img> embeds are provided, so it works in Next.js, React, Astro, Hugo, WordPress, or plain HTML.

How are the grade, Work Profile and Top % calculated?

A weighted score from stars, commits, pull requests, issues and repos contributed to sets the grade (C to S+). The Work Profile maps that grade to a verdict from Very Bad to Excellent, and Top % is an estimate scaled from the score, not a global leaderboard.