Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/omgupta12/roombooking_application
https://github.com/omgupta12/roombooking_application
calender context-api expressjs mongodb mongodb-atlas mongoose nodejs react-router reactjs tailwindcss
Last synced: 10 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/omgupta12/roombooking_application
- Owner: Omgupta12
- Created: 2025-01-30T17:52:21.000Z (12 days ago)
- Default Branch: main
- Last Pushed: 2025-01-30T18:07:40.000Z (12 days ago)
- Last Synced: 2025-01-30T19:23:40.957Z (12 days ago)
- Topics: calender, context-api, expressjs, mongodb, mongodb-atlas, mongoose, nodejs, react-router, reactjs, tailwindcss
- Language: JavaScript
- Homepage: https://room-booking-application-by-om.vercel.app/
- Size: 122 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Room Booking Management System
A full-stack Room Booking Management System built with React (frontend) and Node.js with Express (backend). Users can register, log in, search for available rooms, book rooms, and manage their bookings. Key features include user authentication via JWT, room search by date/type, booking creation, view booking history, and booking cancellation. Built with MongoDB, Mongoose, and Axios for HTTP requests.
## Features
- User authentication (sign-up, login)
- Room listing with search and filter functionality
- Room details page with booking form
- Calendar for selecting booking dates
- Booking history for users
- API endpoints for room booking management
- Secure booking logic with real-time availability checks
- Overlapping booking prevention
## Tech Stack
### Frontend:
- React.js (Vite)
- React Router
- Axios (for API requests)
- Tailwind CSS (for styling)
### Backend:
- Node.js
- Express.js
- MongoDB (Database)
- JWT Authentication
- dotenv (for environment variables)
- Mongoose (ORM)
## Installation & Setup
### Prerequisites
Ensure you have the following installed:
- [Node.js](https://nodejs.org/en/download/)
- [MongoDB](https://www.mongodb.com/try/download/community)
### Clone the Repository
```sh
git clone https://github.com/Omgupta12/RoomBooking_Application.git
cd RoomBooking_Application
```
### Backend Setup
- Navigate to the backend directory: cd backend
- Install dependencies: npm install
- Create a .env file in the backend directory and add the following:
- PORT=5000
- DATABASE_URL=mongodb://localhost:27017/roombooking
- JWT_SECRET=your_secret_key
- Start the backend server: npm start
### Frontend Setup
- Navigate to the frontend directory: cd frontend
- Install dependencies: npm install
- Start the frontend application: npm run dev
### Running the Application
- The backend will be running at http://localhost:5000 or http://localhost:8000
- The frontend will be running at http://localhost:5173
### API Endpoints
| Function Name | HTTP Method | Endpoint | Description |
|------------------------|-------------|----------------------------------------|--------------------------------------|
| registerUser | POST | /api/auth/register | User registration |
| loginUser | POST | /api/auth/login | User login |
| fetchRooms | GET | /api/rooms | Fetch available rooms |
| fetchRoomDetails | GET | /api/rooms/:roomId | Fetch details of a specific room |
| createBooking | POST | /api/bookings | Create a booking |
| cancelBooking | DELETE | /api/bookings/:bookingId | Cancel a booking |
| fetchAvailableSlots | GET | /api/bookings/available-slots/:roomId/:date | Fetch available slots for a room|
# App Screenshots
## Screenshot 1: Room Listing Page
Here user see list of rooms :
## Screenshot 2: User Registration
Here is what the user registration screen looks like:
)
## Screenshot 3: User Login
Here is what the user login screen looks like:
)
## Screenshot 3: Room Booking
Here is the room booking screen:
## Screenshot 4: Booking History
The booking history page displays the user's previous bookings:
