A modern student clubs & events platform — centralizes club management, event creation, registrations, and analytics in a dual-portal (Student + Admin) web app built for colleges.
Polished UI, secure backend, and full-stack scalability.
 |
 |
 |
 |
VIT ClubHub was designed to eliminate fragmented event communication and spam across multiple clubs at VIT Bhopal.
It provides a unified interface for students to explore, register, and participate — and for admins to manage events, attendance, and analytics effortlessly.
- Real-world product solving actual student community pain points.
- Demonstrates end-to-end full-stack engineering.
- Role-based authentication, modular code, and reusable UI components.
- Fully responsive and ready for deployment (Render + Vercel).
- Browse & join clubs by category (Technical, Non-Technical, Regional)
- Register for upcoming events with one click
- Track participation history and rates
- Explore events with filters and categories
- Create, edit, and manage events
- Set deadlines, capacities, and locations
- Track total registrations and attendance
- Upload event images and materials
- View event analytics and participation stats
- Role-based Authentication (Students, Club Admins, Super Admin)
- Event lifecycle:
Draft → Published → Registration Closed → Completed - RESTful APIs and JWT Authentication
- File/Image upload with Cloudinary (or local fallback)
- Responsive, modern UI built with Tailwind CSS
| Layer | Technology |
|---|---|
| Frontend | React.js, Vite, Tailwind CSS, Axios |
| Backend | Node.js, Express.js |
| Database | MongoDB (Mongoose ORM) |
| Authentication | JWT-based (JSON Web Token) |
| Storage | Cloudinary / AWS S3 |
| DevOps | Docker, GitHub Actions CI/CD |
| Deployment | Render (Backend), Vercel (Frontend) |
- Frontend: Handles UI/UX, authentication, and API integration.
- Backend: Provides secure APIs, role management, and business logic.
- Database: Stores clubs, users, events, and registrations.
- Cloud: Stores images and assets for scalability.
- Node.js (v16+)
- MongoDB (local or Atlas)
- npm or yarn
- Docker (optional)
# Clone repository
git clone https://github.com/AmanTiwari404/Vit-ClubHub.git
cd Vit-ClubHub
# Setup environment
cp backend/.env.example backend/.env
cp frontend/.env.example frontend/.env
# Install dependencies
cd backend && npm install
cd ../frontend && npm install
# Start backend
cd ../backend
npm run dev
# Start frontend
cd ../frontend
npm run dev