Skip to content

House Rental full stack application built with Next Js & Express using the microservice architecture

Notifications You must be signed in to change notification settings

Soklin-Phon/Homely

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 

Repository files navigation

Homely 🏠

Homely

πŸ’₯ Introduction

Homely is a full-stack house rental application built with ✨ Next.js ⚑️ and πŸ’― TypeScript on the frontend, and πŸ™ Node.js πŸš† and 🚦 Express on the backend. It uses πŸ”₯ Firebase for authentication, and stores secret keys in a πŸ” .env file. The frontend uses ✨ Shadcn UI for most of its UI components. The app features:

  • πŸŽ‰ Interactive dashboard πŸŽ‰ Dashboard
  • πŸ—ΊοΈ Amazing map 🌐 Map
  • πŸ’¬ Minimal chat section πŸ’¬ Chat
  • πŸ—„οΈ MongoDB for data storage Database

Getting Started

Prerequisites

  • πŸ”Œ Node.js v16.x or higher Node.js
  • 🧢 Yarn v1.22.x or higher Yarn

πŸ› οΈ Local development

To ensure that you are able to install everything properly, we would recommend you to have Git, NPM and Node.js installed.

We will first start with setting up the Local Project Environment:

git clone https://github.com/Ekep-Obasi/Homely.git
cd Homely
npm run dev:install

Now we will add the environment variables in the client/ and server/

  • Create a .env file in both client and server folder according to .example.env given in both the folders respectively.

Once you run the Commands and get environment variables and everything fine, we are all set to run the app βœ”οΈ

On the root level run the following command:

npm run dev

To lint the code files, run the following command on root level:

npm run lint

The app will be available at http://localhost:3000.

Features

  • πŸŽ‰ Interactive dashboard
  • πŸ—ΊοΈ Amazing map
  • πŸ’¬ Minimal chat section
  • πŸ—„οΈ MongoDB for data storage

Tech Stack

  • ✨ Frontend: Next.js, TypeScript, Shadcn UI
  • πŸ™ Backend: Node.js, Express, MongoDB

Contribution

Contributions are welcome! Please open a pull request if you have any improvements or bug fixes.

License

Homely is licensed under the πŸ“ MIT License.

About

House Rental full stack application built with Next Js & Express using the microservice architecture

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • TypeScript 93.6%
  • EJS 5.0%
  • Other 1.4%