🎉 Gatherly

🎪 Modern Event Management & Ticketing Platform

A full-stack event management application built with Next.js 14, TypeScript, and MongoDB. Create events, manage bookings, and discover local experiences with a clean, modern interface.

🌐 Live Demo: gatherly.r2k.dev

📋 Table of Contents

🌟 Features
🛠️ Tech Stack
📱 Screenshots
🚀 Getting Started
📁 Project Structure
🔧 API Endpoints
🌐 Real-World Usage
🤝 Contributing
📄 License

🌟 Features

👥 For Attendees

Event Discovery: Browse and discover local events
Secure Booking: Book tickets with real-time availability and confirmation
User Dashboard: Manage profile, view booking history, and track events
Clean UI: Modern, responsive design with shadcn/ui components

🎭 For Organizers

Event Creation: Create detailed events with multiple ticket types
Image Upload: Upload event banners via Supabase integration
Booking Management: Track ticket sales
Role-based Access: Organizer-specific features and permissions

🔐 Authentication & Security

NextAuth Integration: Secure credential-based authentication
Email Verification: OTP-based account verification with Resend
Role Management: Attendee and organizer role separation
Form Validation: Comprehensive validation with Zod and React Hook Form

📋 Development Status

Note: This is a portfolio project focused on showcasing full-stack development skills and modern web technologies. Some features like notifications are UI-only components to demonstrate interface design.

✅ Completed Features

Authentication System: Complete NextAuth setup with credentials provider
User Management: Registration, login, email verification with Resend
Event Creation: Full event management with image upload via Supabase
Booking System: Ticket booking with real-time availability
Database Design: MongoDB with Mongoose ODM for all models
Form Handling: React Hook Form integration across all forms
UI Components: Clean, responsive design with shadcn/ui and Tailwind CSS
Role-based Access: Organizer vs attendee permissions and routing

� In Progress

Payment Integration: Stripe/PayPal integration for secure transactions
User Reviews: Event rating and review system
Ticket Management: Cancellation and refund functionality
Account Settings: Password change and profile management

� UI-Only Features

Notification Menu: Interface component without backend implementation (focus was on core functionality)

🛠️ Tech Stack

Frontend

Backend & Database

Authentication & Validation

Cloud Services

📱 Screenshots

🏠 Dashboard

Event discovery dashboard with clean, modern interface

🚀 Getting Started

Prerequisites

Node.js 18.x or later
npm or yarn
MongoDB Atlas account
Supabase account (for image uploads)
Resend account (for email verification)

Installation

Clone the repository

git clone https://github.com/riteshkrkarn/gatherly.git
cd gatherly

Install dependencies
```
npm install
# or
yarn install
```

Set up environment variables Create a .env.local file in the root directory:

MONGODB_URL=your_mongodb_atlas_connection_string
NEXTAUTH_SECRET=your_nextauth_secret
NEXTAUTH_URL=http://localhost:3000

# Supabase (for image uploads)
NEXT_PUBLIC_SUPABASE_URL=your_supabase_url
NEXT_PUBLIC_SUPABASE_ANON_KEY=your_supabase_anon_key
SUPABASE_SERVICE_ROLE_KEY=your_supabase_service_role_key

# Resend (for email verification)
RESEND_API_KEY=your_resend_api_key

# Stripe (for payments - optional)
STRIPE_PUBLISHABLE_KEY=your_stripe_publishable_key
STRIPE_SECRET_KEY=your_stripe_secret_key

Run the development server
```
npm run dev
# or
yarn dev
```
Open your browser Navigate to http://localhost:3000

📁 Project Structure

