GitHunt
FI

FidalMathew/BinFinder

BinFinder

BinFinder2

binFinder is a community-driven platform that helps people easily find, add, and share nearby waste bins, making cities cleaner and smarter. It combines location tracking with community contributions, ensuring that bin locations are always up to date.


โœจ Features

  • ๐Ÿ“ Find Bins Nearby โ€“ View bins on an interactive Google Maps interface.
  • โž• Add New Bins โ€“ Contribute by adding new bin locations with details.
  • ๐Ÿ“ท Upload Bin Photos โ€“ Secure photo uploads powered by Cloudinary.
  • ๐Ÿ” User Profiles โ€“ Track your contributions and manage your account.
  • ๐ŸŒ Community Collaboration โ€“ Shared database of bin locations for everyone.

๐Ÿ› ๏ธ Tech Stack

Frontend:

  • React (Vite)
  • Google Maps Cloud API

Backend:

  • Java Spring Boot (REST APIs)
  • MySQL Database

Storage & Deployment:

  • Cloudinary (Image uploads)
  • Docker (Containerized deployment)
  • Vercel (Frontend hosting) + Cloud host for backend

โš™๏ธ Architecture

flowchart LR
    User((User)) -->|Interacts| React[React + Vite Frontend]
    React -->|API Calls| SpringBoot[Java Spring Boot Backend]
    SpringBoot --> MySQL[(MySQL Database)]
    React -->|Image Upload| Cloudinary[Cloudinary]
    React -->|Maps| GoogleMaps[Google Maps Cloud API]
    SpringBoot --> Docker[Dockerized Deployment]
Loading

Login/SignUp page

image

Home page

image

Search page

image

Profile page

image

Languages

TypeScript53.3%Java43.5%CSS0.9%JavaScript0.9%Dockerfile0.7%HTML0.5%

Contributors

Created August 13, 2025
Updated August 24, 2025
FidalMathew/BinFinder | GitHunt