BookMyHomestay

Welcome to BookMyHomestay, a dynamic web application designed to help users find their ideal homestay. This application simplifies the process of searching and booking homestays by offering personalized recommendations based on user preferences and data stored locally. Our system focuses on enhancing user experience by maintaining a robust login system, an admin dashboard for site management, and effective use of local and session storage to handle temporary data securely.

Features

• Homestay Recommendations: Automatically recommends homestays based on user preferences and data.
• User Authentication: Secure login system to manage user sessions and data.
• Admin Dashboard: Allows site administrators to manage users and homestay listings.
• Data Storage: Utilizes JSON files to store user and homestay data locally for rapid access and manipulation.
• Security: Implements encryption for session data to enhance privacy and security.
• User Favorites: Users can manage their favorite homestays and view them at any time.

Technologies

• React.js: A JavaScript library for building user interfaces.
• React Router: For handling in-app routing.
• Local Storage and Session Storage: For managing temporary data and sessions state.
• Crypto-JS: To secure user data using encryption.
• Bootstrap: For styling and responsive design.

Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes.

Prerequisites

Before you begin, ensure you have the following software installed on your computer:

• Node.js
  • Check Node installation: node --version
• npm
  • Check npm installation: npm --version

Installation

1. Clone the repo:

   git clone https://github.com/Poyuchao/BookMyHomestay.git
   

2. Install NPM packages:

   npm install
   

3. Run the application

   npm start
   
   

Usage

Normal users

• Navigate to the homepage to view recommended homestays.
• Use the login feature to access personalized features such as favorites.
• testing account:
  • username: abc@yahoo.com
  • password: test12

Admin users

Admin users

• Access the admin dashboard to manage users and homestay listings.
• testing account:
  • username: george@gmail.com
  • password: 7777

Contact

• PoYu Chao - killyen444@gmail.com
• Project Link: https://poyuchao.github.io/BookMyHomestay/