🚀 ClubHub – Smart Club Management Platform

🌐 Live Demo: https://clubhub-frontend.vercel.app/ Login as Admin : email kabeer@gmail.com pass 123456 to view admin page

📌 Overview

ClubHub is a full-stack web platform designed to manage all activities of a student club in one place.

It enables:

• Members to participate in challenges & events
• Admins to manage everything efficiently
• Real-time tracking of performance via leaderboard

---

✨ Features

🔐 Authentication & Authorization

• Secure login & registration (JWT based)
• Role-based access (User / Admin)

---

👤 User Profile

• Avatar, bio, skills (tech stack)
• GitHub & LinkedIn integration
• Editable profile with view mode

---

📅 Events System

• View upcoming events
• Admin can create events
• Event details page

---

🧠 Challenges System

• Browse challenges
• Submit GitHub & live project links
• Track submissions

---

🏆 Leaderboard

• Rank users based on scores
• Real-time updates

---

👑 Admin Panel

• Create events & challenges
• View all members
• Review submissions
• Assign scores
• Upload gallery images

---

🖼️ Gallery

• Showcase club activities
• Admin-managed uploads

---

🛠️ Tech Stack

Frontend

• React (Vite)
• React Router
• Tailwind CSS
• Axios

Backend

• Node.js
• Express.js
• MongoDB (Mongoose)
• JWT Authentication
• Cloudinary (optional)

---

📂 Project Structure

frontend/
backend/

• frontend/ → React UI
• backend/ → Express API

---

⚙️ Installation

1️⃣ Clone repo

git clone https://github.com/your-username/clubhub.git
cd clubhub

---

2️⃣ Backend setup

cd backend
npm install
npm run dev

---

3️⃣ Frontend setup

cd frontend
npm install
npm run dev

---

🔑 Environment Variables

Create .env in backend:

MONGO_URI=your_mongodb_url
JWT_SECRET=your_secret
CLOUDINARY_NAME=xxx
CLOUDINARY_API_KEY=xxx
CLOUDINARY_API_SECRET=xxx

---

🚀 Deployment

• Frontend: Vercel
• Backend: Render

---

🎯 Key Highlights

• Full-stack MERN application

• Role-based admin system

• Real-time leaderboard

• Production-ready structure

---

👨‍💻 Author

Kabeer AR

---

⭐ Conclusion

ClubHub simplifies club management by combining: 👉 Events + Challenges + Leaderboard + Admin Control into a single powerful platform.

---

💡 Future Enhancements

• Notifications system
• AI-based recommendations
• Badges & achievements
• Mobile app version

---

⭐ If you like this project, give it a star!