Skip to content

prathamhanda/RoomsonRent

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

75 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

RoomsonRent - Student Housing Platform

RoomsonRent is a comprehensive platform designed to solve the critical challenge of finding quality student housing near educational institutions. Focusing primarily on the Delhi college market, this platform connects students with suitable accommodations while helping landlords efficiently manage their rental properties.

CLIENT SIDE LANDLORD SIDE
Client Side Video Landlord Side Video

πŸ”— Click on the thumbnails above to watch the demo videos.


πŸ“Š Market Overview

The Problem

College students face significant challenges finding safe, affordable housing near their educational institutions. The traditional housing search process is fragmented, time-consuming, and often leads to suboptimal living situations that affect academic performance.

Our Solution

RoomsonRent bridges this gap by creating a centralized platform specifically designed for student housing needs. We connect students from over 70 Delhi colleges with verified accommodations nearby, simplifying the entire process from search to move-in.

🌟 Features

For Students

  • College-Based Search: Find accommodations near 70+ Delhi colleges and educational institutions
  • Location-Aware Recommendations: Get personalized property suggestions based on proximity to your college
  • Distance Calculation: See exactly how far each property is from your educational institution
  • Advanced Filtering: Filter by rent, amenities, room type, and occupancy options
  • Detailed Property Listings: High-quality images, comprehensive descriptions, and available amenities
  • Booking Management: Schedule viewings and manage rental applications with ease
  • Verified Reviews: Read authentic feedback from other students who have lived in the properties
  • Budget Options: Choose from both regular and premium accommodations to match your budget

For Landlords

  • Student-Focused Listing Tools: Showcase your properties to the right audience of college students
  • College Proximity Highlight: Automatically show students how close your property is to their institution
  • Property Management Dashboard: Easily add, edit, and manage multiple listings
  • Booking Oversight: Process booking requests and communicate with potential student tenants
  • Image Management: Upload and organize property photos with Cloudinary integration
  • Analytics Tools: Track listing performance and visitor engagement metrics
  • Tenant Verification: Review student applications including college information
  • WhatsApp Integration: Direct communication with student tenants for faster responses

Target Market & Opportunity

Total Addressable Market (TAM)

  • Delhi NCR Student Population: Over 500,000 students enrolled in 70+ colleges and universities
  • Annual Housing Need: Approximately 300,000 students seeking off-campus accommodations each year
  • Market Value: β‚Ή9,000 Cr+ ($1.1B+) annual student housing market in Delhi NCR region

Key Market Segments

  • Undergraduate Students: First-time renters looking for affordable shared accommodations
  • Postgraduate Students: Seeking quality housing with study-friendly environments
  • International Students: Requiring verified, safe housing options with additional amenities
  • Short-term Program Students: Needing flexible rental terms for internships and short courses

Competitive Advantage

  • College-Specific Focus: Direct targeting of housing needs around specific institutions
  • Verification System: All properties and landlords undergo a verification process
  • End-to-End Solution: From property discovery to booking confirmation and ongoing management
  • Transparency: Clear pricing, no hidden fees, and authentic student reviews.

πŸ› οΈ Technology Stack

Backend

  • Node.js & Express: RESTful API architecture
  • MongoDB: NoSQL database for flexible data storage
  • JWT Authentication: Secure user authentication and authorization
  • Cloudinary API: Cloud-based image storage and manipulation
  • WhatsApp Business API: Integrated messaging capabilities
  • Email Services: Automated notifications and communications.

Frontend

  • React: Component-based UI development
  • Vite: Next-generation frontend tooling
  • Tailwind CSS: Utility-first CSS framework
  • React Context API: State management
  • Mapbox/Leaflet: Interactive mapping functionality
  • Responsive Design: Seamless experience across all devices

DevOps & Tooling

  • Docker: Containerized development and deployment
  • CI/CD Pipeline: Automated testing and deployment
  • Git Version Control: Collaborative development workflow

πŸš€ Getting Started

Prerequisites

  • Node.js (v14.0.0 or later)
  • MongoDB (local or Atlas)
  • Cloudinary account
  • WhatsApp Business API access (optional)

Environment Configuration

Before running the application, you need to set up the environment configuration:

  1. Navigate to the backend/config directory
  2. Copy the config.env.example file to config.env
  3. Fill in your credentials in the config.env file:
    • MongoDB connection string
    • JWT secret
    • Cloudinary credentials
    • SMTP email settings
    • Other required environment variables

Example:

# Copy the example config
cp backend/config/config.env.example backend/config/config.env

# Edit the config file with your credentials
nano backend/config/config.env

Installation & Setup

Backend

cd backend
npm install
npm run dev

Frontend

cd frontend_main
npm install
npm run dev

Landlord Dashboard

cd frontend_landlord
npm install
npm run dev

πŸ“Š Project Structure

RoomsonRent/
β”œβ”€β”€ backend/               # Main API server
β”‚   β”œβ”€β”€ controllers/       # Request handlers
β”‚   β”œβ”€β”€ models/            # MongoDB schemas
β”‚   β”œβ”€β”€ routes/            # API endpoints
β”‚   β”œβ”€β”€ middleware/        # Custom middlewares
β”‚   └── config/            # Configuration files
β”œβ”€β”€ backend_wa/            # WhatsApp integration service
β”œβ”€β”€ frontend_main/         # Tenant-facing application
β”‚   β”œβ”€β”€ src/
β”‚   β”‚   β”œβ”€β”€ components/    # Reusable UI components
β”‚   β”‚   β”œβ”€β”€ pages/         # Application views
β”‚   β”‚   └── context/       # State management
└── frontend_landlord/     # Landlord dashboard

πŸ”’ Security Note

The config.env file contains sensitive information and should never be committed to version control. It is included in the .gitignore file to prevent accidental commits.

🌟 Impact & Vision

RoomsonRent aims to transform the student housing experience in India, starting with the Delhi NCR region. By solving the critical housing challenges faced by students, we're contributing to better academic outcomes, reduced stress, and improved quality of life for the student community.

Our long-term vision includes:

  • Expanding to all major educational hubs across India
  • Building partnerships with educational institutions for official housing recommendations
  • Creating a comprehensive support system for first-time student renters
  • Developing additional services like roommate matching and bill splitting
  • Establishing the largest verified student housing database in India

Join us in revolutionizing student housing in India!

About

The Official Repository for the RoomsonRent.in - PG Booking Service across Delhi-NCR

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •