Skip to content

JiaAneja/nearby

Β 
Β 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

122 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🏠 NearBy – Student Housing & Local Services Platform

NearBy is a student-centric web platform built to simplify the process of finding rental rooms, PGs, hostels, and essential local services in a new city.
The platform eliminates broker dependency and connects students, property owners, and local service providers directly in a trusted, user-friendly environment.

Elite Coders GitHub stars GitHub forks GitHub issues License PHP Version MySQL

🌟 Problem Statement

When students move to a new city for education, they often face challenges such as:

  • Difficulty finding safe and affordable accommodation
  • High brokerage charges
  • Unreliable listings and lack of trust
  • No single platform for daily local services (food, milk, gas, etc.)
  • Feeling lost without local guidance

βœ… Solution – NearBy

NearBy solves these problems by providing:

  • Verified accommodation listings near campuses
  • Direct communication with owners and service providers
  • Local guidance for food, transport, and daily needs
  • AI-powered chatbot support
  • A modern, clean, and mobile-friendly interface

The platform is designed by students, for students, keeping real-life needs in mind.


✨ Features 🏑 Accommodation Discovery

Browse PGs, rooms, flats, and hostels

Student-focused listings near campuses

Advanced filters:

Location

Rent range

Accommodation type

Gender preference (Male / Female / Family)

Facilities (Wi-Fi, Food, Parking, Water, Electricity, CCTV, Power Backup)

πŸ§‘β€πŸ€β€πŸ§‘ Multi-Role User System

Supports multiple user roles:

Students

Property Owners

Local Service Providers

Dedicated dashboards for each role

Role-based access and functionality

🏠 Property & Listing Management

Property owners can:

Add new accommodation listings

Edit and manage their listings

Service providers can:

Add and manage local service listings

Listings update in real time for users

🧺 Local Services Directory

Discover essential local services:

Tiffin / Mess services

Milk (Doodh) providers

Gas suppliers

Vegetable (Sabji) vendors

Other daily-need services

Everything accessible from one platform

πŸ€– AI-Powered Chatbot Assistance

Integrated AI chatbot (Gemini AI)

Available on:

Home page

Search page

User dashboards

Provides:

Accommodation and service guidance

Local help and suggestions

Student-friendly Q&A

Login-based access control

Secure chat history storage

Works on both local and live servers

πŸ“ Local Guidance & Discovery

Helps students find:

Nearby food options

Transport information

Hospitals and essential shops

Acts as a digital local guide for new students

πŸ” Authentication & Security

Secure login and authentication system

Role-based access control

Guest users can:

View listings

View chatbot interface (login required to interact)

Clean session and backend handling

πŸ“± Responsive & Modern UI

Fully responsive across all devices

Clean, modern, and student-friendly design

Glassmorphism UI with a light green theme

🌐 Map & Location Integration

Location-based discovery of rooms and services

Map API integration for better navigation

⚑ Performance & Usability

AJAX-based interactions for faster performance

Smooth and intuitive user experience

Minimal and easy-to-navigate interface

🌐 Live Project

πŸ”— Website: https://sumitrathor.rf.gd/nearby/
πŸ”— GitHub Repository: https://github.com/sumitrathor1/nearby


🌐 Flow Diagram

Flow Diagram

🧩 Core Features

🏑 Accommodation Search

  • PG, Flat, Room, Hostel listings
  • Advanced filters:
    • Location
    • Rent range
    • Accommodation type
    • Allowed for (Male / Female / Family)
    • Facilities (Wi-Fi, Food, Parking, Water, Electricity, CCTV, Power Backup)

πŸ§‘β€πŸ€β€πŸ§‘ Multi-Role User System

Users on NearBy can be:

  • Students (Juniors and Seniors)
  • Home / Room Owners
  • Local Service Providers:
    • Tiffin / Mess services
    • Milk (Doodh) providers
    • Gas suppliers
    • Vegetable (Sabji) vendors
    • Other daily-need services

Each role can create and manage their own listings.

πŸ€– AI Chatbot Assistance

  • Available on:
    • Home Page
    • Search Page
    • Junior & Senior Dashboards
  • Login-based access control
  • Features:
    • Room and service guidance
    • Local help suggestions
    • Student-friendly Q&A
  • Chat history stored securely
  • Works seamlessly on local and live servers

πŸ“ Local Guidance

  • Nearby food options
  • Transport information
  • Hospitals, shops, and essential services
  • Helps new students settle quickly and confidently

πŸ” Authentication & Security

  • Secure login system
  • Role-based access
  • Guest users can view chatbot but must login to use it
  • Clean session and backend handling

πŸ“Έ Screenshots

Home Page

Home Page

Listings Page

Listings Page

Local Services

Local Services


πŸ› οΈ Tech Stack

Frontend

  • HTML5 - Semantic markup
  • CSS3 - Custom styling with Glassmorphism UI
  • Bootstrap 5.3 - Responsive framework
  • JavaScript (ES6) - Interactive functionality

Backend

  • PHP - Server-side logic
  • MySQL (MySQLi) - Database management
  • AJAX - Asynchronous data loading

Integrations

  • Google APIs - Maps and authentication
  • Gemini AI - Chatbot functionality
  • Firebase - Additional services

πŸš€ Future Enhancements

  • Admin verification for listings
  • Rating & review system
  • Second-hand products marketplace
  • Push notifications
  • Mobile app version
  • Advanced AI recommendations
  • Dark/Light mode toggle

πŸ’‘ Key Benefits

βœ… No brokerage fees
βœ… Student-friendly platform
βœ… Trusted & direct connections
βœ… AI-powered assistance
βœ… Local services in one place
βœ… Fully responsive design
βœ… Easy to scale and extend


πŸ‘₯ Contributors

We appreciate all contributors who have helped make NearBy better!

Name GitHub LinkedIn Role
Sumit Rathor @sumitrathor1 LinkedIn Project Lead & Developer
Rana Pooja @RANAPOOJA321 LinkedIn UI/UX Designer & Contributor
[Your Name] @yourusername LinkedIn Contributor

Want to contribute? See our Contributing Guidelines and join the team!


πŸ“„ License

This project is currently under development and learning phase.
Licensing and commercial usage terms will be defined in future releases.


πŸ™Œ Acknowledgements

Thanks to:

  • Open-source community for the amazing tools and libraries
  • Student testers and feedback providers for valuable insights
  • Mentors and peers who contributed ideas and reviews
  • Elite Coders program for the opportunity to collaborate

NearBy – Helping students find a place and feel at home. 🌟

About

NearBy is a student-to-student housing support platform designed to make relocation easier, safer, and more human. The platform connects new and junior students with verified senior students who have already experienced city life and housing challenges. Seniors share genuine, practical advice about safe rooms, PGs, hostels, and flats near campus

Resources

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • PHP 71.2%
  • JavaScript 19.3%
  • CSS 9.5%