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

Ekep-Obasi/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.