Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
pathak-ashutosh committed May 20, 2024
1 parent c5a4877 commit c9060f8
Showing 1 changed file with 132 additions and 4 deletions.
136 changes: 132 additions & 4 deletions README.md
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

Expand All @@ -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])

0 comments on commit c9060f8

Please sign in to comment.