CivicScan is a Django-based full-stack web application designed to empower citizens of Bengaluru to report and track public cleanliness issues. This platform is part of a broader ambition to create a cleaner, more aware India by leveraging technology for civic participation.
"Cleanliness is not just about sanitation; it's a mindset."
CivicScan aims to encourage community participation in keeping public spaces clean. The app provides a simple, accessible way for people to:
- Report cleanliness issues (with photos & location)
- View others' reports on an interactive map
- Help authorities prioritize problem areas
🌐 Hosted on Render: https://civicscan.onrender.com
- Backend: Django 5.1, Python 3.12
- Frontend: HTML5, CSS3, JavaScript, Leaflet.js
- Database: PostgreSQL (Render)
- Media Storage: Cloudinary
- Deployment: Render (Free Plan)
- Version Control: Git & GitHub
- Signup/Login with validation
- User profiles
- Session-based authentication
- Submit photos, cleanliness status, and review
- Auto-location detection with reverse geocoding
- Conditional UI for anonymous vs. logged-in users
- User feedback after submission
- Interactive Leaflet.js map
- Color-coded markers: Red = Dirty, Blue = Clean
- Marker popups show status, location, photo preview
- Lightbox for full image view
- JSON API for map data
- Centralized
base.htmlwith{% block content %} - Navbar with dynamic menu based on auth status
- Mobile-first layout with media queries
- Machine Learning: scikit-learn (DBSCAN clustering)
- Media storage via Cloudinary
- Static files handled with WhiteNoise
- Render environment variables for security
- Logs & debugging with logging module
- Clusters multiple "dirty" reports using DBSCAN (scikit-learn)
- Automatically detects high-density complaint areas
- Saves hotspot data with location and report count
- Visualizes hotspots as red circles on the map (Leaflet.js)
- Helps authorities focus on most affected areas
| Feature | Description |
|---|---|
| Edit/Delete Reports | Allow users to manage submissions |
| Search by Area | Address-based filtering for admin map |
| Filter by Status | View only "dirty" or "clean" areas |
| Live Map Updates | Polling or refresh option for new data |
| AI Hotspot Detection | Predict areas needing urgent action |
| Heatmap Layer | Use heatmaps to show issue density |
| Dynamic Hotspot Radius | Adjust circle size by report count |
| Hotspot Time Filter | Show hotspots only from past 7 days |
CivicScan uses AI (DBSCAN clustering) to find high-frequency cleanliness issues and shows them as red heat zones on the map:
BrillianBengaluru/
├── homepage/ Static content & landing
├── users/ Auth & profile
├── reports/ Report submission & map
├── templates/ Jinja templates
├── static/ Custom CSS, JS, icons
├── media/ (Optional) local fallback
├── manage.py
├── requirements.txt
├── render.yaml Render deployment config
├── .env (not committed)
- All secrets (DB, Cloudinary, SECRET_KEY) loaded via environment variables
.envfile is ignored via.gitignore- Render handles env securely through Dashboard
This project reflects a deep personal goal: to contribute meaningfully to India's cleanliness movement. Bengaluru is only the beginning. CivicScan aspires to evolve with AI, community feedback, and city-level expansion.
"Don’t wait for change. Report it. Inspire it."
Girish Yandigeri
MCA Student @ RVCE
- Django & Python community
- Leaflet.js & OpenStreetMap
- Cloudinary for free media storage
- Render.com for free hosting
- Friends and mentors who encouraged this dream 💙
This project is for educational and demonstration purposes.
MIT License coming soon.
Want to contribute ideas, suggest features, or collaborate?
Reach out! Let’s build something good together for our cities. 🧼