GitHub Readme Stats is an open-source tool that generates dynamic, visually customizable SVG cards showcasing GitHub metrics such as stars, commits, languages, and contributions, which can be embedded into profile README files. With inbuilt themes, you can customize the look of the card without doing any manual customization. You can specify a year and fetch only the commits that were made in that year by passing &commits_year=YYYY to the parameter. You can look at a preview for all available themes or checkout the theme config file. Please note that we paused the addition of new themes to decrease maintenance efforts; all pull requests related to new themes will be closed.

Features

  • Generates SVG stat cards for GitHub activity: stars, PRs, issues, etc.
  • Provides themed visuals including dark, radical, merko, gruvbox, synthwave, and more
  • Customization via URL parameters for layout, icons, background, transparency
  • Client-side theme toggling support (light/dark) and responsive cards
  • Caching and rate-limit handling for Vercel-hosted API, with self-hosting options
  • Simplifies README enhancement for developer profiles with live metrics

Project Samples

Project Activity

See All Activity >

Categories

Documentation

License

MIT License

Follow GitHub Readme Stats

GitHub Readme Stats Web Site

Other Useful Business Software
Paessler - Monitor Your Whole Network in Minutes Icon
Paessler - Monitor Your Whole Network in Minutes

Auto-discovery finds your devices and deploys pre-configured sensors instantly. No project plan required, just visibility from day one.

Waiting weeks for a monitoring rollout isn't an option when infrastructure doesn't stop running. PRTG's auto-discovery scans your network and suggests from over 200 pre-configured sensor types, so you're watching servers, applications and devices within minutes, not after a multi-week deployment. Enterprise-strength monitoring, without the enterprise complexity. Start your free trial today.
Start Free 30-Day Trial
Rate This Project
Login To Rate This Project

User Reviews

Be the first to post a review of GitHub Readme Stats!

Additional Project Details

Programming Language

JavaScript

Related Categories

JavaScript Documentation Software

Registered

2025-08-08