VIT Men's Hostel Centralized Complaint System

A full-stack web application designed to streamline complaint management within VIT Men's Hostels. Students can easily register and track complaints, while administrators get a powerful dashboard to manage and resolve them efficiently.

---

📸 Project Showcase

Login Page	Student Dashboard	Admin Dashboard

---

✨ Features

• 👤 Dual User Portals: Separate, tailored interfaces for both Students and Administrators.
• 🔒 Secure Authentication: Robust sign-in/sign-up functionality powered by** Firebase Authentication.**
• 📝 Detailed Complaint Forms: Students can submit complaints with category (Wi-fi, AC, Mess, etc.), description, and room number.
• 📊 Admin Management Dashboard: Admins can view all complaints, filter them by category or status, and update their progress (e.g., "Pending", "In Progress", "Resolved").
• ⚡ Real-time Updates: Utilizes Firebase Firestore to ensure data is synced in real-time between the student and admin portals.
• 📱 Responsive Design: A clean and modern UI built with React and Tailwind CSS, fully** responsive for both desktop and mobile devices**.

---

🛠️ Tech Stack

• Frontend: React (Vite), Tailwind CSS
• Backend & Database: Firebase (Authentication, Firestore Realtime Database)
• Deployment: Firebase Hosting
• Version Control: Git & GitHub

---

🚀 Getting Started

Follow these instructions to get a copy of the project up and running on your local machine for development and testing purposes.

1. Clone the Repository

git clone https://github.com/isthatejas/ComplaintSystem_VIT.git
cd ComplaintSystem_VIT

2. Install Dependencies

npm install

3. Setup Environment Variables

This project requires Firebase API keys to connect to your Firebase backend.

Create a file named .env.local in the root of your project directory. Go to your Firebase project's console -> Project Settings -> General tab. Scroll down to "Your apps" and select the web app (</>). Find the firebaseConfig object and copy the values into your .env.local file like this:

# .env.local

VITE_API_KEY="your-api-key"
VITE_AUTH_DOMAIN="your-auth-domain"
VITE_PROJECT_ID="your-project-id"
VITE_STORAGE_BUCKET="your-storage-bucket"
VITE_MESSAGING_SENDER_ID="your-Messaginger-id"
VITE_APP_ID="your-app-id"

4. Run the Development Server

npm run dev

The application should now be running on http://localhost:5173 (or another port if 5173 is in use).