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



@@ -11,14 +12,13 @@


-
**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 +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
---
@@ -44,9 +44,9 @@ Measures the quality and impact of repositories owned by the user.
Factors include:
-* Stars β
-* Forks π΄
-* Watchers
+- Stars β
+- Forks π΄
+- Watchers
---
@@ -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
---
@@ -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)
@@ -96,43 +96,52 @@ 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
+## πΈ Screenshots
-### Frontend
+### π₯οΈ Desktop View
-* Next.js (App Router)
-* TypeScript
-* Tailwind CSS
-* Recharts
+
-### API
+### π± Mobile View
-* Node.js + Express
-* GitHub GraphQL API
-* Octokit
+
---
+## π οΈ Tech Stack
+### Frontend
+- Next.js (App Router)
+- TypeScript
+- Tailwind CSS
+- Recharts
+
+### API
+
+- Node.js + Express
+- GitHub GraphQL API
+- Octokit
+
+---
## π Getting Started
@@ -206,12 +215,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 +237,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 +264,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/desktop.png b/public/screenshots/desktop.png
new file mode 100644
index 0000000..7751ba3
Binary files /dev/null and b/public/screenshots/desktop.png differ
diff --git a/public/screenshots/mobile.png b/public/screenshots/mobile.png
new file mode 100644
index 0000000..a4ed916
Binary files /dev/null and b/public/screenshots/mobile.png differ