Universal Hostel Management System

Universal Hostel Management System is a comprehensive solution designed to streamline hostel management operations. With the rapid increase in educational institutions and hostel facilities, this system aims to reduce the administrative burden on hostel management while enhancing the experience for residents.

🌐 Project Links

• Live Demo: Universal Hostel Management System
• Client-Side Repository: GitHub Client Repo
• Server-Side Repository: GitHub Server Repo

🎥 Project Presentation

• 🎥 Project Video: Watch Project Presentation

📋 Key Features

User Roles and Capabilities

General User (Resident)

• Sign up and login to the system
• Modify personal profile
• Select and manage rooms
• Choose meal plans
• Pay hostel dues
• Receive notifications from hostel managers

Admin Capabilities

• Perform all manager-level actions
• Assign or remove manager roles
• Full system administration access

📖 Purpose

The system addresses the challenges of manual hostel management by:

• Simplifying administrative processes
• Providing a user-friendly interface for residents
• Enabling efficient communication between residents and management
• Streamlining room and meal allocation
• Managing financial transactions and notifications

🛠️ Technologies Used

• Frontend:
  • Next.js
  • Tailwind CSS
• Backend:
  • Node.js
  • Express.js
• Database:
  • MongoDB
• Deployment:
  • Vercel

🚀 Installation & Setup

Clone the Repositories

# Clone client-side repository
git clone https://github.com/shihab-2021/Universal-Hostel-Management-System.git

# Clone server-side repository
git clone https://github.com/shihab-2021/Universal-Hostel-Server-Side-Code.git

Frontend Setup

# Navigate to the client directory
cd Universal-Hostel-Management-System

# Install dependencies
npm install

# Create a .env.local file and add necessary environment variables
# Example:
# NEXT_PUBLIC_API_URL=http://localhost:5000

# Run the development server
npm run dev

Backend Setup

# Navigate to the server directory
cd Universal-Hostel-Server-Side-Code

# Install dependencies
npm install

# Create a .env file and add necessary environment variables
# Example:
# MONGODB_URI=mongodb://localhost:27017/hostel_management
# PORT=5000
# JWT_SECRET=your_jwt_secret

# Run the server
npm start

---

Thank you for checking out the Universal Hostel Management System project! If you find it helpful, consider giving it a ⭐ on GitHub.