About this project
GitHub Readme Stats generates dynamic stat cards for GitHub profile READMEs. Originally the most popular tool of its kind, it has been archived in favor of the actively maintained fork GitHub Stats Extended.
The original project offered several card types:
- **Stats Card**: Displays profile-level GitHub metrics including commits, stars, pull requests, issues, repositories, and followers. Supports themes, icons, custom colors, locale translations (50+ languages), rank display, and year filtering for commits.
- **Top Languages Card**: Shows a user's most-used programming languages across repositories with multiple layout options (horizontal bars, compact, donut, pie, vertical donut). Note: this measures code presence on GitHub, not skill level.
- **Extra Pins Card**: Allows pinning more than the standard 6 repositories via README embeds.
- **Gist Pins Card**: Pins Gists to your profile in README format.
- **WakaTime Stats Card**: Displays coding activity from WakaTime integration.
All cards are served through a URL API with extensive customization parameters including colors, themes, border radius, cache duration, and language locale. The public Vercel instance at `github-readme-stats.vercel.app` is best-effort and may be unreliable during traffic spikes. Users are encouraged to self-host via GitHub Actions or Vercel for production use.
Deployment requires a GitHub Personal Access Token for private repo visibility. The project was built with Node.js and deployed on Vercel.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.