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
- Visit: icpchue.com
- Setup Locally: Clone this repo and see the Quick Setup below.
- Install Extension: Download Here
Quick Setup
- Clone & Install:
git clone https://github.com/YUST777/icpchue-community.git
cd icpchue-community
pnpm install
- Docker:
docker compose up -d --build
Community & Support
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.
