Skip to content

HostelHub centralizes mess ratings by letting students anonymously submit feedback and upload images of food quality. It also features a streamlined lost‑and‑found portal for efficient reporting and recovery of misplaced items.

Notifications You must be signed in to change notification settings

komal2203/hostelhub

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

35 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🏡 HostelHub

HostelHub is a modern web application designed to enhance hostel life for students. It provides a seamless platform for sharing mess ratings, managing lost & found items, and building a supportive hostel community.


🚀 Features

1. Mess Rating System

  • Rate Your Mess: Students can rate their hostel mess experience, leave comments, and upload images.
  • View Ratings: See ratings and reviews from other students to make informed choices about meals.
  • Anonymous Feedback: Option to submit ratings anonymously for honest feedback.
  • Visual Analytics: Pie and trend charts to visualize mess ratings over time.

2. Lost & Found

  • Report Lost Items: Easily report lost belongings with details and images.
  • Browse Found Items: View items found by others and connect with the finder.
  • Mark as Found: Update the status when an item is recovered.
  • Search & Filter: Quickly search and filter items by keywords or status.

3. Authentication & User Management

  • Secure Login/Register: JWT-based authentication for secure access.
  • Session Management: Stay logged in across sessions with token storage.
  • Protected Actions: Only authenticated users can submit ratings or lost & found reports.

4. Responsive & Modern UI

  • Mobile-Friendly: Fully responsive design for use on any device.
  • Attractive Animations: Smooth transitions and engaging visuals using Framer Motion.
  • Dark Mode Support: Toggle between light and dark themes for comfortable viewing.

🛠️ Tech Stack

  • Frontend: React, Vite, Tailwind CSS, Framer Motion, Lucide Icons, Recharts
  • Backend: Node.js, Express.js, Multer (for image uploads), JWT
  • Database: MongoDB
  • Deployment: Render.com

Live Demo

Explore the live site here:
👉 Live Link


🤝 Contributing

Contributions are welcome!
Please open an issue or submit a pull request to contribute.


📄 License

This project is licensed under the MIT License.

About

HostelHub centralizes mess ratings by letting students anonymously submit feedback and upload images of food quality. It also features a streamlined lost‑and‑found portal for efficient reporting and recovery of misplaced items.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages