Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 2 additions & 3 deletions .github/ISSUE_TEMPLATE/bug-report.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,9 @@
---
name: Bug Report
about: Reporting bugs in existing code
title: ''
title: ""
labels: bug, good first issue
assignees: ''

assignees: ""
---

## The Problem
Expand Down
5 changes: 2 additions & 3 deletions .github/ISSUE_TEMPLATE/documentation.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,9 @@
---
name: Documentation
about: Report issues or additions to Documentation
title: ''
title: ""
labels: documentation, good first issue
assignees: ''

assignees: ""
---

## Description of what to add
Expand Down
5 changes: 2 additions & 3 deletions .github/ISSUE_TEMPLATE/feature-change-request.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,9 @@
---
name: Feature-Change Request
about: Suggest a change in an existing feature
title: ''
title: ""
labels: change, good first issue
assignees: ''

assignees: ""
---

## What needs to change
Expand Down
5 changes: 2 additions & 3 deletions .github/ISSUE_TEMPLATE/feature-request.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,9 @@
---
name: Feature Request
about: Suggest a new feature for this project
title: ''
title: ""
labels: feature, good first issue
assignees: ''

assignees: ""
---

## Description of the feature
Expand Down
7 changes: 2 additions & 5 deletions .github/ISSUE_TEMPLATE/refactoring.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,9 @@
---
name: Refactoring Request
about: Suggest refactoring or code quality improvements
title: ''
title: ""
labels: refactoring, good first issue
assignees: ''

assignees: ""
---

## Area to Refactor
Expand All @@ -20,9 +19,7 @@ assignees: ''

- describe the refactoring approach in bullet points


> [!NOTE]
> **CONTRIBUTIONS ARE WELCOME!**
> If you want to get this issue assigned to you, just comment `assign this issue to me`.
> You will be assigned to the issue instantly via GitHub-actions bot.

7 changes: 7 additions & 0 deletions .prettierignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
.next
node_modules
out
dist
build
pnpm-lock.yaml
package-lock.json
12 changes: 12 additions & 0 deletions .prettierrc.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
{
"semi": true,
"trailingComma": "es5",
"singleQuote": false,
"printWidth": 80,
"tabWidth": 2,
"useTabs": false,
"bracketSpacing": true,
"arrowParens": "always",
"endOfLine": "lf",
"jsxSingleQuote": false
}
7 changes: 7 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -37,16 +37,19 @@ Thank you for your interest in contributing to DevImpact! This guide will help y
### Installation

1. Install dependencies:

```bash
pnpm install
```

2. Create a `.env` file in the project root (see `.env.example`):

```
GITHUB_TOKEN=your_github_token_here
```

3. Start the development server:

```bash
pnpm dev
```
Expand Down Expand Up @@ -79,25 +82,29 @@ DevImpact/
## Making Changes

1. **Sync your fork** with the latest upstream changes:

```bash
git fetch upstream
git checkout main
git merge upstream/main
```

2. **Create a feature branch** from `main`:

```bash
git checkout -b feat/your-feature-name
```

3. **Make your changes** and test them locally.

4. **Run the linter** before committing:

```bash
pnpm lint
```

5. **Commit your changes** with a clear message:

```bash
git commit -m "feat: add your feature description"
```
Expand Down
100 changes: 47 additions & 53 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,5 @@
# 🚀 DevImpact

![License](https://img.shields.io/github/license/o2sa/devimpact)
![Stars](https://img.shields.io/github/stars/o2sa/devimpact)
![Forks](https://img.shields.io/github/forks/o2sa/devimpact)
Expand All @@ -11,14 +12,13 @@
![Node.js](https://img.shields.io/badge/Node.js-green?logo=node.js)
![GraphQL](https://img.shields.io/badge/GraphQL-pink?logo=graphql)


**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 💬
- Repository quality 📦
- Pull request impact 🔀
- Community contributions 💬

---

Expand All @@ -28,9 +28,9 @@ Traditional metrics (followers, stars, commit counts) are often misleading.

DevImpact focuses on:

* ✅ Quality over quantity
* ✅ Real contributions to valuable projects
* ✅ Fair comparison between developers
- ✅ Quality over quantity
- ✅ Real contributions to valuable projects
- ✅ Fair comparison between developers

---

Expand All @@ -44,9 +44,9 @@ Measures the quality and impact of repositories owned by the user.

Factors include:

* Stars ⭐
* Forks 🍴
* Watchers
- Stars ⭐
- Forks 🍴
- Watchers

---

Expand All @@ -59,10 +59,10 @@ Measures contributions to **other developers' repositories**.

Factors include:

* Target repository quality
* PR size (additions/deletions)
* Repository popularity
* Contribution diversity
- Target repository quality
- PR size (additions/deletions)
- Repository popularity
- Contribution diversity

---

Expand All @@ -72,8 +72,8 @@ Measures community engagement.

Includes:

* Issues opened in external repositories
* Discussions participation
- Issues opened in external repositories
- Discussions participation

⚠️ Does NOT include commits or PRs (to avoid duplication)

Expand All @@ -96,44 +96,41 @@ Final Score =

## ⚖️ Key Design Principles

* ❌ No self-inflation (own PRs excluded)
* 📉 Diminishing returns to prevent spam
* 🎯 External impact is prioritized
* ⚖️ Balanced scoring between builders and contributors
- ❌ 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
- 🔍 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
- Next.js (App Router)
- TypeScript
- Tailwind CSS
- Recharts

### API

* Node.js + Express
* GitHub GraphQL API
* Octokit
- Node.js + Express
- GitHub GraphQL API
- Octokit

---




## 🚀 Getting Started

### 1. Clone the repo
Expand Down Expand Up @@ -173,14 +170,13 @@ pnpm run dev

## 🌍 Localization

* Supported languages: English 🇺🇸, Arabic 🇸🇦
* Automatically detects user language
* Allows manual switching
* Easy to add new languages via `/locales`
- Supported languages: English 🇺🇸, Arabic 🇸🇦
- Automatically detects user language
- Allows manual switching
- Easy to add new languages via `/locales`

---


## 🤝 Contributing

Contributions are welcome!
Expand All @@ -196,22 +192,21 @@ Contributions are welcome!

### Contribution ideas:

* Improve scoring algorithm
* Add new metrics
* Enhance UI/UX
* Add new languages 🌍
- 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)
- 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:
Expand All @@ -224,7 +219,6 @@ DevImpact was created to answer a simple question:

If you like this project:

* ⭐ Star the repo
* 🐛 Report issues
* 💡 Suggest features

- ⭐ Star the repo
- 🐛 Report issues
- 💡 Suggest features
Loading
Loading