Skip to content

akashgoudsidduluri/gitRank

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

45 Commits
 
 
 
 
 
 
 
 

Repository files navigation

🚀 GitRank

GitHub stars GitHub issues React Node.js License

GitRank is a modern GitHub analytics platform that transforms raw GitHub profile data into meaningful, actionable developer insights.

Beyond basic GitHub statistics, GitRank evaluates repository impact, developer activity, account maturity, and profile quality to generate a custom GitRank Score along with actionable recommendations.


🌐 Live Demo

  • Frontend Web App: Vercel
  • Backend REST API: Render

💡 Why GitRank?

GitHub profiles expose large amounts of raw data but provide limited insight into what that data actually means.

GitRank transforms repository statistics, developer activity, and profile metrics into actionable insights, helping developers better understand their open-source footprint and identify areas for growth.


✨ Features

🔍 GitHub Profile Analysis

Analyze any public GitHub profile instantly.

Example:

GET /api/analyze/torvalds

Analytics Dashboard

GitRank provides:

  • Followers & Following
  • Public Repository Count
  • Total Stars Earned
  • Average Stars Per Repository
  • Account Age
  • Top Repository
  • Developer Archetype

GitRank Score v2

GitRank calculates a weighted developer score using:

  • Contribution Activity: Commit volumes, pull requests, issues, and code reviews.
  • Repository Impact: Aggregate stars across your codebase portfolio.
  • Community Reach: Followers base and community engagement.
  • Repository Portfolio: Public repos catalog metrics.
  • Account Age: Maturity index of the profile.

Includes a detailed score breakdown for complete transparency.

Contribution Analytics

• Real GitHub Contribution Heatmap • Contribution Breakdown Charts • Current & Longest Contribution Streaks • Peak Contribution Day • Monthly Activity Trends • Active Days Analysis • Contribution Statistics • GitRank Tier Classification

Repository Insights

GitRank provides deeper repository-level analytics:

  • Most Used Programming Language
  • Language Breakdown Analysis
  • Original Repository Count
  • Repositories With Stars
  • Repositories Without Stars
  • Average Forks Per Repository
  • Most Forked Repository
  • Newest Repository
  • Oldest Repository

📂 Repository Explorer

A dedicated space to browse through the user's codebase:

  • Live Search: Filter repositories by name, description, or language.
  • Dynamic Sorting: Sort by stars, forks, age, or alphabetical order.
  • On-Demand Contributors: Fetch the top 3 contributors for any repository with a single click.
  • Responsive Grid: Glassmorphic cards that adapt to all screen sizes.

Achievements & Badges

GitRank rewards activity through unlockable achievements and reputation badges.

Achievements: • Commit Crusader • PR Pioneer • Issue Hunter • Code Reviewer • Repo Builder • Star Magnet • Open Source Veteran

Badges: • GitRank Explorer • Open Source Explorer • Maintainer Material

Smart Developer Analysis

GitRank generates:

  • Profile Strengths
  • Profile Weaknesses
  • Personalized Recommendations
  • Developer Archetype Classification

📸 Share Your GitRank (Social Card)

Generate beautiful, high-quality PNG screenshots of your GitRank profile specifically formatted for sharing on social media (Twitter, LinkedIn).

  • Custom glassmorphic Share Modal
  • Copy directly to clipboard
  • Instant PNG downloads

Modern Dashboard UI

  • Glassmorphism Design System
  • Dark / Light Theme Toggle
  • Theme Persistence
  • Responsive Layout
  • Skeleton Loading States
  • Repository Spotlight Cards
  • Interactive Statistics Dashboard
  • Multi-Tab Dashboard
  • Repository Insights Tab
  • Component-Based Architecture

  • Overview
  • Repository Insights
  • Repository Explorer
  • Contributions

GitRank Score

GitRank calculates a custom developer score using:

• Contribution Activity • Repository Impact (Stars) • Community Reach (Followers) • Repository Portfolio • Account Age

Score Tiers

Score Tier
0 - 19 Beginner
20 - 39 Explorer
40 - 59 Builder
60 - 79 Advanced
80 - 100 Legend

GitRank Score reflects GitHub profile impact and open-source visibility. It is not a direct measure of software engineering ability.

Current Metrics

