ICPC HUE

The Ultimate Competitive Programming Platform

[!TIP] New! Mirror Mode allows you to practice Codeforces problems directly on ICPC HUE with a distraction-free IDE, live test case execution, and drawing board support!

---

ICPC HUE Overview

ICPC HUE is a next-generation competitive programming platform designed to help you solve problems without limits. We provide a seamless, distraction-free environment for practicing, competing, and analyzing algorithms.

Key Capabilities:

• Mirror Mode: Scrape and solve problems from platforms like Codeforces instantly.
• Smart IDE: Integrated Monaco editor with multi-language support and custom snippets.
• Whiteboard: Built-in Excalidraw integration for visualizing algorithms.
• Analytics: Detailed submission analysis, complexity estimation, and performance tracking.
• Browser Extension: Seamlessly submit code from ICPC HUE to external judges.
• Session Library: Full recording and playback of your coding sessions for deep review.
• Gamification: Competitive leaderboards and achievements to track your progress.
• Professional Curriculum: A guided path curated to take you to the ICPC World Finals goal.

Features

Mirror Mode

Why switch tabs? Bring the problem to you. paste any Codeforces URL into ICPC HUE, and we'll instantly generate a clean, distraction-free workspace with:

• Parsed problem statements (MathJax supported)
• One-click test case import
• Live status updates for submissions

⚡ Integrated Environment

• Multi-language Support: C++, Python, Java, and more.
• Custom Compilers: Configure your own compilation flags.
• Test Case Manager: Add, edit, and run custom test cases locally.

🧠 Algorithm Visualization

Stuck on a graph problem? Use the built-in collaborative whiteboard to:

• Draw graphs and trees
• Trace algorithms visually
• Save and export your logic diagrams

🎥 Session Library

Review your journey. ICPC HUE automatically records your coding sessions, allowing you to:

• Replay your solutions step-by-step to find better optimizations.
• Analyze your thinking patterns through a time-sequenced library of all your solves.
• Share recordings with mentors for high-fidelity code reviews.

🏆 Gamification & Progression

Coding is more fun when you're winning. Stay motivated with a full gamification layer:

• Global Leaderboards: See how you rank against the best competitive programmers worldwide.
• Achievement System: Unlock rewards and badges as you master new algorithms and data structures.
• Consistency Streaks: Keep your momentum alive with daily practice goals and streaks.

🎓 World-Class Curriculum

Follow a battle-tested path to excellence. Our curriculum is designed to take you from the basics to the ICPC World Finals:

• Tiered Learning Layers: From Level 0 (Fundamentals) to Level 3+ (Advanced Graph Theory & Geometry).
• Curated Problem Sets: Hand-picked problems from Codeforces, CodeChef, and AtCoder that maximize learning efficiency.
• Goal-Oriented Milestones: Track your progress towards "ICPC-Ready" status with granular curriculum tracking.

---

🔒 Security & Privacy

ICPC HUE is committed to transparency and security. By open-sourcing our entire platform, we allow the community to audit our code, contribute improvements, and ensure that our tools remain safe, secure, and respectful of user privacy.

Quick Start

1. Visit: icpchue.com
2. Setup Locally: Clone this repo and see the Quick Setup below.
3. Install Extension: Download Here

---

Quick Setup

1. Clone & Install:

   git clone https://github.com/YUST777/icpchue-community.git
   cd icpchue-community
   pnpm install
   

2. Docker:

   docker compose up -d --build
   

---

Community & Support

• Bug Reports: Found a glitch? Open an Issue
• Feature Requests: Have an idea? Request a Feature
• Discussions: Join the conversation in Discussions

---

Roadmap

June 2, 2026: Core Platform

Instant Codeforces mirror, VS Code + Whiteboard workflow, local judge, and analytics. We solved the 15s tab-switching headache.

Q3 2026: National Expansion

Making the platform accessible to all Egyptian Universities. Our goal is to unify the competitive programming community across the country.

[!NOTE] Contact us on Telegram @yousefmsm1 to add your college to the platform.

Future: Multiplayer Rooms

Real-time collaborative coding rooms. Send a link to a friend, recruiter, or professor and solve hard problems together on the cloud.

Repository Structure

graph TB
    subgraph Client ["Client Side (Next.js 16)"]
        UI["Modern UI / Dashboard"]
        IDE["Smart Monaco IDE"]
        Board["Excalidraw Whiteboard"]
        Extension["Browser Extension"]
    end

    subgraph Backend ["Main API (Express/Bun)"]
        API["REST API Endpoint"]
        Auth["Auth & User System"]
        Mirror["Scraping & Mirror Service"]
        Session["Session Recorder"]
    end

    subgraph Infrastructure ["Infrastructure Services"]
        Postgres[(PostgreSQL DB)]
        Redis[(Redis Cache)]
        Judge0[Judge0 Server]
        Mail[Postfix Mail Server]
        Netdata[Netdata Monitoring]
    end

    subgraph External ["External Platforms"]
        CF[Codeforces API]
        Judge[External Online Judges]
    end

    UI --> API
    IDE --> Judge0
    Board --> API
    Extension --> API
    API --> Postgres
    API --> Redis
    Mirror --> CF
    Extension --> Judge
    API --> Mail
    Netdata --> Infrastructure
    Session --> API

• /next-app - Next.js 16 frontend and API routes.
• Browser Extension - Source Code of the ICPC HUE Browser Extension.
• /docs/rules - Engineering rules for contributors.

---

Support the Project

Love ICPC HUE? Give us a ⭐ on GitHub! It helps us grow and keep the platform free.