Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/aminebajjidev/rented-in-app
A property rental platform built with the MERN stack.
https://github.com/aminebajjidev/rented-in-app
learning-by-doing mern-stack react-router reactjs redux
Last synced: 10 days ago
JSON representation
A property rental platform built with the MERN stack.
- Host: GitHub
- URL: https://github.com/aminebajjidev/rented-in-app
- Owner: AminebajjiDEV
- License: mit
- Created: 2024-05-28T22:08:03.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2024-11-03T20:14:10.000Z (17 days ago)
- Last Synced: 2024-11-03T21:18:22.000Z (17 days ago)
- Topics: learning-by-doing, mern-stack, react-router, reactjs, redux
- Language: JavaScript
- Homepage:
- Size: 98 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Rented-In App
Welcome to the Rented-In App, a property rental platform built with the MERN stack. This project aims to provide users with functionalities similar to Airbnb, enabling them to list, browse, and book properties seamlessly.
## Table of Contents
- Features
- Technologies Used
- Getting Started
- Usage
- Folder Structure
- Contributing
- License
## Features
- User Authentication: Secure login and registration with JWT.
- Property Listings: Create, view, and manage property listings.
- Bookings: Book properties and manage reservations.
- Wishlist: Add properties to the wishlist.
- User Management: Manage user profiles and data.
- Responsive Design: Fully responsive UI using SCSS and MUI.
## Tech Stack
**Client:** ReactJS, Redux, SCSS, HTML, @mui/material, react-slick, react-date-range, react-router-dom.
**Server:** Node.js, Express.js, MongoDB, Mongoose, bcrypt, JWT, multer, multer-gridfs-storage, dotenv.
**Development Tools:** VSCode, Git, Firefox Developer Tools, Redux DevTools, Webpack, cors. "Basic tools"
## Getting Started
To get a local copy up and running, follow these steps:
## Prerequisites
- Node.js
- npm
- nodemon "efficient for server side use"
## Installation
Clone the repo
```bash
git clone https://github.com/AminebajjiDEV/Rented-In-APP.git
```
Install NPM packages for both client and server
```bash
cd Rented-In-APP
cd client
npm install
cd ../server
npm install
```
## Run Locally
Go to the project directory
```bash
cd Rented-In-APP
```
Start the backend server
```bash
cd server
npm start
```
Start the frontend development server
```bash
cd ../client
npm start
```
Open your browser and navigate to http://localhost:3000
## Usage
- Homepage: Browse categories and view listings.
- Search: Use the search bar to find properties.
- Authentication: Register or log in to access more features.
- Property Management: List new properties, manage existing listings.
- Bookings: Book properties and view/manage your reservations.
- Wishlist: Add and view properties in your wishlist.
- User Profile: Update your profile and manage your account.
## Screenshots
- Home Page
- Property Details page
- Create Listings Page
## Contributing
Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.
- Fork the Project
- Create your Feature Branch (git checkout -b feature/AmazingFeature)
- Commit your Changes (git commit -m 'Add some AmazingFeature')
- Push to the Branch (git push origin feature/AmazingFeature)
- Open a Pull Request
## License
Distributed under the [MIT](https://choosealicense.com/licenses/mit/) License.
See the [MIT](https://choosealicense.com/licenses/mit/) License for more information.