Skip to content

Latest commit

 

History

History
57 lines (46 loc) · 2.7 KB

File metadata and controls

57 lines (46 loc) · 2.7 KB

🏠 Move-In

An apartment rental application which allows property owners and proposed tenants to transact efficiently.

PRs Welcome Open Source Love MIT Licence

alt text

alt text

Technologies

  • 💥 Node
  • 🔥 Express
  • ⚡ Vue.js
  • ✨ Vuetify
  • 🐘 PostgreSQL

Features

  • Material UI with Vuetify
  • Image upload and storage with cloudinary
  • Sending promotional mails to customers with cron jobs
  • Search for apartments based on location, budget and type.
  • Submit listings of apartments to be leased
  • A fully functional admin dashboard

📖 Set up

Here are the steps you need to follow to set up this project on your local machine.

  1. Clone this repo by running git clone https://github.com/georgeben/Move-In
  2. cd into the cloned repo, then cd into the server folder.
  3. Create a new PostgreSQL database
  4. Create a .env file and input the datails for connecting to your database namely PGUSER( database user), PGPASSWORD (database user password), PGDATABASE (Name of the database), PGHOST (localhost), PGPORT (connection port) or you can manually input these env variables into your terminal.
  5. After your databse is set up. Run npm install to install all the dependencies.
  6. Run npm run db:create to create the database tables
  7. Start the server with npm run start and the server sjould be live on localhost:3000. ⚡
  8. Open another terminal window and cd into the client folder.
  9. Run npm install to install all dependencies.
  10. Run npm run serve to start the dev server.
  11. View the vue app on localhost:8080. 🎉

Setting up cloudinary ☁️

  1. Create a cloudinary account here
  2. Add your CLOUD_NAME, API_KEY and API_SECRET to your .env file.
  3. When images have been uploaded, log into your cloudinary dashboard to view them. 🎉

Setting up mailer

The application uses gmail to send emails. To set up the mailer,

  1. Add your gmail email and password to your .env file
  2. Tweak the node cron scheduler to schedule intervals at the time you prefer 🎉

Contributing

Contributions are welcome. Feel free to send in your pull requests.

Author

George Benjamin ❤️