Skip to content

NjeriCodeCraft/rent-radar

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

11 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿ  RentRadar - Smart Rental Finder

Copyright ยฉ Faith Wanjiru 2025. All rights reserved.

This project is proprietary and not open source. Do not copy, use, or redistribute any part of this codebase without explicit permission from the author. For collaboration or usage rights, contact me (see below). See LICENSE for details.

A comprehensive rental platform that helps budget-conscious tenants find their perfect home with smart filtering, location-based search, agent services, and more.


๐Ÿš€ Project Overview

RentRadar is a full-stack web app for discovering, booking, and managing rental properties in Kenya. It features smart search, interactive maps, agent and booking systems, reviews, notifications, and more.

Live Demo: https://rentradar254.netlify.app/

Tech Stack:

  • Frontend: React, Tailwind CSS, Vite, Google Maps API, Formik, Yup, Axios
  • Backend: Express.js, Node.js, MongoDB, JWT, Multer

๐Ÿ› ๏ธ Getting Started

Prerequisites

  • Node.js (v16 or higher)
  • MongoDB
  • Google Maps API key (see below)

Installation

  1. Clone the repository

    git clone <repository-url>
    cd rent-radar
  2. Install dependencies

    # Frontend
    cd client && npm install
    # Backend
    cd ../server && npm install
  3. Environment setup

    • In server/.env:

    PORT=5000 MONGODB_URI=mongodb://localhost:27017/rent-radar JWT_SECRET=your_jwt_secret

    - In `client/.env`:
    ```env
    VITE_GOOGLE_MAPS_API_KEY=your_google_maps_api_key
    
  4. Start development servers

    # Backend
    cd server && npm run dev
    # Frontend (in new terminal)
    cd client && npm run dev

โœจ Core Features

  • Smart search & filtering (location, budget, amenities)
  • Interactive map with listings, contributions, and landmarks
  • User authentication (JWT)
  • Agent registration & dashboard
  • Booking system
  • Favorites & profile management
  • Reviews & ratings
  • Notifications (in-app, email)
  • Admin dashboard (user/listing/contribution management, analytics)
  • CSV export for admin data
  • Responsive, modern UI

๐Ÿ”ฎ Planned & Future Features

  • Advanced notifications (push, email, in-app improvements)
  • M-PESA payment integration (full production flow)
  • Admin dashboard enhancements (analytics, moderation tools)
  • Gamification (badges, points, leaderboards)
  • Advanced map features (heatmaps, drawing, more filters)
  • Improved mobile UX/UI
  • User-to-user messaging
  • More granular search filters (amenities, neighborhoods, etc)
  • Multi-language support
  • Accessibility improvements
  • Real-time chat/support
  • More robust review and rating system
  • AI-powered recommendations
  • Virtual reality property tours
  • Blockchain-based rental agreements
  • Integration with utility companies
  • Community features and reviews

Note: Some features are in progress or will be updated in future releases. This list is evolvingโ€”contributions and ideas are welcome!


๐Ÿ“ Project Structure

rent-radar/
โ”œโ”€โ”€ client/                 # Frontend (React + Tailwind)
โ”‚   โ”œโ”€โ”€ src/
โ”‚   โ”‚   โ”œโ”€โ”€ components/     # Reusable UI components
โ”‚   โ”‚   โ”œโ”€โ”€ pages/          # Page components
โ”‚   โ”‚   โ”œโ”€โ”€ services/       # API services
โ”‚   โ”‚   โ”œโ”€โ”€ context/        # React context
โ”‚   โ”‚   โ”œโ”€โ”€ App.jsx
โ”‚   โ”‚   โ”œโ”€โ”€ main.jsx
โ”‚   โ”‚   โ””โ”€โ”€ index.css
โ”‚   โ”œโ”€โ”€ tailwind.config.js
โ”‚   โ”œโ”€โ”€ package.json
โ”‚   โ””โ”€โ”€ vite.config.js
โ”œโ”€โ”€ server/                 # Backend (Express + MongoDB)
โ”‚   โ”œโ”€โ”€ models/             # Database models
โ”‚   โ”œโ”€โ”€ routes/             # API routes
โ”‚   โ”œโ”€โ”€ middleware/         # Custom middleware
โ”‚   โ”œโ”€โ”€ utils/              # Helper functions
โ”‚   โ”œโ”€โ”€ uploads/            # Image uploads
โ”‚   โ”œโ”€โ”€ .env
โ”‚   โ”œโ”€โ”€ index.js
โ”‚   โ””โ”€โ”€ package.json
โ””โ”€โ”€ README.md

๐ŸŽจ Features in Detail

Smart Search

  • Location-based filtering (city, neighborhood, landmarks)
  • Budget range selection
  • Amenities filtering (water, power, WiFi, security)
  • Property type selection
  • Number of bedrooms/bathrooms

Visual Experience

  • High-quality property photos
  • Virtual tours (future)
  • Street view integration
  • Neighborhood photos

Location Services

  • Interactive maps showing all listings
  • Route planning from current location
  • Distance calculations
  • Public transport information

Premium Services

  • Verified local guides
  • Property viewing appointments
  • Detailed property reports
  • Negotiation assistance

๐Ÿ’ฐ Revenue Model

  • Freemium: Basic search free, premium features paid
  • Commission: Percentage from successful rentals
  • Agent Fees: Commission from local guides
  • Featured Listings: Promoted listings for landlords
  • Advertising: Property management companies

๐Ÿ“ Notes

  • Some features are in progress or will be updated in future releases.
  • The feature list is evolvingโ€”feel free to suggest or contribute!

Built with โค๏ธ for the Kenyan rental market


๐Ÿ“บ Live Demo / How It Works

Coming soon: A video walkthrough or live demo link will be added here to showcase the main features and user experience of RentRadar.


๐Ÿ“ธ Screenshots & Demo

Video Walkthrough: Watch the demo (Coming soon!)

Screenshots coming soon!


โ“ Why RentRadar?

Finding a good house in Kenya is a real hustleโ€”lots of toiling, wasted time, and uncertainty. RentRadar was built to make the process easier, safer, and smarter for everyone. No more endless searching, unreliable listings, or wasted trips. Just the right home, found fast.


๐Ÿ—บ๏ธ Roadmap

  • Core search, listings, and map features
  • User authentication and profiles
  • Agent and booking system
  • Reviews, ratings, and notifications
  • Admin dashboard and analytics
  • M-PESA integration (coming soon)
  • Gamification and advanced notifications
  • Mobile app and more map features
  • ...and more! See the Planned & Future Features section above

๐Ÿค Collaboration & Contact

Interested in collaborating or contributing to make RentRadar even better? Reach out!

Feel free to contact me with ideas, feedback, or if you'd like to join the project as a developer, designer, or tester. All contributions and suggestions are welcome!


About

A comprehensive rental platform that helps budget-conscious tenants find their perfect home with smart filtering, location-based search, agent services, and more.

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages