🎟️ EventHub

A centralized college event management platform for discovering events, managing RSVPs, and handling secure event check-ins.

EventHub brings students, clubs, and administrators into one platform for managing the complete college-event lifecycle — from event creation and approval to RSVP management and attendance tracking.

✨ Features

👨‍🎓 For Students

• Browse published college events
• View complete event details
• RSVP for events
• Automatic waitlisting when events reach capacity
• View and manage personal RSVPs
• Generate QR-based event passes
• Check in to events using QR codes

🏛️ For Clubs & Organizers

• Create and edit events
• Submit events for administrator approval
• Set event capacity and location
• View registered attendees
• Track RSVPs and attendance
• Scan attendee QR codes
• View event statistics and check-in data
• Cancel events when required

🛡️ For Administrators

• Review submitted events
• Approve or reject events
• Provide rejection reasons
• Manage the overall event ecosystem
• Monitor event and attendance activity

📱 QR Check-In

EventHub includes a QR-based attendance system that verifies:

QR Code
   ↓
Event
   ↓
RSVP
   ↓
Verification
   ↓
Attendance

It supports both camera-based QR scanning and QR image scanning.

🧩 Event Lifecycle

Create Event
     ↓
Pending Review
     ↓
 ┌───────────────┐
 │               │
Approved       Rejected
 │
 ↓
Published
 │
 ↓
Student RSVP
 │
 ├── Capacity Available → Going
 │
 └── Capacity Full → Waitlist
          ↓
      Event Day
          ↓
      QR Check-In
          ↓
      Attendance Recorded

🛠️ Tech Stack

Technology	Purpose
React 19	Frontend UI
TypeScript	Type-safe development
Vite	Development & build tooling
Firebase	Authentication & database
Firestore	Event, RSVP & attendance data
Tailwind CSS	Styling
Zustand	Application state management
React Router	Navigation
html5-qrcode	QR code scanning
qrcode.react	QR code generation
Lucide React	Icons
Motion	UI animations
Express + TSX	Development server / API support
Gemini API	AI-powered functionality

🏗️ Project Structure

src/
├── app/
│   ├── navigation/
│   └── store/
│
├── features/
│   ├── admin/
│   ├── auth/
│   ├── events/
│   ├── organizer/
│   └── scanner/
│
├── lib/
│   └── firebase.ts
│
├── shared/
│   ├── layout/
│   ├── lib/
│   └── ui/
│
└── types/

The application follows a feature-based architecture, keeping authentication, events, administration, organizer functionality, and QR scanning separated for easier maintenance.

🚀 Getting Started

Prerequisites

• Node.js
• npm
• Firebase project
• Required environment variables

Installation

git clone <your-repository-url>
cd Event-Hub

npm install

Environment Variables

Create a .env.local file and configure the required environment variables based on .env.example.

Do not commit API keys or Firebase secrets to the repository.

Run Development Server

npm run dev

Build for Production

npm run build

Type Check

npm run lint

🔐 Security

EventHub uses Firebase Authentication and Firestore security rules to control access to application data.

The event and attendance system also associates QR check-ins with the corresponding event and RSVP, helping prevent invalid or duplicate attendance records.

🎯 Core Data Model

The application revolves around four primary entities:

User
 ├── Student
 ├── Club / Organizer
 └── Admin

Event
 ├── Organizer
 ├── RSVPs
 └── Attendance

RSVP
 └── User + Event

Attendance
 └── RSVP + Check-in

🔮 Future Improvements

• Push notifications for upcoming events
• Calendar integration
• Event reminders
• Advanced attendance analytics
• University-wide event search
• Better organizer analytics
• Event recommendations
• Digital certificates for attendees
• Multi-university support

📌 Project Status

Active Development

EventHub is being developed as a modern college event management platform with a focus on simple event discovery, reliable RSVP management, and secure attendance tracking.

📄 License

This project is currently for educational and development purposes.