🚀 Dev Event Platform – Full-Stack Event Management App

Next.js 16 powered event management and analytics platform that simplifies event creation, booking, and tracking.
Built with Next.js, TypeScript, MongoDB, Cloudinary, and PostHog for a production-ready experience.

---

📋 Table of Contents

• 📋 Table of Contents
• ✨ Introduction
• ⚙️ Tech Stack
  • 🧩 Frontend
  • 🗄️ Backend
• 🔋 Core Features
• 🤸 Quick Start
  • Prerequisites
  • 1️⃣ Clone Repository
  • 2️⃣ Install Dependencies
  • 3️⃣ Set Up Environment Variables
  • 4️⃣ Run the Project
• 🧱 Project Structure
• 🧠 Architecture Overview
  • 🧩 Frontend (Next.js 16)
  • ⚙️ Backend (API Routes)
  • 📊 Analytics Layer
• 🚀 Future Enhancements
• 🤝 Contribution
• 🔗 Contacts
• 📄 License
• 🙏 Acknowledgements
• ⭐ Show Your Support

---

✨ Introduction

Dev Event Platform is a modern event management and discovery platform designed to help users create, manage, and explore developer events effortlessly.

It features:

• Dynamic home page for upcoming events
• Secure event creation and booking
• Image uploads with Cloudinary
• Analytics and tracking powered by PostHog
• Reusable, scalable architecture with Next.js 16 App Router

Whether you’re hosting or attending, this platform delivers a smooth experience across both frontend and backend.

---

⚙️ Tech Stack

🧩 Frontend

• Next.js 16 – Modern React framework with server actions and caching
• TypeScript – Type-safe, maintainable codebase
• Tailwind CSS – Utility-first styling for fast, responsive UIs

🗄️ Backend

• MongoDB + Mongoose – NoSQL database for event and booking storage
• Next.js API Routes – Secure serverless endpoints for CRUD operations
• Cloudinary – Media upload and optimization
• PostHog – Event tracking and analytics integration
• CodeRabbit – AI-powered code review and scaffolding
• Warp – Fast, collaborative terminal for efficient development

---

🔋 Core Features

👉 Home Page – Displays upcoming and featured events dynamically
👉 Event Creation – Secure form-based event creation via MongoDB
👉 Event Details Page – Includes agendas, images, and similar events
👉 Booking System – Allows users to register for events
👉 Cloudinary Uploads – Easy, optimized media handling
👉 PostHog Analytics – Track user actions, engagement, and conversions
👉 Next.js 16 Caching – Improved performance with built-in revalidation
👉 Reusable Components – Modular and maintainable UI system

---

🤸 Quick Start

Prerequisites

Make sure you have:

• Git
• Node.js
• npm

1️⃣ Clone Repository

git clone https://github.com/Itssanthoshhere/Dev-Event-Platform.git
cd Dev-Event-Platform

2️⃣ Install Dependencies

npm install

3️⃣ Set Up Environment Variables

Create a .env file in your root directory and add:

NEXT_PUBLIC_BASE_URL=http://localhost:3000/

MONGODB_URI=

CLOUDINARY_URL=

NEXT_PUBLIC_POSTHOG_KEY=
NEXT_PUBLIC_POSTHOG_HOST=https://eu.i.posthog.com

Replace placeholders with your actual credentials from Cloudinary, MongoDB Atlas, and PostHog.

4️⃣ Run the Project

npm run dev
# or
yarn dev
# or
pnpm dev
# or
bun dev

Visit http://localhost:3000 in your browser.

---

🧱 Project Structure

Dev-Event-Platform/
├── app/
│   ├── api/
│   │   └── events/
│   │       └── route.ts
│   ├── (root)/
│   │   ├── page.tsx
│   │   └── layout.tsx
│   └── event/
│       └── [slug]/
│           └── page.tsx
├── components/
│   ├── EventCard.tsx
│   ├── BookEvent.tsx
│   └── ...
├── lib/
│   ├── mongodb.ts
│   └── actions/
│       └── event.actions.ts
├── database/
│   └── event.model.ts
├── public/
│   └── readme/
│       └── readme-hero.webp
└── package.json

---

🧠 Architecture Overview

🧩 Frontend (Next.js 16)

• Uses App Router with server actions and React Server Components
• Leverages cache tagging and ISR for optimized performance
• Client-side event registration with smooth transitions

⚙️ Backend (API Routes)

• RESTful endpoints for creating and fetching events
• Mongoose-based schema validation and CRUD operations
• Serverless architecture hosted seamlessly with Next.js

📊 Analytics Layer

• Integrated PostHog for tracking:

  • Event creation rates
  • Page visits and user engagement
  • Booking conversions

---

🚀 Future Enhancements

• ✅ Implement authentication with NextAuth.js
• 🔔 Add email notifications for registrations
• 📱 Create an admin dashboard for event management
• 🌍 Enable global event discovery with filters and maps
• 🧠 Integrate AI recommendations for personalized events

---

🤝 Contribution

Contributions are always welcome!

1. Fork the repo

2. Create a feature branch:

   git checkout -b feature/my-feature

3. Commit your changes:

   git commit -m "feat: add my feature"

4. Push and open a Pull Request 🎉

---

🔗 Contacts

• GitHub: Itssanthoshhere
• LinkedIn: Santhosh VS

---

📄 License

This project is for educational and portfolio purposes only. All images, logos, and assets belong to their respective owners.

---

🙏 Acknowledgements

• JavaScript Mastery – Project inspiration
• Next.js – Full-stack React framework
• Cloudinary – Image hosting
• MongoDB Atlas – Database platform
• PostHog – Product analytics
• TailwindCSS – Styling framework

---

⭐ Show Your Support

If you like this project, give it a ⭐ on GitHub and share it with others! Let’s build together 🚀

---