Lightweight contest coordination system for coding competitions and symposium events.
ClashControl is a lightweight contest coordination system designed for coding competitions, debugging rounds, and college symposium events.
It allows multiple coordinators to manage participants, update scores, record completion times, and track leaderboards in real time using their mobile devices.
The system is built to run locally on a single machine, allowing events to be conducted even without internet access.
📱 Mobile-friendly coordinator dashboard
➕ Quick score updates for participants
⏱ Finish time tracking for tie-breaking
🏆 Live leaderboard for administrators
📦 Batch support for large events
📊 CSV export for results and records
🖥 Local network hosting for offline competitions
clashcontrol/
│
├── README.md
├── LICENSE
│
├── backend/
│ ├── manage.py
| ├── requirements.txt
│ ├── db.sqlite3
│ │
│ ├── clashcontrol/
│ │ ├── settings.py
│ │ ├── urls.py
│ │ ├── asgi.py
│ │ └── wsgi.py
│ │
│ ├── apps/
│ │ ├── users/
│ │ ├── participants/
│ │ ├── scoring/
│ │ └── events/
│ │
│ └── api/
│ ├── views.py
│ └── serializers.py
│
├── frontend/
│ ├── package.json
│ ├── next.config.js
│ ├── tailwind.config.js
│ │
│ ├── public/
│ │
│ └── src/
│ ├── app/
│ │ ├── page.tsx
│ │ ├── coordinator/
│ │ └── admin/
│ │
│ ├── components/
│ ├── lib/
│ └── styles/
│
└── exports/
Clone the repository
git clone https://github.com/vibhakar2007/clashcontrol.git
cd clashcontrolNavigate to backend directory
cd backendCreate virtual environment
python -m venv venvActivate environment
Windows
venv\Scripts\activate
Linux / macOS
source venv/bin/activate
Install dependencies
pip install -r requirements.txt
Run migrations
python manage.py migrate
Start server
python manage.py runserver
Backend runs at:
http://localhost:8000
Open another terminal
cd frontendInstall dependencies
npm install
Start development server
npm run dev
Frontend runs at:
http://localhost:3000
1️⃣ Start backend server
2️⃣ Start frontend server
3️⃣ Connect all coordinator devices to the same network
4️⃣ Coordinators open the dashboard from their phones
5️⃣ Admin monitors leaderboard in real time
- Real-time leaderboard updates
- QR code participant check-in
- Multi-event management
- Role-based authentication
- Event analytics
- Standalone desktop installer
This project is licensed under the MIT License.
See the LICENSE file for details.
Developed by Vibhakar S
ClashControl was created to simplify coordination of coding competitions and symposium technical events.
⚔️ Command Your Competition with ClashControl