Project Overview:

The Roommate Finder App is a mobile application designed to connect individuals who are looking for shared accommodation. The app allows users to search for compatible roommates, list available rooms, and connect safely based on preferences like budget, gender, profession, lifestyle habits, and location.

It simplifies the room/roommate search process for students, working professionals, and newcomers in a city by offering a personalized and secure matching experience.

Technologies Used:

• Frontend (Mobile App):

  • HTML5, CSS3, Bootstrap

  • JavaScript

  • Hybrid framework (Ionic / Cordova)

• Backend:

  • PHP / Node.js / Java (Spring Boot)

  • MySQL or MongoDB

  • RESTful API services

• Others:

  • Google Maps API (for location search)

  • Email/OTP verification system

User Roles:

1. Room Seeker – looking for a room or roommate

2. Room Provider – offering a room or looking for a roommate

3. Admin – monitors listings and manages reports

Key Features:

1.  User Registration & Profile Setup

• Email/OTP verification or social login

• Profile setup with name, gender, age, job/student, habits, preferences

2.  Room Listing and Search

• Add room photos, rent, address, amenities

• Filter rooms by city, price, type (shared/private), and gender preference

• Map view of available listings using Google Maps

3.  Smart Matchmaking Algorithm

• Match users based on profile compatibility
  (e.g., non-smoker prefers non-smoker, pet-friendly, similar budget)

• Match suggestions ranked by compatibility score

4.  Chat and Communication

• In-app secure chat with verified users

• Users can ask questions about the room or roommate habits

• Option to block/report users

5.  Availability & Booking Schedule

• Users can set when a room is available or from when they need one

• Schedule room visits or video calls via the app

6.  Notifications & Alerts

• Alert when a new match is found

• Notification on new messages or booking interest

• Alert when listings near you are added

7.  Ratings & Reviews

• Rate roommates or rooms after a stay

• Helps maintain community trust

8.  Verification and Trust Badges

• Upload documents for identity verification

• “Verified” badge for profiles who’ve submitted ID proofs

9.  Terms, Rules, and Agreement

• Template for rental agreements (optional)

• House rules section in room details

10.  Admin Panel (Web-based)

• View and approve room listings

• Ban suspicious users

• Analytics dashboard (users, listings, activity)