Prop-suite

This is a platform where clients can check for available property(apartment) postings, contact the sellers, then review the sellers after a transaction. The app's original theme both in design and functionality is built to mimic Twitter, so users also have to option to follow other users. The app is mobile-responsive.

Outline

• Live version
• UI Preview
• Features
• Technologies used
• Installation
• cloudinary setup
• Entity Relationship Diagram(ERD)
• Endpoints
  • auth
  • users
  • apartments
  • followings
  • reviews
  • search
• Author
• Licence

Live version

The website is hosted on heroku here => propsuite.

UI Preview

Features

The app has two levels of authorization;

• A regular client can

  • view public documents on the website(apartments, agents' reviews, followers).
  • signup for an account to be able to use the service.
  • search for an apartment by address, category, price.

• A user has all the privileges of a regular client and can also perform the following actions:

  • Log in to use their account.
  • Add a new apartment posting with multiple photos.
  • review a seller after a transaction.
  • follow other users.
  • update their profiles including avatar and coverphoto uploads.
  • Log out of their account.
  • Delete their account.

Technologies

• The application was developed with Ruby on Rails.
• Postgres for database management.
• All apartment, user avatar and coverphoto images are hosted on Cloudinary.
• Sass and pure CSS for styling.
• Stimulus Js for adding functional responsiveness(click events management).
• Webpacker for managing javascript assets.
• Github Actions for CI.
• Rubocop to ensure ruby developer best practices.
• Rspec and Capybara for UI, unit and integration tests.

Installation

Follow the steps below to setup a local development environment. First ensure you have postgres installed, and a version of Ruby on Rails equal to or greater than v5.2.3 .

1. Clone the repository from a terminal
   git clone https://github.com/codecell/prop-suite.
2. Navigate to the project directory.
   cd prop-suite
3. Install project Ruby/Rails dependencies.
   bundle install
4. Install Javascript dependencies.
   yarn install
5. Run the migrations to setup the tables.
   rails db:migrate
6. Start the rails server.
   rails server
7. Visit localhost:3000 and Voila!!!.

Cloudinary setup

All image uploads are hosted on Cloudinary, so ensure to register for an account(registration is free). - After registration copy your cloud-name, api-secret and api-key into config/application.yml, I left a sample in config/application_sample.yml. - Please do not expose your cloudinary credentials to the public so ensure to place the path to the config/application.yml in the .gitignore file.

Entity Relationship Diagram

Endpoints

Auth

Users

Apartments

Following

Reviews

Search

Author

👤 Alfred Ezaka

• Github: @codecell
• Twitter: @the_codecell
• Linkedin: ezaka alfred

Show your support

Give a ⭐️ if you like this project!

Licence

• MIT