Clueminati 3.0

Clueminati 3.0 is CodeChef VIT's annual treasure hunt event, back with its 3rd edition in 2025. This web application enables seamless team creation, score tracking, and real-time leaderboard management—ensuring participants enjoy an engaging and competitive experience throughout the event.

---

🌐 Deploy

https://clueminati.codechefvit.com

⚙️ Tech Stack

• Next.js
• TypeScript
• Tailwind CSS
• React Hot Toast
• Axios
• Shadcn
• MongoDB

💡 Features

• Home Page — central hub for navigation and quick access to event features.
• Scanner Page — scan QR codes to fetch questions during the treasure hunt.
• Questions Page — view, attempt, and submit answers to event questions.
• Admin Dashboard — manage teams, monitor scores, and update the leaderboard.
• Team Management — participants can easily create or join teams.
• Dynamic Leaderboard — real-time ranking updates for all teams.
• Responsive Design — optimized for all devices and screen sizes.

🖼 Screenshots

Login Page	Join Team	Create Team
Home	Home	Leaderboard
Profile	Scanner	Questions
Admin Dashboard

🏁 Getting Started

1. Clone the repository

   git clone -b main https://github.com/CodeChefVIT/clueminati-2025
       clueminati-2025.git
   cd clueminati-portal-3.0

2. Install dependencies

   pnpm i

3. Set up environment variables

   cp .env.example .env

   Update the values in .env (especially your MongoDB connection URI).

4. Database setup (MongoDB)

   Ensure your MONGODB_URI (or equivalent) points to your MongoDB/Atlas instance. Create any required indexes/seed data if your app provides scripts.

5. Run the development server

   pnpm dev

📝 Notes

• To access admin APIs, set the user role as admin in the database.
• API documentation: Postman Docs.

🚀 Contributors

Harshit Kashyap Sharma	Ayman	Narendra Sadhukhan	Hardik
Sajith M	Harsheta Bhardwaj	Rohith JN	Sanjana Shyamsundar
Rupesh Tripathi	Abhinav	Soham Mahapatra	Samya Mehta

📜 License

This project is licensed under the MIT License.

Made by CodeChef-VIT