Evntix — A Modern Event Management Platform

📋 Table of Contents

1. ✨ Introduction
2. ⚙️ Tech Stack
3. 🔋 Features
4. 🚀 Live Demo
5. 📸 Screenshots
6. 🤸 Quick Start
7. 🚀 Deployment

✨ Introduction

Evntix is a modern full-stack event management platform designed to organize, promote, and track events seamlessly.
It features a dynamic homepage with upcoming and featured events, secure API endpoints for CRUD operations, image uploads powered by Cloudinary, individual event detail pages, and analytics to monitor engagement.

Whether you’re an event organizer or a curious learner, Evntix demonstrates how to build a production-ready, data-driven web application with clean architecture and performance optimization in mind.

⚙️ Tech Stack

• Next.js — Full-stack React framework for modern web applications with server-side rendering and static site generation.
• TypeScript — Strongly typed JavaScript for better code reliability and scalability.
• Tailwind CSS — Utility-first CSS framework for rapid UI development.
• MongoDB — NoSQL document database for fast and flexible data storage.
• Mongoose — ODM layer to model and manage MongoDB data elegantly.
• Cloudinary — Media management and image optimization in the cloud.
• PostHog — Open-source analytics for event tracking and user behavior insights.
• Warp — Developer-focused terminal for efficiency and collaboration.
• CodeRabbit — AI-assisted code generation and review tool for developers.

🔋 Features

✨ Dynamic Home Page — View and browse featured and upcoming events with clean, responsive UI.
⚡ CRUD Operations — Full API routes to create, update, delete, and retrieve events.
☁️ Cloudinary Integration — Upload and manage event images effortlessly.
🎟️ Event Detail Pages — Explore detailed event info, register, and view similar events.
🚀 Next.js 16 Caching — Leverages cutting-edge caching for lightning-fast load times.
📊 PostHog Analytics — Monitor performance and user interactions to improve engagement.

And much more — including clean code structure, reusability, and scalability for real-world deployments.

🚀 Live Demo

Here is a working live demo : evntix.vercel.app/

📸 Screenshots

🤸 Quick Start

Follow these steps to run Evntix locally:

Prerequisites

Ensure you have installed:

• Git
• Node.js
• npm

1️⃣ Cloning the Repository

git clone https://github.com/AymenGabsi/event-platform-nextjs16.git
cd evntix

2️⃣ Installing Dependencies

npm install

3️⃣ Set Up Environment Variables

Create a .env file in the project root and include the following:

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 these placeholders with your actual keys and URLs from your chosen services.

4️⃣ Running the Project

npm run dev

Then visit http://localhost:3000 in your browser 🚀

🚀 Deployment

Deploy to Vercel

npm run build
vercel deploy

Configure Environment Variables on Vercel

1. Go to your Vercel dashboard.
2. Navigate to your project settings.
3. Under the Environment Variables section, add all variables from your .env.local file.
4. Deploy your project!

👥 Contributing

We welcome contributions! To contribute:

1. Fork the repo.
2. Create a new branch: git checkout -b feature-name.
3. Make your changes and commit: git commit -m 'Added new feature'.
4. Push to the branch: git push origin feature-name.
5. Open a Pull Request and describe your changes.

Contribution Guidelines

• Follow the existing coding style.
• Write clear, concise commit messages.
• Ensure new features are properly documented.
• Test changes thoroughly before submitting a PR.

---

📝 License

This project is licensed under the MIT License.

---

📧 Contact

For questions, feedback, or collaborations:

• Email: aymengabsi.se@gmail.com
• GitHub Issues: Open an issue
• Community Chat: Join our Discord server