بِسْمِ ٱللّٰهِ ٱلرَّحْمَٰنِ ٱلرَّحِيمِ

The Ultimate Full-Stack Solution for Modern Hospitality Management

🔴 Live Demo · Report Bug · Request Feature

---

📍 About The Project

SkarduStay is a comprehensive Hotel Management System designed to bridge the gap between hospitality providers and guests. Built as a complete Full-Stack Application, it features a robust backend API connected to a dynamic frontend interface.

The system is engineered with a Dual-Dashboard Architecture:

1. User Dashboard: Allows guests to browse rooms, check availability, and make seamless reservations.
2. Admin Dashboard: Empowers management to oversee bookings, manage room inventory, and analyze revenue streams in real-time.

🌟 Key Features

Feature	Description
👑 Admin Control	Full CRUD capabilities for Rooms, Users, and Bookings.
📅 Smart Booking	Real-time availability checking and conflict-free reservation logic.
👤 User Portal	Personalized profile for guests to view history and manage stays.
🔐 Secure Auth	JWT-based authentication with protected routes for Admins.
🔍 Search & Filter	Advanced filtering by price, room type, and amenities.

---

🛠️ Technical Architecture

This project is built using the MERN Stack for maximum scalability and performance:

---

🚀 Getting Started

Follow these steps to set up the Backend and Frontend locally.

Prerequisites

• Node.js (v18+)
• MongoDB (Local or Atlas URL)
• npm or yarn

Installation

1. Clone the repository

   git clone [https://github.com/wajahat-ali-mir-dev/skardustay.git](https://github.com/wajahat-ali-mir-dev/skardustay.git)
   cd skardustay

2. Setup Backend

   cd backend
   npm install
   # Create a .env file and add your MONGO_URI and JWT_SECRET
   npm start

3. Setup Frontend

   cd ../frontend
   npm install
   npm start

---

🗺️ Roadmap

• Authentication System (Login/Register)
• Room Management (Admin)
• Room Booking Flow (User)
• Integration of Payment Gateways (Stripe/PayPal)
• Email Notifications for Booking Confirmation
• Review and Rating System for Rooms

See the open issues for a full list of proposed features.

---

🤝 Contributing

Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

---

👨‍💻 About the Author

Wajahat Ali Mir

Full Stack Engineer | React & Node.js Specialist | Mobile App Developer

Wajahat Ali Mir is a seasoned software engineer specializing in Full Stack Web Development and Mobile Architectures. With a passion for building scalable, high-performance applications, Wajahat combines technical expertise with a deep understanding of System Design and User Experience to deliver world-class digital products like SkarduStay.

"Building the future, one line of code at a time."

---

🌐 Connect with Me

LinkTree • Link.me • About.me • BlogSpot • SoundCloud • Sketchfab • Crunchbase

(back to top)