🚀 GitHub Analytics Engine

An architect-grade visualization tool transforming raw GitHub data into actionable developer intelligence. This high-performance dashboard goes beyond superficial metrics, calculating derived statistics like Global Rank, Impact Score, and Developer Tier to provide a true reflection of a developer's consistency, footprint, and coding habits.

✨ Core Modules & Features

The application is structured around six powerful views, dynamically rendering processed GitHub data:

• 📊 Comprehensive Dashboard: The central control panel featuring donut charts for language distribution, commit velocity graphs, and a dynamic contribution heatmap.
• 🌍 Global Ranking & Tier System: An algorithmic engine that processes stars, followers, and repositories to calculate an estimated "World Rank," "Percentile," and a gamified "Developer Tier" (e.g., S+, S, A+).
• 🔬 Repository Analytics: Evaluates repositories to assign an Impact Score and categorizes complexity (Critical, High, Medium, Low) based on community engagement and open issues.
• 📈 Commit History & Trends: Deep-dive analytics into commit momentum and historical coding consistency.
• 🧠 AI-Powered Insights: Smart deductions analyzing developer patterns, primary tech stacks, and working habits based on aggregated API data.
• ⚔️ Peer Compare: A side-by-side analytical view to benchmark performance, impact, and consistency metrics between two different GitHub profiles.

🛠️ Tech Stack & System Architecture

Built with the latest modern web standards, focusing on performance, type-safety, and seamless UX.

• Framework: Next.js (App Router) & React 19
• Language: Strictly typed TypeScript (src/types/github.ts)
• Styling & UI: Tailwind CSS v4 paired with Radix UI for headless, accessible components (clsx & tailwind-merge for dynamic class management).
• Data Visualization: Recharts v3 for complex, interactive charting.
• API & Data Flow: Direct integration with the GitHub REST API. Utilizes Next.js native fetching with next: { revalidate: 300 } to aggressively cache responses, drastically reducing API rate-limit hits while maintaining real-time feel.

🚀 Getting Started (Zero-Config)

This project is built for immediate deployment and testing. It runs in "Public" mode by default, meaning no .env file is required to start.

1. Clone the repository:

   git clone [https://github.com/komutan234/github-analytics-engine.git](https://github.com/komutan234/github-analytics-engine.git)
   cd github-analytics-engine
   

2.Install dependencies:

Bash npm install 3.Run the development server:

Bash npm run dev Open http://localhost:3000 to view the application.

⚠️ Rate Limit Note: Running unauthenticated allows 60 requests per hour per IP. For production scaling or heavy usage, you can inject an Authorization: Bearer <GITHUB_TOKEN> into src/lib/githubService.ts to increase this limit to 5,000 requests/hour.

Architected and engineered for performance, scale, and deep analytics.