An open API service indexing awesome lists of open source software.

https://github.com/belmeetmule/homely

Homely is a booking application that enable users to view list of houses, add and remove houses, book a visit and see bookings. Homely is designed in such a way that the front-end is decoupled from the back-end to make it scalable and maintainable. Built using Ruby on Rails back-end and React front-end.
https://github.com/belmeetmule/homely

booking-system full-stack-application javascript react-bootstrap react-frontend redux ror-api

Last synced: about 2 months ago
JSON representation

Homely is a booking application that enable users to view list of houses, add and remove houses, book a visit and see bookings. Homely is designed in such a way that the front-end is decoupled from the back-end to make it scalable and maintainable. Built using Ruby on Rails back-end and React front-end.

Awesome Lists containing this project

README

        

![](https://img.shields.io/badge/Microverse-blueviolet)

# 📗 Table of Contents
- [📗 Table of Contents](#-table-of-contents)
- [📖 Hello React Frontend ](#-hello-react-frontend-)
- [Kanban Board](#kanban-board)
- [Screenshot of of the initial state of the Kanban board](#screenshot-of-of-the-initial-state-of-the-kanban-board)
- [🛠 Built With ](#-built-with-)
- [Tech Stack ](#tech-stack-)
- [Key Features ](#key-features-)
- [🚀 Live Demo ](#-live-demo-)
- [💻 Getting Started ](#-getting-started-)
- [Prerequisites](#prerequisites)
- [Setup](#setup)
- [Install](#install)
- [Usage ](#usage-)
- [Run tests](#run-tests)
- [Deployment](#deployment)
- [👥 Author ](#-author-)
- [🔭 Future Features ](#-future-features-)
- [🤝 Contributing ](#-contributing-)
- [⭐️ Show your support ](#️-show-your-support-)
- [🙏 Acknowledgments ](#-acknowledgments-)
- [📝 License ](#-license-)

# 📖 Hello React Frontend
![](./src/images/project-mock.png)

**Homely-frontend** is an implemention of a connection between Ruby on Rails back-end and React front-end. [Homely-backend](https://github.com/belmeetmule/homely-backend) handles the backend API, and [Hello React Frontend](https://github.com/Wahaj-Ali/homely-frontend) handles the frontend UI to display a random greeting message.

## Kanban Board

We are a team of 4 members.

- [Wahaj Ali](https://github.com/Wahaj-Ali)
- [Mulugeta Belete](https://github.com/belmeetmule)
- [Oshie](https://github.com/akhror-valiev)
- [Chukwuma Paul Mosanya](https://github.com/blase147)

[Kanban Board](https://github.com/belmeetmule/homely-backend/projects/1)

### Screenshot of of the initial state of the Kanban board

![236180746-4812d9c4-2204-47ea-9a9c-10adf7b3c6a6](https://github.com/Wahaj-Ali/homely-frontend/assets/111431787/abb081aa-114c-49fa-84e7-66e35cccd7ce)

![236180950-a9b6aa9d-3973-4424-9cc1-f9f9f00f0917](https://github.com/Wahaj-Ali/homely-frontend/assets/111431787/94bb4fe9-f4e0-41f6-bda8-46e35cebfc16)

## 🛠 Built With

### Tech Stack

Client

Server

### Key Features

- Booking a house reseravtion.
- Add a new house.
- Delete a house.
- My reservations page only for the logged-in users.
- Responsive Design.
- State Management using Redux toolkit.
- Use latest ES6 modules.
- Design inspired by a Behance App design.
- Axios for making HTTP requests from the server.
- Use Swiperjs library to create the slider for the main-page.

(back to top)

## 🚀 Live Demo

- [Homely](https://homelyheaven.netlify.app/)

(back to top)

## 💻 Getting Started

To get a local copy up and running, follow these steps.
### Prerequisites

In order to run this project you need:

- [API](https://github.com/belmeetmule/homely-backend)
- [git](https://git-scm.com/)
- [node.js](https://nodejs.org/en/)
- [JavaScript](https://developer.mozilla.org/en-US/docs/Web/JavaScript)

### Setup

Clone this repository to your desired folder:

```
git clone [email protected]:Wahaj-Ali/homely-frontend.git
cd homely-frontend
```

### Install

Install thr project dependencies with:

```
npm install
```

### Usage

To run the project, execute the following command:

```
npm start
```

### Run tests

To run the test, execute the following command:

```
npm test
```

### Deployment

You can deploy this project using:

```
npm run deploy
```

(back to top)

## 👥 Author

👤 **Chukwuma Paul Mosanya**

- [GitHub](https://github.com/blase147)
- [Twitter](https://twitter.com/ChukwumaMosanya)
- [LinkedIn](https://www.linkedin.com/in/chukwuma-mosanya)

👤 **Wahaj Ali**

- [GitHub](https://github.com/Wahaj-Ali)
- [Twitter](https://twitter.com/Ali96Wahaj)
- [LinkedIn](https://www.linkedin.com/in/wahaj-ali96)

👤 **Mulugeta Belete**

- [GitHub](https://github.com/belmeetmule)
- [Twitter](https://twitter.com/belmeetmule)
- [LinkedIn](https://www.linkedin.com/in/mulugeta-belete/)

👤 **Akhror Valiev**

- [GitHub](https://github.com/akhror-valiev)
- [Twitter](https://twitter.com/oshie0115)
- [LinkedIn](https://www.linkedin.com/in/oshie0115/)

(back to top)

## 🔭 Future Features

- Add more details about the houses.
- Add a search bar to search for houses.
- Update the style for a modern design.

(back to top)

## 🤝 Contributing

Contributions, issues, and feature requests are welcome!

Feel free to check the [issues page](https://github.com/Wahaj-Ali/homely-frontend/issues).

(back to top)

## ⭐️ Show your support

If you like this project and want to support me make cooler projects Give this project a Star.

(back to top)

## 🙏 Acknowledgments

Thank you to [Murat Korkmaz](https://www.behance.net/muratk) for the design ideas provided.

(back to top)

## 📝 License

This project is [MIT](./LICENSE) licensed.

(back to top)