Skip to content

BusyBee3333/starrank

Repository files navigation

⭐ StarRank

See where your GitHub repo ranks among 125 million+ repositories.

Live Demo License: MIT Next.js

StarRank Preview

What is StarRank?

StarRank tells you exactly where your GitHub repository stands among every public repo on GitHub β€” and lets you show it off with a badge.

Most repos with any stars at all are already in the top 5–20%. StarRank makes that visible.

Features

  • πŸ† Instant Ranking β€” Drop any GitHub repo URL and get your percentile rank immediately
  • πŸ“Š Percentile Score β€” See your top X% standing among 125M+ repositories
  • πŸ”— README Badge β€” One-click Markdown badge to add to your project
  • πŸƒ Share Card β€” Shareable rank card for Twitter / social media
  • ⚑ Fast β€” Results in under a second

Usage

1. Visit solvedby.us

2. Enter any GitHub repo (e.g. facebook/react, your-name/your-project)

3. Copy your badge:

[![StarRank](https://solvedby.us/api/badge/your-username/your-repo)](https://solvedby.us/your-username/your-repo)

That's it. Your README now shows your repo's rank.


Badge Examples

Badge Repo
StarRank facebook/react
StarRank Signet-AI/signetai

How Rankings Work

GitHub has 125M+ public repositories. The vast majority have 0 stars. Here's what the percentages actually mean:

Stars Approximate Percentile
0 stars ~50th percentile
1 star ~Top 30%
10+ stars ~Top 5%
100+ stars ~Top 1%
1,000+ stars ~Top 0.1%
10,000+ stars ~Top 0.01%

StarRank gives you the exact number β€” not an estimate.


Tech Stack

  • Framework: Next.js 15 (App Router)
  • Language: TypeScript
  • Styling: Tailwind CSS
  • Data: GitHub REST API + Stars dataset
  • Deployment: Vercel / Cloudflare

Self-Hosting

# Clone the repo
git clone https://github.com/BusyBee3333/starrank.git
cd starrank

# Install dependencies
pnpm install

# Set environment variables
cp .env.example .env.local
# Add your GITHUB_TOKEN for higher API rate limits

# Run development server
pnpm dev

Open http://localhost:3000 and drop in a repo URL.


Contributing

PRs welcome! Some ideas:

  • More badge styles (flat, for-the-badge, social)
  • Historical rank tracking over time
  • Rank by language category (top X% among TypeScript repos)
  • GitHub Action to auto-update badge in CI
  • Embeddable widget

Fork the repo, make your changes, and open a PR.


License

MIT β€” free to use, modify, and deploy.


About

See where your GitHub repo ranks among 125M+ repositories. Generate a star percentile badge for your README. πŸ†

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors