"Turning hackathon chaos into organized innovation."
HackTrack is a modern, role-based hackathon management platform that streamlines everything from participant registration and QR check-ins to judging, team management, and live leaderboards—all from a single dashboard.
Production: https://err404-manager.vercel.app
HackTrack was built to simplify the logistics of organizing hackathons. Instead of juggling spreadsheets, forms, and multiple communication channels, organizers can manage the complete event lifecycle through one centralized application.
The platform provides dedicated portals for Participants, Judges, Admins, and Super Admins, ensuring each role has access only to the tools and information they need.
Whether you're running a university hackathon or a large-scale coding competition, HackTrack helps organizers focus on the event—not the operations.
| Module | Features |
|---|---|
| 👨💻 Participant | Registration, Authentication, Team Formation, QR Check-in, Food QR, Problem Statements, Certificate Download, Photo Uploads |
| ⚖️ Judge | Assigned Teams, Score Submission, Edit Evaluations, Feedback Management, Previous Scores |
| 🛠 Admin | Participant Management, Team Management, Bulk User Import, QR Operations, Food Distribution, Dashboard |
| 👑 Super Admin | Judge Assignment, Problem Statement Allocation, Team Management, Live Leaderboards, User Management |
| 🔐 Security | JWT Authentication, Role-Based Access Control (RBAC), Protected Routes, Permission-based Navigation |
HackTrack provides dedicated dashboards for every user role, ensuring that participants, judges, organizers, and administrators have access only to the tools they need.
| Category | Technology |
|---|---|
| Frontend | React 18 |
| Build Tool | Vite |
| Routing | React Router DOM |
| Styling | Tailwind CSS |
| State Management | Context API |
| HTTP Client | Axios |
| Authentication | JWT |
| Backend | Node.js + Express |
| Database | MongoDB |
| Deployment | Vercel |
HackTrack follows a role-based client-server architecture where authentication, routing, and business logic are separated into dedicated layers.
Browser
│
▼
React + Vite Client
│
React Router DOM
│
Authentication Layer
(AuthContext + JWT)
│
Protected Route Components
│
┌──────────────┼──────────────┐
▼ ▼ ▼
Participant Judge Admin
│
▼
Super Admin
│
▼
Express API
│
▼
MongoDB
- Authentication Layer manages user sessions using JWT tokens.
- Protected Routes restrict access based on user roles.
- Role-Based Dashboards isolate functionality for Participants, Judges, Admins, and Super Admins.
- REST API handles authentication, team management, QR operations, judging, and leaderboard generation.
- MongoDB stores users, teams, scores, and event data.
src/
├── components/
│ ├── AutoComplete.jsx
│ ├── GoBackButton.jsx
│ ├── Loader.jsx
│ └── ProtectedRoute.jsx
│
├── contexts/
│ └── AuthContext.jsx
│
├── pages/
│ ├── admin/
│ ├── auth/
│ ├── judge/
│ ├── participant/
│ └── superadmin/
│
├── services/
│ └── api.js
│
├── App.jsx
├── main.jsx
└── index.css
- Node.js 14+
- npm
- Running HackTrack Backend API
Clone the repository.
git clone https://github.com/rsayyed591/HackTrack-client.git
cd HackTrack-clientInstall dependencies.
npm installCreate an environment file.
cp .env.example .envConfigure your environment variables.
VITE_API_BASE_URL=http://localhost:5000Start the development server.
npm run dev| Variable | Description |
|---|---|
VITE_API_BASE_URL |
Backend API base URL |
- Route-based code splitting
- Live leaderboard updates using WebSockets
- Event analytics dashboard
- Email notifications
- Multi-event support
- Dark mode
- Export reports
- Docker deployment
Contributions are always welcome.
- Fork the repository.
- Create a feature branch.
git checkout -b feature/amazing-feature- Commit your changes.
git commit -m "feat: add amazing feature"- Push your branch.
git push origin feature/amazing-feature- Open a Pull Request.
Special thanks to Rehan Shah for designing and developing the backend architecture and APIs that power HackTrack.
GitHub: https://github.com/rehannn03
- 🌐 Portfolio: https://iamrehan.dev
- GitHub: https://github.com/rsayyed591
- LinkedIn: https://linkedin.com/in/rehan42