gatherly/
├── src/
│   ├── app/                    # Next.js 14 App Router
│   │   ├── (app)/             # Protected app routes
│   │   │   ├── about/         # About page
│   │   │   ├── booking-page/  # Ticket booking pages
│   │   │   ├── create-event/  # Event creation (organizers)
│   │   │   ├── dashboard/     # Main dashboard
│   │   │   ├── events/        # Event detail pages
│   │   │   ├── my-events/     # User's events/bookings
│   │   │   ├── profile-page/  # User profile
│   │   │   └── update-user/   # Profile update
│   │   ├── (auth)/            # Authentication routes
│   │   │   ├── sign-in/       # Login page
│   │   │   ├── sign-up/       # Registration page
│   │   │   └── verify-code/   # Email verification
│   │   ├── api/               # API routes
│   │   │   ├── auth/          # Authentication APIs
│   │   │   ├── book-ticket/   # Booking APIs
│   │   │   ├── check-username-unique/ # Username validation
│   │   │   ├── create-event/  # Event creation API
│   │   │   ├── events/        # Event-related APIs
│   │   │   ├── get-events/    # Event listing API
│   │   │   ├── get-my-events/ # User events API
│   │   │   ├── get-user/      # User data API
│   │   │   ├── update-user/   # User update API
│   │   │   └── verify-code/   # Email verification API
│   │   ├── favicon.ico        # App favicon
│   │   ├── globals.css        # Global styles
│   │   ├── layout.tsx         # Root layout
│   │   └── page.tsx           # Homepage
│   ├── components/            # Reusable components
│   │   ├── providers/         # Context providers
│   │   ├── ui/               # shadcn/ui & Origin UI components
│   │   │   ├── file-uploader.tsx
│   │   │   ├── notification-menu.tsx
│   │   │   ├── select-component.tsx
│   │   │   └── user-menu.tsx
│   │   └── [other components] # Custom components
│   ├── constants/             # App constants
│   │   └── eventConstants.ts  # Event-related constants
│   ├── helpers/               # Utility functions
│   │   └── sendVerificationEmail.ts # Email utilities
│   ├── hooks/                 # Custom React hooks
│   │   └── use-file-upload.ts # File upload hook
│   ├── lib/                   # Core utilities
│   │   ├── dbConnect.ts       # MongoDB connection
│   │   ├── resend.ts          # Email service config
│   │   ├── supabase.ts        # Supabase config
│   │   ├── upload.ts          # File upload utilities
│   │   └── utils.ts           # General utilities
│   ├── model/                 # MongoDB Mongoose models
│   │   ├── Booking.model.ts   # Booking schema
│   │   ├── Event.model.ts     # Event schema
│   │   └── User.model.ts      # User schema
│   ├── schemas/               # Zod validation schemas
│   │   ├── bookingValidationSchema.ts
│   │   ├── eventValidationSchema.ts
│   │   ├── loginValidationSchema.ts
│   │   ├── signupValidationSchema.ts
│   │   ├── updateUserValidationSchema.ts
│   │   └── verifyValidationSchema.ts
│   ├── types/                 # TypeScript definitions
│   │   └── next-auth.d.ts     # NextAuth type extensions
│   └── middleware.ts          # Next.js middleware
├── public/                    # Static assets
├── .env.local                # Environment variables
├── package.json
└── README.md

🔧 API Endpoints

Authentication

POST /api/auth/sign-up - User registration
POST /api/verify-code - Email verification
GET /api/check-username-unique - Check username availability

Events

GET /api/get-events - Get all events with pagination
GET /api/events/[id] - Get single event details
POST /api/create-event - Create new event (organizers only)

Bookings

POST /api/book-ticket/[id] - Book event tickets

Users

POST /api/update-user - Update user profile

🌐 Real-World Usage

🎭 Event Organizers

Local Businesses: Restaurants hosting wine tastings, cafes organizing book clubs
Educational Institutions: Universities hosting seminars, workshops, and conferences
Community Groups: Local clubs organizing meetups, charity events, and fundraisers
Entertainment Venues: Concert halls, theaters, and comedy clubs selling tickets

🎪 Event Attendees

Professionals: Finding networking events, conferences, and skill-building workshops
Students: Discovering educational seminars, career fairs, and campus events
Families: Finding family-friendly activities, festivals, and community events
Enthusiasts: Booking tickets for hobby-related events, sports, and entertainment

💼 Business Applications

Corporate Events: Company meetings, team building activities, and product launches
Non-profits: Fundraising events, awareness campaigns, and volunteer activities
Government: Public meetings, town halls, and community engagement events

🤝 Contributing

This is a portfolio project for showcasing full-stack development skills and learning modern web technologies. Contributions are welcome!

Ways to Contribute

Bug Reports: Found a bug? Open an issue with detailed information
Feature Requests: Have an idea? Create a feature request
Code Contributions: Fork the repo and submit a pull request
Documentation: Help improve the documentation

Development Guidelines

Follow TypeScript best practices
Use the established project structure
Write descriptive commit messages
Test your changes thoroughly
Update documentation as needed

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

Next.js Team for the amazing framework
Vercel for hosting and deployment
MongoDB for the database solution
shadcn/ui for the beautiful UI components
Open Source Community for the incredible tools and libraries

⭐ Star this repository if you find it helpful!

📞 Contact

X: riteshkrkarn
LinkedIn: riteshkrkarn

This project is actively being developed. Check back for updates and new features!

Name		Name	Last commit message	Last commit date
Latest commit History 47 Commits
.vscode		.vscode
emails		emails
public		public
src		src
.gitignore		.gitignore
README.md		README.md
components.json		components.json
eslint.config.mjs		eslint.config.mjs
next.config.ts		next.config.ts
package-lock.json		package-lock.json
package.json		package.json
postcss.config.mjs		postcss.config.mjs
tsconfig.json		tsconfig.json

riteshkrkarn/gatherly

Folders and files

Latest commit

History

Repository files navigation