A web-based platform developed by CodePVG to track, analyze, and rank students of PVG COET based on their LeetCode activity and problem-solving performance.
The platform allows students to register using their LeetCode username and automatically generates leaderboard rankings, historical progress tracking, and performance insights through periodic synchronization of LeetCode statistics.
The goal of this project is to encourage consistent problem-solving among students by providing a centralized platform to track LeetCode activity and coding progress.
Through regularly updated leaderboards and historical performance tracking, the platform aims to create a competitive yet collaborative environment where students can monitor their growth, stay motivated, and improve their problem-solving skills over time.
-
LeetCode-based Student Registration Students can register using their LeetCode username to participate in the leaderboard.
-
Automated Performance Tracking The platform periodically fetches and updates user problem-solving statistics automatically.
-
Dynamic Multi-View Leaderboards Supports overall, monthly, weekly, and daily leaderboard rankings.
-
Historical Progress Tracking Tracks past performance and rank movement over time using historical leaderboard snapshots.
-
Terminal-inspired Responsive UI A lightweight terminal-style interface designed to work across both desktop and mobile devices.
-
Search, Filtering, and Comparison Tools Includes leaderboard search, filtering, and peer comparison features for easier performance analysis.
-
Decoupled Data Architecture Frontend, backend, and leaderboard data storage are maintained independently for easier scalability and maintenance.
-
Automated Synchronization Workflows GitHub Actions and sync scripts help keep leaderboard data updated without manual intervention.
A quick preview of the platform UI. The appearance may evolve as the project develops.
The project follows a decoupled structure where leaderboard generation, data storage, API handling, and frontend rendering are handled independently across multiple repositories and services.
-
Frontend (
frontend/) Handles the leaderboard UI, registration pages, comparison features, and client-side interactions. Leaderboard datasets are fetched directly from theleetcode-ranking-datarepository. -
Express Server (
server.js) Serves the frontend and exposes API endpoints for student-specific information, history tracking, and related backend functionality. -
Sync Scripts (
scripts/) Periodically fetch and process LeetCode statistics to generate updated leaderboard datasets. -
Data Repository (
leetcode-ranking-data) Stores generated leaderboard snapshots, historical statistics, and processed JSON data separately from the main application repository. -
GitHub Actions (
.github/workflows/) Automates scheduled sync runs, formatting checks, stale issue management, and other repository workflows.
- leetcode-ranking-data – The database repository where raw JSON data and historical stats are stored
- leetcode-api – API used to fetch user data from LeetCode
- lc-backend – Backend service for storing and managing leaderboard data
- frontend-uptime-monitor – Pinger service to monitor frontend server uptime
- backend-uptime-monitor – Pinger service to monitor backend server uptime
leetcode-ranking/
│── .github/ # GitHub Actions workflows
│── frontend/ # UI (HTML, CSS, JS) - Fetches data from leetcode-ranking-data
│── scripts/ # Automation scripts (sync-leaderboard.js)
│── server.js # Express server
│── package.json
Note
All leaderboard data is now decoupled and stored in the leetcode-ranking-data repository to prevent commit history bloat in this repo.
The platform is publicly available at:
https://codepvg.onrender.com
Students can register using their LeetCode username to participate in the leaderboard, track rankings across different leaderboard views, monitor historical performance, and compare progress with other users.
Leaderboard data is synchronized periodically, so newly registered users and recent submissions may take a few minutes to appear in the rankings.
git clone https://github.com/YOUR-USERNAME/leetcode-ranking.git
cd leetcode-ranking
npm install
npm run devThen open the frontend locally in your browser after starting the server.
For detailed development setup, sync workflow testing, contribution guidelines, and local data repository configuration, refer to CONTRIBUTING.md.
Contributions, suggestions, and improvements are welcome.
Before starting work on a feature or fix, please check the existing issues/discussions or open a new issue to discuss the proposed change first.
For detailed contribution guidelines, local workflow setup, formatting instructions, and sync workflow testing, refer to CONTRIBUTING.md.
This project is licensed under the MIT License.
You are free to use, modify, and distribute this project with proper attribution.
Thanks to everyone who has contributed to the project and helped improve the platform through features, fixes, suggestions, and discussions.
You can view the full list of contributors here: https://github.com/codepvg/leetcode-ranking/graphs/contributors
Maintained by Jagdish Prajapati as part of the CodePVG initiative.
For major feature proposals, architecture discussions, or project-related queries, feel free to open an issue/discussion in the repository.