🚀 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

git clone https://github.com/O2sa/DevImpact.git
cd DevImpact

---

2. Install dependencies

pnpm install

---

3. Set up environment variables

Create a .env file:

GITHUB_TOKEN=your_github_token

---

4. Run the app

pnpm run dev

---

---

📡 API Example

The compare endpoint accepts one or more username query parameters.

Example request

curl "api/compare?username=devimpact&username=octocat"

Example response

{
  "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