-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
c5a4877
commit c9060f8
Showing
1 changed file
with
132 additions
and
4 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,8 +1,42 @@ | ||
# HiveHaven | ||
|
||
## Description | ||
Welcome to HiveHaven, your trusted platform for connecting international students with reliable accommodations across the US. | ||
|
||
This is a web application that allows students to find accommodations near their universities. It also allows landlords to post their accommodation for students to find. | ||
- [HiveHaven](#hivehaven) | ||
- [Introduction](#introduction) | ||
- [Features (Planned)](#features-planned) | ||
- [Technologies Used](#technologies-used) | ||
- [Getting Started](#getting-started) | ||
- [Prerequisites](#prerequisites) | ||
- [Installation](#installation) | ||
- [Usage](#usage) | ||
- [Project Structure](#project-structure) | ||
- [Contributing](#contributing) | ||
- [License](#license) | ||
- [Contact](#contact) | ||
|
||
## Introduction | ||
|
||
HiveHaven is a platform that connects international students with reliable accommodations across the US. The platform is designed to help students find the best accommodation that suits their needs and preferences. ~~The platform uses machine learning to recommend the best accommodation based on the student's preferences and budget~~. The platform also provides a platform for students to connect with other students and landlords to find the best accommodation. | ||
|
||
## Features (Planned) | ||
|
||
- **Accommodation Search**: Students can search for accommodations based on their preferences and budget. | ||
- **Accommodation Recommendation**: The platform uses machine learning to recommend the best accommodation based on the student's preferences and budget. | ||
- **Accommodation Listing**: Landlords can list their accommodations on the platform. | ||
- **Student Connection**: Students can connect with other students to find the best accommodation. | ||
- **Landlord Connection**: Landlords can connect with students to find the best accommodation. | ||
- **Chat**: Students and landlords can chat with each other to discuss the accommodation. | ||
- **Notifications**: Students and landlords receive notifications for new messages and accommodation recommendations. | ||
- **Reviews**: Students and landlords can leave reviews for each other. | ||
- **Ratings**: Students and landlords can rate each other. | ||
- **Payments**: Students can make payments for accommodations through the platform. | ||
- **Booking**: Students can book accommodations through the platform. | ||
- **Profile**: Students and landlords can create profiles on the platform. | ||
- **Verification**: Students and landlords can verify their profiles. | ||
- **Support**: Students and landlords can contact support for any issues. | ||
- **Feedback**: Students and landlords can provide feedback on the platform. | ||
- **Privacy**: The platform ensures the privacy of students and landlords. | ||
|
||
## Technologies Used | ||
|
||
|
@@ -15,6 +49,100 @@ This is a web application that allows students to find accommodations near their | |
- Tensorflow | ||
- Figma | ||
|
||
## Access the application | ||
## Getting Started | ||
|
||
To get started with the project, follow the instructions below. | ||
|
||
### Prerequisites | ||
|
||
Before you begin, ensure you have the following installed: | ||
|
||
- Node.js (v14 or later) | ||
- npm (v6 or later) or yarn (v1.22 or later) | ||
|
||
### Installation | ||
|
||
1. Clone the repository: | ||
|
||
```bash | ||
git clone https://github.com/pathak-ashutosh/students-accomodation.git | ||
cd students-accomodation | ||
``` | ||
|
||
2. Install the dependencies: | ||
|
||
```bash | ||
npm install | ||
``` | ||
|
||
3. Create a `.env` file in the root directory and add the following environment variables: | ||
|
||
```env | ||
REACT_APP_API_URL=http://localhost:5000 | ||
``` | ||
|
||
## Usage | ||
|
||
To use the application, follow the instructions below. | ||
|
||
1. Start the server: | ||
|
||
```bash | ||
npm start | ||
``` | ||
|
||
2. Open the browser and go to `http://localhost:3000`. | ||
|
||
## Project Structure | ||
|
||
The project structure is as follows: | ||
|
||
``` | ||
students-accomodation/ | ||
├── backend/ | ||
│ ├── config/ | ||
│ ├── controllers/ | ||
│ ├── models/ | ||
│ ├── routes/ | ||
│ ├── app.js | ||
│ ├── server.js | ||
│ ├── .env | ||
│ ├── package.json | ||
├── frontend/ | ||
│ ├── public/ | ||
| | ├── index.html | ||
| | ├── ... | ||
│ ├── src/ | ||
│ │ ├── assets/ | ||
│ │ ├── components/ | ||
│ │ ├── pages/ | ||
│ │ ├── sections/ | ||
│ │ ├── App.jsx | ||
│ │ ├── index.js | ||
│ │ ├── ... | ||
│ ├── .env | ||
│ ├── package.json | ||
├── .gitignore | ||
├── LICENSE | ||
├── README.md | ||
``` | ||
|
||
## Contributing | ||
|
||
Contributions are welcome! To contribute to the project, follow the steps below: | ||
|
||
1. Fork the repository. | ||
2. Create a new branch (`git checkout -b feature/your-feature`). | ||
3. Make the necessary changes and commit them (`git commit -am 'Add new feature'`). | ||
4. Push the changes to the branch (`git push origin feature/your-feature`). | ||
5. Create a new pull request. | ||
6. Get the pull request reviewed and approved. | ||
7. Repeat the process for other features. | ||
|
||
## License | ||
|
||
This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for more information. | ||
|
||
## Contact | ||
|
||
The application is hosted on Vercel. You can access it through the given URL on the right below the repo description. | ||
If you have any questions, feel free to reach out to me at [X](https://www.x.com/4shutoshpathak) or email me at [[email protected]](mailto:[email protected]) |