Project overview

project name : Roommate Finding Platform

webpage name : Find Mate

Roommate Finding Platform Server Repository -> Click Here

purpose : Find Mate is a roommate finding platform designed to connect individuals with compatible living partners based on preferences, location, budget, and lifestyle. It simplifies the search process through verified profiles and listings, ensuring safety and trust. Whether you're looking for a room or a roommate, Find Mate helps you find the right match quickly and easily, making shared living more comfortable, convenient, and stress-free.

Technologies :

Vite, nodejs, React.js , localstorage, React Router DOM, Tailwind CSS, DaisyUI, React Icons, React-hot-toast, MongoDB, expressJS

Features :

• secure login and registration process with firebase,

• private routing system,

• Room Ad details sections,

• Database Connection,

• Profile Update Option,

• Light and Dark Mode Toggle Feature,

• CRUD Method,

• Find Room by Search.

• Responsive for pc, laptop, tablet and molile

Frontend (React) Dependencies :

• vite : 6.3.5,

• firebase : 11.6.1

• react-countup : 6.5.3

• react-helmet-async : 2.0.5

• react-toastify : 11.0.5

• sweetalert2 : 11.21.0

• swiper : 11.2.6

• daisyui : 5.0.35,

• react : 19.1.0,

• react-dom : 19.1.0,

• react-icons : 5.5.0,

• react-router : 7.5.1,

• tailwindcss : 4.1.5

• react-awesome-reveal : 4.3.1

• react-hot-toast : 2.5.2

• react-simple-typewriter : 5.0.1

• react-tooltip : 5.28.1

Backend (Node.js with Express) Dependencies :

• cors : 2.8.5

• dotenv : 16.5.0

• express : 5.1.0

• mongodb : 6.16.0

How to run this website on local mechine :

First make sure Node.js and npm are installed on your system. If not then You can install them from Node.JS. Next, open a terminal or command prompt and use the git clone command and then paste the copied repository URL to clone the project. After cloning, navigate into the project folder using cd project-name. Once inside the project directory, run npm install to install all the dependencies listed in the package.json file. When the installation is complete, start the development server by running npm run dev. This will launch the React app in your default browser at http://localhost:5173, allowing you to view and work on the website locally. And in the backend first install backend dependencies. at http://localhost:3000 or a similar port. Make sure environment variables like database URI, API keys, or ports are correctly configured, start the development server by running nodemon index.js, typically using a .env file in both the frontend and backend directories.

Live Link :

Find Mate