https://github.com/salman679/hostel-pro
Your ultimate Hostel Management System for universities! Built with the robust MERN stack, Hostel Pro streamlines hostel administration by managing meals, reviews, and memberships while creating a delightful experience for students. 🎓✨
https://github.com/salman679/hostel-pro
expressjs mongodb react tailwindcss transtackquary
Last synced: about 2 months ago
JSON representation
Your ultimate Hostel Management System for universities! Built with the robust MERN stack, Hostel Pro streamlines hostel administration by managing meals, reviews, and memberships while creating a delightful experience for students. 🎓✨
- Host: GitHub
- URL: https://github.com/salman679/hostel-pro
- Owner: salman679
- Created: 2025-01-14T14:35:42.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-02-25T03:33:47.000Z (over 1 year ago)
- Last Synced: 2025-02-25T04:28:31.849Z (over 1 year ago)
- Topics: expressjs, mongodb, react, tailwindcss, transtackquary
- Language: JavaScript
- Homepage: https://hostelpro-ed1bf.web.app
- Size: 637 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Hostel Pro 🏨🍴
Your ultimate **Hostel Management System** for universities! Built with the robust **MERN stack**, Hostel Pro streamlines hostel administration by managing meals, reviews, and memberships while creating a delightful experience for students. 🎓✨
---
## 🌟 Highlights at a Glance
1. **Fully Responsive** 📱💻: Optimized for any device.
2. **Seamless Login** 🔒: Persistent login for uninterrupted access.
3. **Meal Management** 🍔🥗: Efficiently add, edit, or remove meal details.
4. **Interactive Reviews** ⭐: Students can share and manage meal feedback.
5. **Premium Memberships** 💳: Unlock perks with Silver, Gold, or Platinum plans.
6. **Upcoming Meals** 🗓️: View and like future meal plans.
7. **Secure Payments** 💵: Integrated **Stripe** for hassle-free transactions.
8. **Admin Dashboard** 🛠️: Power-packed features to manage users, meals, and reviews.
---
## 🚀 Technologies Behind Hostel Pro
- **Frontend**: React.js + Tailwind CSS
- **Backend**: Node.js, Express.js
- **Database**: MongoDB
- **State Management**: Context API
- **Data Fetching**: TanStack Query
---
## 📑 Key Pages & Features
### 🏠 Home Page
- Dynamic **Navbar** based on login status.
- Engaging **Banner** with search functionality.
- Meal categories: **Breakfast, Lunch, Dinner, All Meals**.
- Attractive **Membership Packages** with Silver, Gold, and Platinum options.
- Informative **Footer** with useful links.
### 🍽️ Meal Detail Page
- Meal info with an **image, ingredients, and distributor details**.
- Like and request buttons (**login required**).
- Review section for student feedback.
### 🔍 Meals Page
- Advanced **search and filter options** for categories and price range.
- **Infinite scrolling** for meal cards.
### 🗓️ Upcoming Meals
- Preview future meal plans.
- Like functionality exclusive to premium members.
### 💳 Checkout Page
- Secure package purchases powered by **Stripe**.
- Instant **confirmation via modals/toasts** after payment.
### ✍️ Join Us Page
- **Login and registration forms** with social login support.
- Powered by **react-hook-form** for smooth form handling.
### 🛡️ User Dashboard
- User **profile** with badges and achievements.
- Manage requested meals, reviews, and **payment history**.
### 🛠️ Admin Dashboard
- Comprehensive admin tools:
- **User Management**: Search, view, and assign admin roles.
- **Meal Management**: Add, update, delete, and sort meals.
- **Review Management**: Moderate and delete reviews.
- **Upcoming Meals**: Plan and publish meal schedules.
---
## 🎉 Additional Features
- Sleek **alerts and toasts** for user-friendly operations.
- Secure environment variables for **Firebase and MongoDB credentials**.
- **JWT-based authentication** with Axios interceptors.
- Efficient pagination in admin dashboard tables.
---
## 📂 Repository
- **Frontend Code**: [Hostel Pro Frontend](https://github.com/salman679/Hostel-Pro.git)
- **Backend Code**: [Hostel Pro Backend](https://github.com/salman679/Hostel-Pro-server.git)
---
## 🌐 Live Demo
Explore the live application here: [Hostel Pro Live](https://hostelpro-ed1bf.web.app/)
---
## 👨💻 Admin Credentials
Use these credentials to explore the admin features:
- **Email**: admin@hostelpro.com
- **Password**: admin123
---
Thank you for choosing Hostel Pro! We're here to make hostel management effortless and enjoyable. 😊🎉