🌐 EaseMyEvent — AI-Powered Event Management & Ticketing Platform

A next-generation, high-performance, real-time event booking, management, and ticketing ecosystem powered by intelligent AI and robust role isolation.

📖 Elevator Pitch

EaseMyEvent is a premium, secure, and real-time ticketing and event management ecosystem designed specifically to wow hackathon judges, recruiters, and modern developers alike. Operating on a robust React 19 + TanStack Start SSR core, the platform seamlessly coordinates with Supabase (PostgreSQL + RLS + Realtime) to offer lightning-fast client responses, ironclad security policies, and high-fidelity page rendering.

From AI-generated copywriting and schedule builders (Google Gemini) to secure server-side payment processing (Razorpay), and real-time check-in consoles with QR codes, EaseMyEvent represents the gold standard of modern SaaS applications.

✨ Key Features

Live Demo: https://easemyevent.vercel.app/

👤 Attendee Features

Intelligent Event Discovery: Filter, search, and browse categories of local or virtual events with curated lists and rapid performance.
Dynamic Ticket Booking: Intuitive registration flow. Includes an immediate bypass for free events and a robust Razorpay portal for paid options.
Instant QR Tickets: High-resolution, client-rendered QR codes automatically generate post-registration for effortless physical check-ins.
Wishlist Watcher: Save events instantly to a personalized wishlist, stored and synchronized across all active devices.
Verified Event Reviews: Review past events with dynamic star ratings and descriptions to share feedback with organizers.

🏢 Organiser Features

Comprehensive Event Builder: Create, update, and manage rich events featuring multiple ticket tiers, dates, and locations.
Rich Analytics Panel: Keep track of ticketing volume, attendee counts, categorizations, and revenue growth using real-time graphical representations.
Live Check-In Console: Seamlessly check in attendees manually or via a built-in scanner terminal with instant database state updates.
Automated Payout Tracker: Clear accounting view displaying processing, pending, and settled transaction logs.

👑 Admin Features

Centralized User Control: Review, edit, and instantly suspend users. Suspension activates a background security watchdog that forces immediate logout.
Global Event Moderation: Actively review, feature, or delete listings to maintain safety and compliance across the platform.
Refund Dispute Solver: Approve or reject payment refund requests with a single click, integrating directly with payment history profiles.

🧠 Advanced AI Features

Generative Event Copywriter: Provide raw bullet points and allow Google Gemini to craft professional, marketing-grade event descriptions in seconds.
Smart Schedule Optimizer: Automatically structures chronological event timelines, placing networking slots, lunch breaks, and keynotes into logical intervals.
Resilient Fallback Engine: If Gemini API quotas are exhausted, a smart template compiler seamlessly handles request loads to guarantee zero UI crashes.

🛠️ Technology Stack

Segment	Technology	Description
Frontend	React 19, TanStack Start	High-performance Server-Side Rendering (SSR) & Server Functions.
Styling & UI	Tailwind CSS, shadcn/ui, Framer Motion	Beautiful curated styling with dark/light themes, custom components, and smooth micro-animations.
Database	PostgreSQL (Supabase)	Robust tabular design with foreign key cascades, triggers, and indices.
Realtime Engine	Supabase Realtime & WebSockets	Instantly syncs check-ins, notifications, and user blocklists across terminals.
Auth & Security	Supabase Auth & Row-Level Security (RLS)	Custom authentication middleware with field-level RLS policies.
Integrations	Razorpay & Google Gemini AI	Secure payment orchestration (HMAC-SHA256 signature verification) and intelligent copy/schedule generation.

🏛️ Architecture & Database Diagram

EaseMyEvent uses a secure server-function execution model to prevent secret key leakage. Server functions interact directly with database clients while returning strictly typed schemas to the client interface.

graph TD
    Client[Client App: React 19 + TanStack Router] <-->|Server Functions| Server[TanStack Start Server Engine]
    Server <-->|Secure SDK Calls / RLS| DB[(Supabase Postgres Database)]
    Server <-->|API Key Auth| Gemini[Google Gemini AI Engine]
    Server <-->|Secure Keys / HMAC| Razorpay[Razorpay API Gateway]

🗄️ Relational Database Schema

The database features 20+ tables secured with strict Postgres RLS policies to prevent Cross-Tenant access.

