🚀 EvConnect

🌐 Community Event Sharing Platform (MERN Stack)

---

✨ Overview

EvConnect is a modern, full-stack web application that enables users to discover, create, and participate in community events seamlessly.
Built using the MERN Stack, the platform focuses on usability, scalability, and real-world event management workflows.

🎯 Designed as an academic + portfolio project integrating OOAD, SPM, and Software Testing concepts

---

🔥 Key Features

👤 Authentication

• Secure user registration & login
• Session handling using local storage
• Role-based UI rendering

📅 Event Management

• Create, update, and delete events
• Upload event details (title, date, location, description)
• Organized event listings

🎟️ Event Registration

• Register for events
• View "My Registrations"
• Prevent duplicate registrations

🔍 Event Discovery

• Browse all events
• Search & filter functionality

🎨 Modern UI/UX

• SaaS-style design
• Glassmorphism UI
• Fully responsive layout
• Dark theme support
• Smooth animations (AOS)

📬 Contact System

• Elegant contact page
• User query submission UI

---

🧠 Academic Integration

This project is developed as part of:

• 📘 OOAD (Object-Oriented Analysis & Design)
• 📊 SPM (Software Project Management)
• 🧪 ST (Software Testing)

Includes:

• Use Case Diagrams
• Class Diagrams
• Agile Sprint Planning (Trello)
• Test Case Design

---

🛠️ Tech Stack

💻 Frontend

• React.js
• Tailwind CSS
• Axios
• AOS (Animate On Scroll)
• Lucide Icons

⚙️ Backend

• Node.js
• Express.js
• MongoDB (Atlas)
• Mongoose

---

🏗️ Project Architecture

client/
├── src/
│   ├── components/
│   ├── pages/
│   ├── context/
│   ├── api/
│   ├── App.jsx
│   └── main.jsx

server/
├── models/
├── routes/
├── controllers/
├── middleware/
├── config/
└── server.js

---

⚙️ Setup Instructions

1️⃣ Clone the Repository

git clone https://github.com/your-username/eventconnect.git
cd eventconnect

---

2️⃣ Backend Setup

cd server
npm install

Create .env file:

PORT=5000
MONGO_URI=your_mongodb_uri
JWT_SECRET=your_secret_key

Run backend:

npm start

---

3️⃣ Frontend Setup

cd client
npm install
npm run dev

---

🔗 API Endpoints

🔐 Authentication

• POST /api/auth/register
• POST /api/auth/login

📅 Events

• GET /api/events
• POST /api/events
• GET /api/events/:id

🎟️ Registrations

• POST /api/registrations
• GET /api/registrations/my

---

🎯 System Modules

• User Authentication Module
• Event Management Module
• Event Registration Module
• Dashboard Module
• Contact Module

---

🚀 Deployment

• 🌐 Frontend: Vercel / Render
• ⚙️ Backend: Render
• 🗄️ Database: MongoDB Atlas

---

🌟 Future Enhancements

• 🔔 Real-time Notifications
• 💬 Chat System
• 💳 Payment Integration
• 🤖 AI Event Recommendations
• 📱 Mobile App Version

---

👨‍💻 Author

Bavanetha M.R Frontend Developer | MERN Stack Enthusiast

---

💡 Project Highlights

✔ Real-world problem solving ✔ Clean UI/UX design ✔ Full-stack implementation ✔ Academic integration (OOAD + SPM + ST)

---

📜 License

This project is developed for educational and portfolio purposes.

---

💬 “Connecting people through events, one click at a time.”