🚀 CodeHub — LeetCode to GitHub Auto-Sync Chrome Extension

Seamlessly sync your LeetCode solutions directly to GitHub with automated Big-O complexity analysis and rich Markdown documentation.

---

✨ Features

• ⚡ Instant Auto-Sync: Automatically detects accepted submissions on LeetCode and commits your solution directly to your GitHub repository in real time.
• 🧠 Hybrid Big-O Analyzer:
  • Local AST Analyzer: Fast, built-in structural analyzer for estimating Time & Space complexities offline.
  • Gemini AI Engine: Optional AI integration for high-accuracy Big-O complexity analysis on complex data structures and Pro-level algorithms.
• 📁 Smart Folder Organization: Solution files are neatly grouped by difficulty (Easy/, Medium/, Hard/) with standard language file extensions.
• 📝 Rich Problem Documentation: Every committed solution includes a dedicated README.md featuring:
  • Formatted problem description & constraints
  • Submission stats (Runtime & Memory percentiles)
  • Time & Space Big-O complexity breakdown
  • Direct links back to the LeetCode problem
• 🎨 Glassmorphic UI & Custom Themes: Includes Dark, Light, and Cyberpunk themes, live solution streak tracking, and interactive counters.
• 🔒 100% Client-Side Privacy: Communicates directly with the official GitHub API via Personal Access Tokens (PAT). No middleman servers, analytics, or data collection.

---

🛠️ Step-by-Step Browser Setup Guide

Follow these quick steps to install and configure CodeHub in your Chrome browser:

1. Download or Clone the Repository

Clone this repository locally using Git:

git clone https://github.com/your-username/CodeHub.git

Or click Code -> Download ZIP on GitHub and extract the contents to a folder on your computer.

---

2. Load the Extension into Google Chrome

1. Open Google Chrome and navigate to chrome://extensions/.
2. Toggle Developer mode ON in the top-right corner.
3. Click the Load unpacked button in the top-left corner.
4. Select the CodeHub root folder (where manifest.json is located).
5. CodeHub is now installed! Pin it to your browser toolbar for easy access.

---

3. Generate a GitHub Personal Access Token (PAT)

CodeHub uses a GitHub Personal Access Token to commit code directly to your repository:

1. Go to your GitHub account -> Settings -> Developer Settings -> Personal Access Tokens -> Tokens (classic).
2. Click Generate new token (classic).
3. Set the Note to CodeHub Extension.
4. Select the repo scope checkbox (this grants permission to push solutions to your repositories).
5. Click Generate token and copy your generated token string (ghp_...).

---

4. Complete Extension Onboarding

1. Click the CodeHub extension icon in your Chrome toolbar.
2. Click Get Started to open the welcome setup page.
3. Paste your GitHub Personal Access Token and click Validate.
4. Select an existing repository from your account or enter a new repository name (e.g., leetcode-solutions) to create one automatically.
5. Click Finish Setup. You are now ready to auto-sync!

---

5. (Optional) Enable Gemini AI Big-O Complexity Engine

CodeHub includes a built-in offline AST complexity analyzer by default. To unlock AI-powered Big-O analysis for complex algorithms:

1. Get a free API Key from Google AI Studio.
2. Open the CodeHub extension popup.
3. Paste your API key in the AI Big-O Engine input field on the home screen or inside Settings.
4. Click Save Key.

---

📂 Project Architecture

CodeHub/
├── manifest.json         # Extension Manifest V3 configuration
├── assets/               # Branding icons (16px, 48px, 128px)
├── popup/                # Extension Popup UI
│   ├── popup.html        # Main dashboard & settings HTML
│   ├── popup.css         # Glassmorphic styling & theme engine
│   └── popup.js          # Popup UI controller & state handlers
├── scripts/              # Core Service Workers & Modules
│   ├── background.js     # Ephemeral Service Worker (GitHub API & Messaging)
│   ├── content.js        # Content script loader
│   ├── leetcode.js       # LeetCode DOM observer & submission detector
│   ├── github.js         # GitHub REST API client module
│   └── storage.js        # Chrome storage local wrapper module
├── welcome/              # First-time onboarding flow
│   ├── welcome.html      # Multi-step setup wizard
│   ├── welcome.css       # Onboarding page styling
│   └── welcome.js        # Token verification & repo selection
├── LICENSE               # Open-source MIT License
└── README.md             # Project documentation & setup guide

---

💻 Technical Details

• Platform: Chrome Extension Manifest V3 (MV3)
• Frontend: Vanilla HTML5, CSS3 (Glassmorphism design system), ES6 Modules
• API Integration: GitHub REST API v3, Google Gemini API
• State Management: chrome.storage.local asynchronous persistence
• DOM Detection: Event-driven submit tracking + MutationObserver on LeetCode DOM

---

🔒 Security & Privacy

CodeHub is built with privacy and security as top priorities:

• No External Backends: All network calls originate from your browser directly to api.github.com or generativelanguage.googleapis.com.
• Token Security: Tokens are stored locally in your browser's encrypted chrome.storage.local space.
• Sanitized Inputs: Path normalization prevents path traversal vulnerabilities, and markdown output is safely sanitized.

---

📜 License

This project is licensed under the MIT License. Feel free to use, modify, and contribute to this repository.