🎉 Eventify - Event Management Platform

A modern, full-stack event management and registration system built with Next.js 16, TypeScript, and PostgreSQL

📖 About

Eventify is a production-ready event management platform that enables organizers to create and manage events while providing attendees with a seamless event discovery and registration experience. Built with modern web technologies and featuring a premium glassmorphism UI design.

✨ Key Features

🔐 Authentication & Authorization

• Secure user registration with role selection (Organizer/Attendee)
• Email and password authentication
• Session management with NextAuth.js v5
• Role-based access control (RBAC)
• Protected routes and API endpoints

📅 Event Management (Organizers)

• Create events with comprehensive details
• Edit and delete owned events
• View registered attendees list
• Real-time capacity tracking
• Event statistics dashboard
• Image upload integration (Cloudinary)

🔍 Event Discovery (Attendees)

• Browse all available events
• Advanced filtering by category and status
• Real-time search functionality
• Detailed event information pages
• Responsive event cards with status badges

📝 Registration System

• One-click event registration
• Real-time capacity validation
• Registration cancellation
• "My Events" dashboard
• Registration status tracking

🎨 Modern UI/UX

• Dark theme with glassmorphism design
• Indigo-purple gradient accents
• Smooth animations and micro-interactions
• Mobile-first responsive design
• Optimized for all screen sizes

🛠️ Tech Stack

Frontend

• Framework: Next.js 16 (App Router)
• Language: TypeScript
• Styling: Tailwind CSS 4
• UI Components: Custom components with Lucide React icons
• State Management: React Hooks
• Notifications: React Hot Toast

Backend

• API: Next.js API Routes
• Database: PostgreSQL
• ORM: Prisma
• Authentication: NextAuth.js v5
• Password Hashing: bcryptjs

Infrastructure

• Image Storage: Cloudinary
• Deployment: Vercel-ready
• Database Hosting: Compatible with Neon, Supabase, Railway

🚀 Getting Started

Prerequisites

• Node.js 18 or higher
• PostgreSQL database (local or cloud-hosted)
• npm or yarn package manager

Installation

1. Clone the repository

   git clone https://github.com/Pusri27/eventify-platform.git
   cd eventify-platform

2. Install dependencies

   npm install

3. Set up environment variables

   cp .env.example .env.local

   Configure the following variables in .env.local:

   # Database
   DATABASE_URL="postgresql://username:password@localhost:5432/eventify"
   
   # NextAuth
   NEXTAUTH_SECRET="your-secret-key-here"
   NEXTAUTH_URL="http://localhost:3000"
   
   # Cloudinary (Optional - for image uploads)
   NEXT_PUBLIC_CLOUDINARY_CLOUD_NAME="your-cloud-name"
   CLOUDINARY_API_KEY="your-api-key"
   CLOUDINARY_API_SECRET="your-api-secret"

4. Set up the database

   npx prisma db push

5. Run the development server

   npm run dev

6. Open your browser

   Navigate to http://localhost:3000
   

📁 Project Structure

eventify-platform/
├── prisma/
│   └── schema.prisma          # Database schema
├── public/                    # Static assets
├── src/
│   ├── app/
│   │   ├── api/              # API routes
│   │   │   ├── auth/         # Authentication endpoints
│   │   │   ├── events/       # Event CRUD endpoints
│   │   │   ├── register/     # User registration
│   │   │   └── user/         # User-specific endpoints
│   │   ├── dashboard/        # Dashboard pages
│   │   │   ├── manage-events/
│   │   │   ├── my-events/
│   │   │   └── profile/
│   │   ├── events/           # Event pages
│   │   ├── login/            # Login page
│   │   ├── register/         # Registration page
│   │   ├── globals.css       # Global styles
│   │   ├── layout.tsx        # Root layout
│   │   └── page.tsx          # Landing page
│   ├── components/
│   │   ├── events/           # Event-related components
│   │   ├── layout/           # Layout components (Navbar, Footer)
│   │   └── Providers.tsx     # Client-side providers
│   ├── lib/
│   │   ├── auth.ts           # NextAuth configuration
│   │   ├── prisma.ts         # Prisma client
│   │   └── utils.ts          # Utility functions
│   └── types/
│       └── next-auth.d.ts    # TypeScript type augmentation
├── .env.example              # Environment variables template
├── next.config.ts            # Next.js configuration
├── tailwind.config.ts        # Tailwind CSS configuration
└── tsconfig.json             # TypeScript configuration

🗄️ Database Schema

Models

• User - User accounts with role-based access (ORGANIZER/ATTENDEE)
• Event - Event information with organizer relations
• Registration - Event registrations with status tracking

Key Features

• Proper relational design with foreign keys
• Cascade deletes for data integrity
• Indexes on frequently queried fields
• Unique constraints for business logic
• Timestamp tracking (createdAt, updatedAt)

📡 API Endpoints

Method	Endpoint	Description	Auth Required
POST	/api/register	Register new user	❌
GET	/api/events	List events with filters & pagination	❌
POST	/api/events	Create new event	✅ Organizer
GET	/api/events/[id]	Get event details	❌
PUT	/api/events/[id]	Update event	✅ Owner
DELETE	/api/events/[id]	Delete event	✅ Owner
POST	/api/events/[id]/register	Register to event	✅ Attendee
DELETE	/api/events/[id]/register	Cancel registration	✅ Attendee
GET	/api/events/[id]/attendees	Get attendee list	✅ Organizer
GET	/api/user/events	Get user's registered events	✅
GET	/api/user/organized-events	Get organizer's events	✅ Organizer

🎨 Design System

Color Palette

• Background: Deep black with subtle gradients
• Accent: Indigo-purple gradient (#6366f1 → #a855f7)
• Text: White with varying opacity levels
• Borders: Subtle white with low opacity

Key Design Features

• Glassmorphism effects with backdrop blur
• Smooth transitions and hover states
• Gradient text and button accents
• Custom scrollbar styling
• Responsive grid layouts

🔑 Environment Variables

Variable	Description	Required
DATABASE_URL	PostgreSQL connection string	✅
NEXTAUTH_SECRET	Secret key for NextAuth.js	✅
NEXTAUTH_URL	Base URL of the application	✅
NEXT_PUBLIC_CLOUDINARY_CLOUD_NAME	Cloudinary cloud name	❌
CLOUDINARY_API_KEY	Cloudinary API key	❌
CLOUDINARY_API_SECRET	Cloudinary API secret	❌

🚢 Deployment

Vercel (Recommended)

1. Push your code to GitHub
2. Import project in Vercel
3. Configure environment variables
4. Deploy

Database Hosting Options

• Neon - Serverless PostgreSQL (Free tier available)
• Supabase - Open-source Firebase alternative
• Railway - Infrastructure platform
• Render - Cloud application hosting

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.

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

📝 License

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

👨‍💻 Author

Pusri27

• GitHub: @Pusri27

🙏 Acknowledgments

• Next.js team for the amazing framework
• Vercel for hosting and deployment platform
• Prisma for the excellent ORM
• All open-source contributors

---

⭐ If you find this project helpful, please consider giving it a star!