A revolutionary crowdsourced poop detection and alert system that helps keep communities clean!
Pooler is like "Waze for Poop" - a community-driven Progressive Web App that:
- 🚨 Alerts you when you're near dog poop
- 📍 Lets you report poop locations
- 🏛️ Notifies municipalities for cleanup
- 🌍 Uses crowdsourced data to keep streets clean
✨ Real-time proximity alerts - Get notified within 50m of reported poop 🗺️ Interactive map with poop markers - OpenStreetMap & Google Maps support 📱 Progressive Web App - Install on your phone, works offline 📍 GPS-based reporting - One-tap reporting from your location 🏛️ Municipality notifications - Direct alerts to local authorities 🔬 AR & sensor integration - Framework for smart glasses and wearables 🔄 Cross-device sync - Share reports via GitHub Gist or JSONBin.io
- Visit https://ariel-oversee.github.io/
- Allow location access
- Setup cross-device sync (Settings ⚙️ > Option 2) so reports appear for all users
- Report poop when you see it
- Receive alerts when approaching reported locations
# Clone the repository
git clone https://github.com/ariel-oversee/ariel-oversee.github.io.git
cd ariel-oversee.github.io
# Start local server
python -m http.server 8000
# OR
npx serve .
# Open in browser
open http://localhost:8000No build process required - pure vanilla JavaScript!
- User Guide - Complete user documentation with setup instructions
- Architecture Documentation - Technical architecture and system design
- API Documentation - Complete API reference for all JavaScript classes
- Contributing Guide - How to contribute to Pooler
- AI Assistant Instructions - Guidelines for AI assistants working with this codebase
- Frontend: Vanilla JavaScript (ES6+), HTML5, CSS3
- Maps: Leaflet.js (OpenStreetMap), Google Maps API
- Storage: localStorage (client-side), IndexedDB (planned)
- PWA: Service Workers, Web App Manifest
- Sync: GitHub Gist API, JSONBin.io API, Custom backends
- Advanced: Generic Sensor API, WebXR, Web Bluetooth
ariel-oversee.github.io/
├── index.html # Main application UI
├── app.js # Core application logic (PoolerApp)
├── backend-sync.js # Cross-device sync (BackendSync)
├── maps-integration.js # Map providers (MapsIntegration)
├── sensor-integration.js # Advanced detection (SensorIntegration)
├── service-worker.js # PWA functionality
├── manifest.json # PWA manifest
├── README.md # This file
├── POOLER_README.md # User documentation
├── ARCHITECTURE.md # Technical architecture
├── API.md # API documentation
├── CONTRIBUTING.md # Contribution guidelines
└── CLAUDE.md # AI assistant instructions
| Feature | Chrome | Safari | Firefox | Edge |
|---|---|---|---|---|
| Core App | ✅ | ✅ | ✅ | ✅ |
| PWA Install | ✅ | ✅ | ❌ | ✅ |
| Service Worker | ✅ | ✅ | ✅ | ✅ |
| Geolocation | ✅ | ✅ | ✅ | ✅ |
| Sensor API | ✅ | ❌ | ❌ | ✅ |
| WebXR (AR) | ✅ | ❌ | ❌ | ✅ |
| Web Bluetooth | ✅ | ❌ | ❌ | ✅ |
We welcome contributions! Here's how:
- Report bugs - Open an issue
- Suggest features - Start a discussion
- Submit PRs - Read our Contributing Guide first
- Test the app - Use it and provide feedback
- Spread the word - Share with your community
See CONTRIBUTING.md for detailed guidelines.
- Interactive map with markers
- Geolocation tracking
- Report submission
- Proximity alerts
- PWA installation
- Cross-device sync
- Backend API for data sync
- User accounts and profiles
- Gamification & rewards
- Municipality dashboard
- Multi-language support
- AI/ML poop detection
- AR glasses integration
- Smart watch app
- Real-time P2P sync
- Blockchain incentives
See ARCHITECTURE.md for technical roadmap.
This project is released under the MIT License. See LICENSE file for details.
- OpenStreetMap contributors for mapping data
- Leaflet.js team for excellent mapping library
- Community for reporting and confirming poop locations
- You for caring about clean streets! 💚
- Issues: GitHub Issues
- Discussions: GitHub Discussions
- Live Demo: ariel-oversee.github.io
- The average dog produces 274 pounds of poop per year
- Dog poop is one of the top contributors to urban water pollution
- A single gram of dog waste contains 23 million fecal coliform bacteria
- Pooler helps prevent all of this! 🌍
Built with 💩 by the community, for the community.
Remember: A cleaner city starts with reporting!