Centralized competitive programming contest discovery platform.
- Java 25 (JDK)
- Maven 3.9+
- MySQL 8+ (tested with MySQL 26.7 Community Server)
- Node.js 20+ and npm
-
Connect to MySQL as a user with CREATE and GRANT privileges:
mysql -u root -p -
Run the setup script (edit
create-database.sqlfirst to set a real password):source backend/src/main/resources/db/create-database.sql
Copy .env.example to .env and fill in your values:
DATABASE_URL=jdbc:mysql://localhost:3306/contestradar?useSSL=false&allowPublicKeyRetrieval=true&serverTimezone=UTC&characterEncoding=UTF-8
DATABASE_USERNAME=contestradar
DATABASE_PASSWORD=<your-password>
SERVER_PORT=8080
Never commit .env.
cd backend
DATABASE_PASSWORD=<your-password> mvn spring-boot:runFlyway runs automatically and applies pending migrations on startup.
# Backend (uses H2 in-memory — no MySQL needed)
cd backend
mvn clean test
# Frontend
cd frontend
npm run build # type-check + production build
npm run lint # oxlintcd frontend
npm install
npm run dev # dev server at http://localhost:5173The Vite dev server proxies /api requests to http://localhost:8080.
Session-based authentication using Spring Security with BCrypt password hashing. The frontend uses credentials: 'include' to send session cookies with all API requests.
POST /api/auth/register— create accountPOST /api/auth/login— sign in (sets session cookie)POST /api/auth/logout— sign outGET /api/auth/me— current user
Public endpoints: GET /api/contests/**, GET /api/contests/sync-status
Protected endpoints (require login): saved contests, preferences, profiles, reminders, sync trigger.
- Dashboard — live/upcoming contests with countdown timers, platform filters, search
- All Contests — paginated, filterable contest browser with status filters
- Saved Contests — bookmark contests for quick access (per user)
- Recommended — contest recommendations based on preferred platforms
- Connected Profiles — link Codeforces/LeetCode/CodeChef/AtCoder accounts
- Settings — notification preferences, platform preferences
- Authentication — registration, login, logout with secure sessions
- Contest Sync — automatic sync from Codeforces API, with mock data for development