EventHub - College Event Management Platform

EventHub is a comprehensive web application designed to streamline the management and participation of college events. Built with React, Tailwind CSS, and Supabase, it provides an intuitive interface for students to discover, create, and participate in various college events.

Features

• Event Discovery: Browse and search through various college events
• Event Creation: Create and manage technical and non-technical events
• Team Management: Form teams and manage team registrations
• User Profiles: Complete profile management with progress tracking
• Department Filters: Filter events by different engineering departments
• Real-time Updates: Get instant updates on event registrations and team formations

Tech Stack

• Frontend:

  • React
  • Tailwind CSS
  • shadcn/ui Components

• Backend:

  • Supabase (Database & Authentication)
  • Node.js
  • Express.js

Prerequisites

• Node.js (v18 or higher)
• npm or yarn
• Supabase account
• Docker & Docker Compose (optional, for containerized setup)

Getting Started

Option A: Using Docker (Recommended for Dev)

1. Clone the repository:

   git clone https://github.com/This-Is-My-GitHub-Account/EventHub
   cd EventHub

2. Create a .env file in the root directory and add your Supabase credentials:

   VITE_SUPABASE_URL=your_supabase_url
   VITE_SUPABASE_ANON_KEY=your_supabase_anon_key
   SUPABASE_URL=your_supabase_url
   SUPABASE_ANON_KEY=your_supabase_anon_key

3. Start services in development mode with live-reload:

   docker compose up --build

4. Open in browser:

   • Frontend: http://localhost:5173
   • Backend API: http://localhost:3000

5. To stop and remove containers:

   docker compose down

Option B: Local Setup (No Docker)

1. Clone the repository and install dependencies:

   git clone https://github.com/This-Is-My-GitHub-Account/EventHub
   cd EventHub
   npm install
   cd src/server && npm install && cd ../..

2. Create a .env file in the root directory and add your Supabase credentials:

   VITE_SUPABASE_URL=your_supabase_url
   VITE_SUPABASE_ANON_KEY=your_supabase_anon_key
   SUPABASE_URL=your_supabase_url
   SUPABASE_ANON_KEY=your_supabase_anon_key

3. In one terminal, start the backend server:

   cd src/server
   npm run dev    # uses nodemon to watch for changes

4. In another terminal, start the frontend dev server:

   cd EventHub
   npm run dev    # starts Vite on port 5173

5. Open in browser:

   • Frontend: http://localhost:5173
   • Backend API: http://localhost:3000

Setting up Supabase

1. Create a new Supabase project
2. Use the migration files in the supabase/migrations folder to set up your database schema
3. Enable Row Level Security (RLS) policies as defined in the migrations

Detailed Features

Authentication

• Email and password authentication
• Protected routes
• Profile completion tracking

Event Management

• Create technical and non-technical events
• Set registration deadlines
• Manage team sizes and requirements
• Upload event images
• Set prizes and important dates

Team Formation

• Create teams for events
• Search and invite team members
• Manage team registrations
• View team status and members

User Dashboard

• View registered events
• Track created events
• Monitor registration status
• Update profile information

Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

Acknowledgments

• Supabase for the backend infrastructure
• Tailwind CSS for the styling system
• shadcn/ui for the component library