HostelFix is a full-stack web application designed to help hostel residents report, track, and resolve maintenance issues in real time.
It streamlines communication between students and administrators, ensuring transparency, accountability, and faster issue resolution.
In most hostels, maintenance issues (like broken lights, leaking taps, or Wi-Fi outages) are reported manually through wardens or registers.
This leads to delays, lack of tracking, and poor communication between students and management.
HostelFix digitizes the entire process — allowing students to raise issues online, track their status, comment, and view updates instantly.
To build an efficient, transparent, and user-friendly hostel maintenance management platform that:
- Simplifies issue reporting for students
- Enables real-time tracking and admin control
- Reduces manual effort and improves response time
- 🧾 Issue Reporting: Students can log issues with title, category, description, and image uploads.
- 🕒 Real-Time Tracking: Each issue has a live status (Pending, In Progress, Resolved).
- 🧑💻 Role-Based Access: JWT + bcrypt-based authentication for secure student and admin dashboards.
- 🗣️ Comments & Discussion: Threaded comments for communication between admin and students.
- 🧮 Issue History: Complete timeline view with updates and resolution logs.
- 🧰 Admin Panel: Manage issues, update status, view analytics, and manage user profiles.
- 📱 Responsive UI: Built using React.js and Tailwind CSS for seamless mobile and desktop experience.
Frontend: React.js, Tailwind CSS
Backend: Node.js, Express.js
Database: MongoDB
Authentication: JWT, bcrypt
Storage: Multer (for image uploads)
Version Control: Git, GitHub
- Frontend (React): Handles user interface, dashboard views, and API requests.
- Backend (Express): Provides REST APIs for issues, users, and authentication.
- Database (MongoDB): Stores users, issue reports, comments, and activity logs.
- Security Layer: JWT tokens secure routes; bcrypt hashes passwords.
- File Handling: Multer middleware manages image uploads securely.
