https://github.com/o2sa/devimpact
A smart platform to compare developers by real impact in open-source — not just stars and followers
https://github.com/o2sa/devimpact
analytics comparison dashboard data-visualization developer-tools github github-api graphql nextjs nodejs octokit react scoring-system typescript
Last synced: 2 days ago
JSON representation
A smart platform to compare developers by real impact in open-source — not just stars and followers
- Host: GitHub
- URL: https://github.com/o2sa/devimpact
- Owner: O2sa
- License: mit
- Created: 2026-03-24T22:59:42.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-04-24T18:11:09.000Z (6 days ago)
- Last Synced: 2026-04-24T20:17:02.478Z (6 days ago)
- Topics: analytics, comparison, dashboard, data-visualization, developer-tools, github, github-api, graphql, nextjs, nodejs, octokit, react, scoring-system, typescript
- Language: TypeScript
- Homepage: https://dev-impact-mocha.vercel.app
- Size: 281 KB
- Stars: 12
- Watchers: 1
- Forks: 12
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# 🚀 DevImpact
## Preview
**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 💬
---
## 🌟 Why DevImpact?
Traditional metrics (followers, stars, commit counts) are often misleading.
DevImpact focuses on:
- ✅ Quality over quantity
- ✅ Real contributions to valuable projects
- ✅ Fair comparison between developers
---
## 🧠 Scoring System Overview
Each developer is evaluated using three main scores:
### 📦 Repo Score (Builder Impact)
Measures the quality and impact of repositories owned by the user.
Factors include:
- Stars ⭐
- Forks 🍴
- Watchers
---
### 🔀 PR Score (Contribution Impact)
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
---
### 💬 Contribution Score (Community Impact)
Measures community engagement.
Includes:
- Issues opened in external repositories
- Discussions participation
⚠️ Does NOT include commits or PRs (to avoid duplication)
---
### 🏆 Final Score
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.
---
## ⚖️ Key Design Principles
- ❌ No self-inflation (own PRs excluded)
- 📉 Diminishing returns to prevent spam
- 🎯 External impact is prioritized
- ⚖️ Balanced scoring between builders and contributors
---
## 🖥️ Features
- 🔍 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
---
## 🛠️ Tech Stack
### Frontend
- Next.js (App Router)
- TypeScript
- Tailwind CSS
- Recharts
### API
- Node.js + Express
- GitHub GraphQL API
- Octokit
---
## 🚀 Getting Started
### 1. Clone the repo
```bash
git clone https://github.com/O2sa/DevImpact.git
cd DevImpact
```
---
### 2. Install dependencies
```bash
pnpm install
```
---
### 3. Set up environment variables
Create a `.env` file:
```
GITHUB_TOKEN=your_github_token
```
---
### 4. Run the app
```bash
pnpm run dev
```
---
---
## 📡 API Example
The compare endpoint accepts one or more `username` query parameters.
### Example request
```bash
curl "api/compare?username=devimpact&username=octocat"
```
### Example response
```json
{
"success": true,
"users": [
{
"username": "octocat",
"name": "The Octocat",
"avatarUrl": "https://avatars.githubusercontent.com/u/583231?v=4",
"repoScore": 87,
"prScore": 64,
"contributionScore": 42,
"finalScore": 73,
"topRepos": [],
"topPullRequests": []
}
]
}
```
## 🌍 Localization
- Supported languages: English 🇺🇸, Arabic 🇸🇦
- Automatically detects user language
- Allows manual switching
- Easy to add new languages via `/locales`
---
## 🤝 Contributing
Contributions are welcome!
### How to contribute:
1. Fork the repository
2. Create a feature branch
3. Commit your changes
4. Open a pull request
---
### Contribution ideas:
- Improve scoring algorithm
- Add new metrics
- Enhance UI/UX
- Add new languages 🌍
---
## ⚠️ Limitations
- GitHub API rate limits
- Some private contributions are not accessible
- Scoring system is heuristic (not perfect)
---
## 💡 Inspiration
DevImpact was created to answer a simple question:
> “Who really has more impact in open-source?”
---
## ⭐ Support
If you like this project:
- ⭐ Star the repo
- 🐛 Report issues
- 💡 Suggest features