diff --git a/README.md b/README.md
index e15defa..daef422 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,5 @@
# π DevImpact
+



@@ -11,14 +12,19 @@


+## 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 π¬
+- Repository quality π¦
+- Pull request impact π
+- Community contributions π¬
---
@@ -28,9 +34,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
---
@@ -44,9 +50,9 @@ Measures the quality and impact of repositories owned by the user.
Factors include:
-* Stars β
-* Forks π΄
-* Watchers
+- Stars β
+- Forks π΄
+- Watchers
---
@@ -59,10 +65,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
---
@@ -72,8 +78,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)
@@ -96,44 +102,42 @@ 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
@@ -206,12 +210,13 @@ curl "api/compare?username=devimpact&username=octocat"
## π 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!
@@ -227,22 +232,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:
@@ -255,7 +259,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
diff --git a/public/screenshots/screenshot.png b/public/screenshots/screenshot.png
new file mode 100644
index 0000000..3e79865
Binary files /dev/null and b/public/screenshots/screenshot.png differ