DevImpact is an open-source platform that compares software developers based on their real impact in the open-source ecosystem — not just raw numbers.
It evaluates developers using a smart scoring system that considers:
- Repository quality 📦
- Pull request impact 🔀
- Community contributions 💬
Traditional metrics (followers, stars, commit counts) are often misleading.
DevImpact focuses on:
- ✅ Quality over quantity
- ✅ Real contributions to valuable projects
- ✅ Fair comparison between developers
Each developer is evaluated using three main scores:
Measures the quality and impact of repositories owned by the user.
Factors include:
- Stars ⭐
- Forks 🍴
- Watchers
Measures contributions to other developers' repositories.
✔ Only merged PRs are counted ✔ PRs to the user's own repositories are excluded
Factors include:
- Target repository quality
- PR size (additions/deletions)
- Repository popularity
- Contribution diversity
Measures community engagement.
Includes:
- Issues opened in external repositories
- Discussions participation
The final score is a weighted combination:
Final Score =
0.45 × Repo Score +
0.45 × PR Score +
0.10 × Contribution Score
👉 The ContributionScore is capped to prevent abuse.
- ❌ No self-inflation (own PRs excluded)
- 📉 Diminishing returns to prevent spam
- 🎯 External impact is prioritized
- ⚖️ Balanced scoring between builders and contributors
- 🔍 Compare two GitHub users side-by-side
- 📊 Visual score breakdown (charts & insights)
- 🧠 Smart ranking system
- 🌍 Localization support (EN / AR)
- ⚡ Fast API powered by GitHub GraphQL
- 🧩 Extensible scoring system
- Framework: Next.js (App Router, Server & Client Components)
- Language: TypeScript
- Styling: Tailwind CSS
- Data & APIs: GitHub GraphQL API via Octokit
- Database & Cache: PostgreSQL & Redis (read-through cache)
- Visualizations: Recharts
- Testing: Vitest
DevImpact is structured around a Feature-Driven Scalable Architecture (src/features/*, src/lib/*, src/components/*, src/app/*).
For full details on the system design, directory structure, module boundaries, and step-by-step contributor guides, see the Architecture Guide (ARCHITECTURE.md).
Run the entire platform (Web App UI + PostgreSQL + Redis) in 2 simple steps:
# 1. Copy environment template and set GITHUB_TOKEN
cp .env.example .env
# 2. Start full platform
docker compose -f ops/docker/docker-compose.yml up -d --buildThen open http://localhost:3000 in your browser!
-
Install dependencies:
pnpm install
-
Configure environment:
cp .env.example .env
-
Start local database & Redis:
pnpm db:up && pnpm redis:up -
Run development server:
pnpm run dev
-
Calculate leaderboard scores manually:
pnpm leaderboard:calculate
The leaderboard score updates run via a dedicated background worker container using Docker & Supercronic.
For complete local setup, Docker Compose instructions, GHCR publishing, and VPS deployment documentation, see ops/README.md.
# Quick worker setup (pulls & runs published image)
cp .env.example .env
docker compose -f ops/docker/leaderboard-compose.yml pull
docker compose -f ops/docker/leaderboard-compose.yml up -d- Supported languages: English 🇺🇸 (LTR), Arabic 🇸🇦 (RTL)
- Automatically detects user language via browser & cookies
- Allows manual switching with instant direction toggling
- Easy to add new languages via
src/locales/(validated withpnpm validate-locales)
Contributions are welcome! Check out our Contributing Guide (CONTRIBUTING.md) and Architecture Guide (ARCHITECTURE.md) to get started.
- Fork the repository
- Create a feature branch
- Run tests and type checks (
pnpm test && npx tsc --noEmit) - Commit your changes
- Open a pull request
- Improve scoring algorithm
- Add new metrics
- Enhance UI/UX
- Add new languages 🌍
- GitHub API rate limits
- Some private contributions are not accessible
- Scoring system is heuristic (not perfect)
DevImpact was created to answer a simple question:
“Who really has more impact in open-source?”
If you like this project:
- ⭐ Star the repo
- 🐛 Report issues
- 💡 Suggest features