erDiagram
    users ||--o{ events : organises
    categories ||--o{ events : classifies
    events ||--o{ ticket_types : offers
    events ||--o{ speakers : features
    registrations ||--o{ tickets : issues
    registrations ||--|| payments : invoices
    events ||--o{ registrations : accepts
    users ||--o{ registrations : makes

📂 Folder Structure

Event Sphere/
├── public/                     # Public static assets
│   ├── assets/
│   │   ├── EaseMyEvent_logo.png
│   │   └── favicon/            # Multi-format favicon structures
│   ├── og-image.png            # Generated high-resolution Open Graph image
│   ├── robots.txt              # Search engine crawler policies
│   └── sitemap.xml             # Main sitemap coordinates
├── src/
│   ├── components/             # Reusable UI & Layout components
│   │   ├── auth/               # Guards, session observers, login components
│   │   ├── shared/             # Navbar, Footer, Loading states, Event cards
│   │   └── ui/                 # Beautiful shadcn base components
│   ├── hooks/                  # Custom React hooks (React Query integrations)
│   ├── lib/                    # Constant values, utility helpers, and configurations
│   ├── routes/                 # File-based TanStack Router tree
│   │   ├── __root.tsx          # Global template containing structured JSON-LD
│   │   ├── admin/              # Admin moderation consoles
│   │   ├── auth/               # Access points (Login / Signup)
│   │   ├── categories/         # Dynamic category listings
│   │   ├── dashboard/          # Attendee dashboards & ticketing views
│   │   ├── events/             # Discovery and detailed description panels
│   │   └── organiser/          # Organiser events and payout management
│   ├── schemas/                # Shared Zod validation schemas
│   └── server/                 # Server-side API endpoints & integrations
└── supabase/
    └── migrations/             # Standardized PostgreSQL migrations

🔒 Security & Data Isolation Profile

Row-Level Security (RLS): Enforced globally. Users can only fetch registrations and ticket history containing their authenticated user_id.
Pre-Gate Account Status Check: Every route guard runs a strict pre-flight check. If the database profile is_active flag is flipped to false, access is immediately denied.
Forced Watchdog Termination: A real-time listener observes the active profile. If a user is suspended, a websocket signal triggers an instant supabase.auth.signOut(), rendering session cookies invalid and erasing active caches.
Server Function Protection: Payment verification checks and Gemini completions run inside sandboxed server environments, protecting payment secrets and API key configurations from browser inspection.

⚙️ Environment Variables

Prepare a .env file in the root directory:

# Supabase Core Config (Client & Server)
VITE_SUPABASE_URL=https://your-project-ref.supabase.co
VITE_SUPABASE_ANON_KEY=your-supabase-anon-key

# Google Gemini AI Integrations (Server Only)
GEMINI_API_KEY=your-google-gemini-api-key

# Razorpay Payment Gateway (Server Only)
RAZORPAY_KEY_ID=your-razorpay-key-id
RAZORPAY_KEY_SECRET=your-razorpay-key-secret

🚀 Installation & Local Setup

Follow these steps to run a completely functional development clone locally:

1. Pre-requisites & Node Installation

Ensure you have Node.js (v18+) installed. Clone the repository and run:

npm install

2. Database & Schema Initialization

Create a new project on Supabase. Navigate to the SQL Editor of your project and run the migration scripts located in supabase/migrations/ sequentially:

001_schema.sql: Configures database structure, custom types, and default tables.
002_rls_policies.sql: Attaches Row-Level Security rules.
003_storage.sql: Registers file upload buckets for speaker portraits and banners.
004_functions.sql: Binds backend triggers, such as auto-syncing authentication profiles.
005_seed.sql: Populates categories, sample tech events, reviews, and test users.

3. Run Development Server

Once dependencies are configured and the environment variables are saved, boot up the local dev server:

npm run dev

The application will begin serving at http://localhost:3000.

⚡ Production Deployment (Vercel)

EaseMyEvent is fully configured and optimized for zero-overhead deployments on Vercel:

Push your active codebase changes to your private/public GitHub repository.
Log into your Vercel Dashboard and click Add New > Project.
Select and import the cloned repository.
Open the Environment Variables accordion and paste your production API secrets (VITE_SUPABASE_URL, GEMINI_API_KEY, etc.).
Click Deploy. Vercel will automatically identify TanStack Start and output serverless edge functions for all server pipelines.

🗺️ Future Roadmap

Facial Recognition Check-in: Integrate automated scan portals for touchless entry verification.
Offline Booking Synchronizer: Cache ticket purchases locally inside service workers, syncing once internet connections stabilize.
Multi-currency Gateway Routing: Support global booking currencies by dynamically routing payments based on user locales.

👥 Contributors & Team

🚀 Core Team

Amit — Team Lead, Database Design, Backend Development & UI/UX Enhancement
GitHub: https://github.com/mello911
Sonajit — Frontend Development, System Architecture, Authentication, Integrations, Deployment & Project Implementation
GitHub: https://github.com/s0n4jit
Rajmohan — Razorpay Integration & UI/UX Enhancement GitHub: https://github.com/USER-00001-IND

📄 License

This project is licensed under the MIT License. Check out the license files for details.

Name		Name	Last commit message	Last commit date
public		public
src		src
supabase/migrations		supabase/migrations
.env.example		.env.example
.gitignore		.gitignore
LICENSE.md		LICENSE.md
README.md		README.md
biome.json		biome.json
components.json		components.json
package-lock.json		package-lock.json
package.json		package.json
tsconfig.json		tsconfig.json
vite.config.ts		vite.config.ts

Navigation Menu

Repository navigation

About

Repository files navigation

🌐 EaseMyEvent — AI-Powered Event Management & Ticketing Platform

📖 Elevator Pitch

✨ Key Features

👤 Attendee Features

🏢 Organiser Features

👑 Admin Features

🧠 Advanced AI Features

🛠️ Technology Stack

🏛️ Architecture & Database Diagram

🗄️ Relational Database Schema

📂 Folder Structure

🔒 Security & Data Isolation Profile

⚙️ Environment Variables

🚀 Installation & Local Setup

1. Pre-requisites & Node Installation

2. Database & Schema Initialization

3. Run Development Server

⚡ Production Deployment (Vercel)

🗺️ Future Roadmap

👥 Contributors & Team

🚀 Core Team

📄 License

About

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

🌐 EaseMyEvent — AI-Powered Event Management & Ticketing Platform

📖 Elevator Pitch

✨ Key Features

👤 Attendee Features

🏢 Organiser Features

👑 Admin Features

🧠 Advanced AI Features

🛠️ Technology Stack

🏛️ Architecture & Database Diagram

🗄️ Relational Database Schema

📂 Folder Structure

🔒 Security & Data Isolation Profile

⚙️ Environment Variables

🚀 Installation & Local Setup

1. Pre-requisites & Node Installation

2. Database & Schema Initialization

3. Run Development Server

⚡ Production Deployment (Vercel)

🗺️ Future Roadmap

👥 Contributors & Team

🚀 Core Team

📄 License

About

Topics

Resources

Stars

Watchers

Forks

Contributors

Languages