🎓 Campus Connect

🎓 A centralized event management platform designed to streamline campus communication 📢, allowing departments to publish events and students to discover & RSVP in real-time ✅. Built with the MERN stack (MongoDB 🍃, Express, React ⚛️, Node.js) and TypeScript ⚡.

📖 Table of Contents

• About the Project
• Key Features
• Technology Stack
• System Architecture
• Getting Started
  • Prerequisites
  • Installation
  • Environment Variables
• Screenshots
• Contributors
• Acknowledgements

---

💡 About the Project

Campus Connect is a full-stack web application developed to solve the problem of information fragmentation in educational institutions. Traditionally, campus events (placements, cultural fests, workshops) are scattered across multiple WhatsApp groups and emails, leading to missed opportunities.

Campus Connect consolidates all these communications into a single, searchable, and professional platform. It allows department administrators to publish events and students to discover, filter, and RSVP to them in real-time.

---

🚀 Key Features

👤 User Modules

• Student Engagement: Browse events, filter by category/department, RSVP tracking, and personal dashboard.
• Admin Management: Role-based access for 5 Departments (CSE, ECE, etc.), event CRUD operations, and analytics.

📅 Event Management

• Categorization: Tech, Cultural, Sports, Academic, Social, etc.
• Status Control: Draft, Published, and Cancelled states.
• Rich Media: Image upload support for event banners.

🔔 Automation & Notifications

• Email Alerts: Automated emails for new events, RSVP confirmations, and welcome messages.
• Reminders: Scheduled 24-hour event reminders using Cron jobs.

📊 Analytics Dashboard

• Real-time Stats: Track total RSVPs, active events, and engagement trends.
• Department Isolation: Admins only manage events relevant to their specific department.

---

🛠 Technology Stack

Frontend

• React.js - Component-based UI.
• TypeScript - Static typing.
• Tailwind CSS - Responsive styling.
• Vite - Build tool.
• Lucide React - Iconography.

Backend

• Node.js - Runtime environment.
• Express.js - RESTful API framework.
• Nodemailer - Email service integration.
• Node-cron - Task scheduling.

Database

• MongoDB - NoSQL Database.
• Mongoose ODM - Schema modeling.

---

🏗 System Architecture

The application follows a Client-Server architecture:

1. Client: React SPA communicating via REST APIs.
2. Server: Express.js server handling business logic, auth, and DB connections.
3. Database: MongoDB Atlas/Local for persistent storage.

---

⚡ Getting Started

Follow these steps to set up the project locally.

Prerequisites

• Node.js (v16.0 or higher)
• MongoDB (Local or Atlas URL)
• Git

Installation

1. Clone the repository

   git clone [https://github.comrevanthvijaychandra-creator/campus-connect.git](https://github.com/yourusername/campus-connect.git)
   cd campus-connect

2. Install Backend Dependencies

   cd backend
   npm install

3. Install Frontend Dependencies

   cd ../frontend
   npm install