Skip to content

Dynamic stats for the individual repo (best view for all kind of user and especially HRs)

License

Notifications You must be signed in to change notification settings

Fewinfos/github-repo-readme-stats

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

251 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Banner Image

GitHub Repository Stats Widget

An open-source, fully client-side tool that visualizes real-time GitHub repository statistics in an interactive and customizable format β€” perfect for developers, open-source maintainers, and portfolio builders.


⭐ Repository Ranking System

The widget now includes an intelligent ranking system that evaluates repositories based on multiple weighted metrics and assigns a letter grade (S, A, B, C, D) with a numerical score.

How Ranking Works

The ranking algorithm analyzes your repository across three main categories:

πŸ“Š Popularity Metrics (30%)

  • Stars (15%): Logarithmic scale - measures community interest
  • Forks (8%): Indicates code reusability and adoption
  • Watchers (7%): Shows active monitoring and engagement

πŸ”₯ Activity Metrics (30%)

  • Commit Activity (12%): Recent development momentum (high/medium/low)
  • Release Cadence (8%): Frequency and regularity of releases
  • Recent Updates (10%): How recently the repository was updated

πŸ’š Community Health (40%)

  • PR Merge Rate (10%): Percentage of pull requests successfully merged
  • Issue Close Rate (10%): Efficiency in resolving issues
  • Contributor Diversity (8%): Active vs total contributors ratio
  • Discussion Activity (7%): Average comments per issue/PR
  • Code Quality (5%): Commit message quality score

Ranking Tiers

Tier Score Range Badge Color Description
S 90-100 🟑 Gold Exceptional - Top-tier project with outstanding metrics
A 75-89 🟒 Green Excellent - Highly active and well-maintained
B 60-74 πŸ”΅ Blue Good - Solid project with healthy metrics
C 45-59 🟠 Orange Fair - Room for improvement in some areas
D 0-44 πŸ”΄ Red Needs Attention - Multiple areas need improvement

The ranking badge appears automatically in the widget header, showing both the tier letter and numerical score.


Themes

Customize your widget with 10 beautiful built-in themes! Each theme provides carefully selected colors for optimal readability and aesthetics.

Available Themes

Light Theme

The classic GitHub light theme with clean whites and subtle grays.

Copy to use:

![Repository Stats](https://github-repo-readme-stats.vercel.app/api/?username=YOUR_USERNAME&repo=YOUR_REPO&theme=light)

Light Theme


Dark Theme

GitHub's modern dark theme with deep blues and bright accents.

Copy to use:

![Repository Stats](https://github-repo-readme-stats.vercel.app/api/?username=YOUR_USERNAME&repo=YOUR_REPO&theme=dark)

Dark Theme


Dracula Theme

The popular Dracula color scheme with purple and cyan accents.

Copy to use:

![Repository Stats](https://github-repo-readme-stats.vercel.app/api/?username=YOUR_USERNAME&repo=YOUR_REPO&theme=dracula)

Dracula Theme


Nord Theme

Arctic, north-bluish color palette with soft pastels.

Copy to use:

![Repository Stats](https://github-repo-readme-stats.vercel.app/api/?username=YOUR_USERNAME&repo=YOUR_REPO&theme=nord)

Nord Theme


Monokai Theme

Vibrant and warm colors inspired by the classic Monokai editor theme.

Copy to use:

![Repository Stats](https://github-repo-readme-stats.vercel.app/api/?username=YOUR_USERNAME&repo=YOUR_REPO&theme=monokai)

Monokai Theme


Gruvbox Theme

Retro groove color scheme with earthy tones.

Copy to use:

![Repository Stats](https://github-repo-readme-stats.vercel.app/api/?username=YOUR_USERNAME&repo=YOUR_REPO&theme=gruvbox)

Gruvbox Theme


Solarized Theme

Precision colors for optimal readability in dark environments.

Copy to use:

![Repository Stats](https://github-repo-readme-stats.vercel.app/api/?username=YOUR_USERNAME&repo=YOUR_REPO&theme=solarized)

Solarized Theme


Tokyo Night Theme

A clean, dark theme inspired by Tokyo's night skyline.

Copy to use:

![Repository Stats](https://github-repo-readme-stats.vercel.app/api/?username=YOUR_USERNAME&repo=YOUR_REPO&theme=tokyonight)

Tokyo Night Theme


Catppuccin Theme

Soothing pastel theme for the cozy feeling.

Copy to use:

![Repository Stats](https://github-repo-readme-stats.vercel.app/api/?username=YOUR_USERNAME&repo=YOUR_REPO&theme=catppuccin)

Catppuccin Theme


Ocean Theme

Deep ocean blues with cyan highlights.

Copy to use:

![Repository Stats](https://github-repo-readme-stats.vercel.app/api/?username=YOUR_USERNAME&repo=YOUR_REPO&theme=ocean)

Ocean Theme


How to Use Themes

Simply add the theme parameter to your widget URL:

![Repository Stats](https://your-deployment-url.vercel.app/api/?username=YOUR_USERNAME&repo=YOUR_REPO&theme=THEME_NAME)

Example:

![Repository Stats](https://github-repo-readme-stats.vercel.app/api/?username=facebook&repo=react&theme=dracula)

About

Dynamic stats for the individual repo (best view for all kind of user and especially HRs)

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Sponsor this project

 

Contributors 18