https://github.com/binary-shade/full-stack-hotel-booking
A complete hotel booking system built with the MERN stack (MongoDB, Express, React, Node.js). This project allows users to browse hotels, view room details, check availability, and make bookings with a smooth user experience. Key features include secure authentication, real-time booking updates, and a responsive UI optimized
https://github.com/binary-shade/full-stack-hotel-booking
full-stack hotel-booking mern-stack nodejs react reactjs
Last synced: about 2 months ago
JSON representation
A complete hotel booking system built with the MERN stack (MongoDB, Express, React, Node.js). This project allows users to browse hotels, view room details, check availability, and make bookings with a smooth user experience. Key features include secure authentication, real-time booking updates, and a responsive UI optimized
- Host: GitHub
- URL: https://github.com/binary-shade/full-stack-hotel-booking
- Owner: Binary-Shade
- License: mit
- Created: 2024-07-19T17:40:50.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2024-11-01T05:16:50.000Z (7 months ago)
- Last Synced: 2025-02-04T17:52:20.063Z (4 months ago)
- Topics: full-stack, hotel-booking, mern-stack, nodejs, react, reactjs
- Language: JavaScript
- Homepage:
- Size: 5.21 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Full-Stack Hotel Booking System
This project is a full-stack hotel booking application built using the MERN stack (MongoDB, Express, React, Node.js). The system allows users to browse hotels, view room details, check availability, and make bookings with secure authentication. It includes both the frontend and backend components and is designed to provide a responsive, smooth user experience.
## Features
- **User Authentication**: Secure login and registration with encrypted passwords.
- **Browse Hotels**: Users can search for hotels, filter by location, price, and more.
- **Booking System**: Book rooms with real-time availability checks.
- **User Dashboard**: View and manage bookings.
- **Admin Dashboard**: Manage hotel data, rooms, and bookings.
- **Responsive UI**: Optimized for both desktop and mobile devices.
## Technologies Used
- **Frontend**: React, CSS, Bootstrap (or other CSS frameworks as needed)
- **Backend**: Node.js, Express
- **Database**: MongoDB
- **Authentication**: JWT (JSON Web Tokens) for secure user sessions
- **Deployment**: Hosted on services like Heroku (backend) and Netlify/Vercel (frontend)
## Getting Started
Follow these steps to set up the project locally:
### Prerequisites
- [Node.js](https://nodejs.org/) installed
- [MongoDB](https://www.mongodb.com/) installed or a MongoDB Atlas account
### Installation
1. **Clone the repository:**
```bash
git clone https://github.com/Binary-Shade/Full-stack-hotel-booking.git
cd Full-stack-hotel-booking
```
2. **Install dependencies for both frontend and backend:**
- For the backend:
```bash
cd backend
npm install
```
- For the frontend:
```bash
cd ../frontend
npm install
```
3. **Environment Variables**:
Create a `.env` file in the `backend` directory with the following:
```plaintext
MONGO_URI=your-mongodb-connection-string
JWT_SECRET=your-jwt-secret
```
### Running the Project
1. **Backend**:
In the `backend` directory, run:
```bash
npm start
```
2. **Frontend**:
In the `frontend` directory, run:
```bash
npm start
```
3. **Access the application**:
- Frontend: `http://localhost:3000`
- Backend (API): `http://localhost:5000`
## Project Structure
```
hotel-booking-system/
├── backend/
│ ├── controllers/
│ ├── models/
│ ├── routes/
│ ├── utils/
│ └── server.js
├── frontend/
│ ├── public/
│ ├── src/
│ ├── components/
│ ├── pages/
│ ├── App.js
│ └── index.js
└── README.md
```
- **Backend**: Contains the server code, routes, models, and controllers for the API.
- **Frontend**: React code, organized into components and pages for a smooth user experience.
## API Endpoints
- **User Authentication**: `/api/auth/`
- **Hotel Management**: `/api/hotels/`
- **Room Management**: `/api/rooms/`
- **Booking**: `/api/bookings/`
## Future Enhancements
- Implement additional payment gateway integration.
- Add user review and rating system for hotels.
- Enhanced search filters for improved user experience.
## Contributing
Contributions are welcome! Feel free to open issues or submit pull requests for new features, bug fixes, or improvements.
## License
This project is licensed under the MIT License.
---
Feel free to customize further according to your project specifics!