BinFinder
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]
Login/SignUp page
Home page
Search page
Profile page

On this page
Languages
TypeScript53.3%Java43.5%CSS0.9%JavaScript0.9%Dockerfile0.7%HTML0.5%
Contributors
Created August 13, 2025
Updated August 24, 2025
