Skip to content

Sooraj-krishna/Nearby_hostels

Repository files navigation

Hostel Management System

Hostel Management System is a modern web application designed to streamline the management of hostels, categories, comments, and user moderation for educational institutions or organizations. This platform provides robust admin tools, user access control, and a clean, accessible UI for efficient hostel administration.


🚀 Features

  • 🏠 Hostel Management – Add, edit, and manage hostel details including name, address, and price.
  • 🖼️ Image Management & Slider – Upload multiple hostel images, displayed in a Swiper slider. Click any image to view it fullscreen in a high-quality modal/lightbox (powered by Cloudinary).
  • 🗂️ Category Management – Create and organize hostel categories for better filtering and search.
  • 📝 Comment Moderation – Admins can view, edit, report, and block user comments for a safe environment.
  • 🚫 User Blocking & Reporting – Block users or report inappropriate comments, with in-app notifications.
  • 🔒 Access Control – Secure admin and superadmin roles with persistent authentication.
  • 💡 Modern UI – Single-card-per-row layout, responsive Swiper image slider, and accessible fullscreen image viewing.

🖼️ Image Storage & Display (Cloudinary)

  • Hostel images are uploaded to and served from Cloudinary, with high-quality transformations (q_auto:best).
  • All images are shown in a Swiper slider; click any image to view it fullscreen in a modal/lightbox.
  • You can customize Cloudinary transformations (quality, size, cropping) by editing the image URL or backend logic.

🛠️ Tech Stack

  • Frontend: Next.js, React, TypeScript, Tailwind CSS, Shadcn UI
  • Backend: Next.js API Routes, Firebase Firestore
  • Image Storage: Cloudinary (no Firebase Storage)
  • Authentication: Firebase Auth

👨‍💻 Author

This project was designed and developed solely by Sooraj Krishna K P.


🏫 Want to Use This for Your Own Hostel or Institution?

Absolutely! You can easily reuse and customize this project for your own hostel or organization:

  1. Fork this repository
  2. Clone your fork locally
  3. Update Branding
  4. Edit Hostel Data
  5. Deploy

📜 How to Contribute

  1. Fork the repository.
  2. Clone it: git clone https://github.com/Sooraj-krishna/Nearby_hostels.git
  3. Create a new branch: git checkout -b feature-name
  4. Make your changes and commit: git commit -m 'Your Message'
  5. Push changes: git push origin feature-name
  6. Open a Pull Request.

📩 Contact

For any queries, feel free to reach out:


Empowering hostel management with modern web technology!

About

An website for finding hostels in your collage area.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •  

Languages