GitRank aggregates and processes statistics directly into simple, intuitive values:

  • Profile Overview: Followers, Following, Total Stars, Repo Count, and Archetype.
  • Contribution Activity: Heatmap charts, current/longest streaks, peak contribution day, and monthly activity trends.
  • Codebase Explorer: Sortable languages, fork volumes, repo age metadata, and contributor metrics.

Tech Stack

Frontend

  • React
  • Axios
  • React Icons
  • Chart.js
  • React ChartJS 2
  • Modern CSS (Glassmorphism UI Design System)

Backend

  • Node.js
  • Express.js
  • Axios
  • Dotenv
  • CORS

APIs

  • GitHub REST API
  • GitHub GraphQL API

☁️ Deployment Architecture

  • Frontend: Vercel (Production SPA hosting)
  • Backend Service: Render Web Service (Node.js engine)
  • API Providers: GitHub REST API v3 & GitHub GraphQL API v4

Project Structure

gitRank/
│
├── backend/
│   ├── controllers/
│   ├── routes/
│   ├── services/
│   ├── .env
│   ├── index.js
│   └── package.json
│
├── frontend/
│   ├── src/
│   │   ├── components/
│   │   ├── tabs/
│   │   ├── App.jsx
│   │   ├── index.css
│   │   └── main.jsx
│   │
│   ├── public/
│   └── package.json
│
└── README.md

🖼️ Screenshots

Home Landing Screen

Home Screen

Developer Overview Dashboard

Overview Dashboard

Contribution Analytics Heatmap

Contributions Tab

Interactive Repository Explorer

Repository Explorer


Installation

Clone Repository

git clone https://github.com/akashgoudsidduluri/gitRank.git
cd gitRank

Backend Setup

cd backend

npm install

Create a .env file:

PORT=5000
GITHUB_TOKEN=YOUR_GITHUB_TOKEN

Start development server:

npm run dev

Production:

npm start

Backend runs at:

http://localhost:5000

Frontend Setup

cd frontend

npm install

npm run dev

Frontend runs at:

http://localhost:5173

API Endpoint

Analyze Profile

GET /api/analyze/:username

Example:

GET /api/analyze/torvalds

Sample Response

{
  "username": "torvalds",
  "followers": 307000,
  "following": 0,
  "publicRepos": 8,
  "accountAgeYears": 14.8,
  "totalStars": 210000,
  "averageStarsPerRepo": 26250,
  "topRepo": "linux",
  "topRepoStars": 210000,
  "devScore": 98,
  "archetype": "Legend",
  "repoInsights": {
    "mostUsedLanguage": "JavaScript",
    "languageBreakdown": [],
    "reposWithStars": 4,
    "reposWithoutStars": 23,
    "averageForksPerRepo": 0.04
  },
  "repositoryExplorer": [
    {
      "name": "linux",
      "stars": 210000,
      "forks": 50000,
      "language": "C"
    }
  ],
  "strengths": [],
  "weaknesses": [],
  "recommendations": []
}

Roadmap

Completed

  • GitHub Profile Analysis
  • Repository Analytics
  • GitRank Score Engine
  • Smart Developer Analysis
  • Archetype Classification
  • Repository Insights
  • Language Analysis
  • Responsive Dashboard UI
  • Theme Toggle
  • Multi-Tab Dashboard (Overview, Repository Insights, Repository Explorer, Contributions)
  • Loading Skeletons
  • Top Repository Spotlight
  • Full Stack Integration
  • Component-Based Frontend Architecture
  • Contribution Analytics (Heatmap, commit/PR/issue/review counts)
  • Unlockable Achievements & Badges
  • Profile Completion Progress Tracker
  • Social Card Generator (Share Your GitRank)

In Progress

  • Developer Comparison

Planned

  • PDF Export
  • Search History
  • Global Leaderboards
  • Database Integration
  • AI Career Insights
  • Repository Quality Analysis
  • Open Source Contribution Analytics

Future Vision

GitRank aims to become a complete developer intelligence platform that helps developers understand, benchmark, and improve their GitHub presence through analytics, insights, and AI-powered recommendations.


Author

Akash Goud Sidduluri

GitHub: https://github.com/akashgoudsidduluri

About

A full-stack GitHub developer scoring platform that analyzes GitHub profiles, calculates custom DevScores, ranks developers through leaderboards, and uses intelligent caching to optimize API usage.

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages