Skip to content
 
 

Repository files navigation

🌊 CleanFlow Mumbai: Water Bodies Revival

Empowering communities to restore Mumbai's water ecosystems through technology and collective action

🎯 The Problem

Mumbai, despite being surrounded by water, faces a critical environmental challenge:

  • 🏭 Heavy pollution in lakes, rivers (Mithi), and coastlines
  • 🗑️ Plastic waste and industrial dumping contaminating water bodies
  • 🏥 Health risks to communities from polluted water sources
  • 🌧️ Urban flooding during monsoons exacerbated by clogged waterways
  • 👥 Lack of citizen engagement in environmental restoration efforts

💡 Our Solution

CleanFlow is a community-driven platform that transforms every citizen into an environmental guardian. We bridge the gap between awareness and action through technology, making water body restoration a collaborative effort.

🎯 Mission

To create a sustainable ecosystem where technology empowers communities to monitor, report, and actively participate in restoring Mumbai's water bodies.


✨ Key Features

🗺️ Interactive Pollution Map

  • Real-time visualization of Mumbai's water bodies
  • Pollution hotspot identification
  • Live cleanup drive locations

📍 Crowdsourced Reporting

  • One-click pollution reporting with GPS coordinates
  • Photo evidence and detailed descriptions
  • Community verification system

🤝 Cleanup Drive Management

  • Event creation and scheduling tools
  • RSVP and participant management
  • Integration with verified NGOs

🏆 Gamified Impact System

  • Earn Impact Points for contributions
  • Global leaderboards and achievements
  • Recognition for environmental champions

👤 User Profiles & NGO Integration

  • Personal impact tracking
  • Verified NGO profiles
  • Community networking features

🛠️ Technology Stack

Component Technology Purpose
Frontend React + Tailwind CSS Responsive, modern UI
Backend Supabase Real-time database & auth
Database PostgreSQL (via Supabase) Data persistence
Maps OpenFreeMap Interactive mapping
Hosting Netlify Deployment

🚀 Quick Start

Prerequisites

  • Node.js (v16 or higher)
  • npm or yarn package manager
  • Supabase account

Installation

  1. Clone the repository

    git clone https://github.com/[username]/cleanflow-mumbai.git
    cd cleanflow-mumbai
  2. Install dependencies

    npm install
  3. Set up environment variables

    cp .env.example .env.local

    Add your Supabase credentials to .env.local

  4. Start the development server

    npm start
  5. Open your browser Navigate to http://localhost:3000


📱 Usage Guide

For Citizens

  1. Report Pollution: Drop a pin on polluted areas with photos
  2. Join Cleanups: Find and participate in local cleanup drives
  3. Track Impact: Monitor your environmental contributions
  4. Compete: Climb the leaderboard and earn recognition

For NGOs

  1. Create Profile: Get verified organization status
  2. Organize Events: Schedule and manage cleanup drives
  3. Engage Community: Connect with volunteers and supporters
  4. Track Progress: Monitor cleanup effectiveness

🔮 Future Roadmap

Phase 1: Enhanced Data Integration

  • Government sensor data integration
  • Real-time pollution monitoring
  • Predictive pollution modeling

Phase 2: Mobile Excellence

  • Native mobile applications (iOS/Android)
  • Offline reporting capabilities
  • Push notifications for nearby events

Phase 3: Community Building

  • Educational resource hub
  • Team formation and challenges
  • Success story sharing platform
  • Corporate partnership program

Phase 4: Expansion

  • Multi-city support
  • Advanced analytics dashboard
  • AI-powered pollution detection
  • Integration with smart city initiatives

🤝 Contributing

We welcome contributions from the community! Please see our Contributing Guide for details.

How to Contribute

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

👥 Team

Developer Role GitHub
Tanmay Nayak Mobile App Developer @tanmaynayak
Sumit Mishra Full Stack Developer @sumitmishra

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.


🌟 Support the Project

If you find CleanFlow valuable:

  • ⭐ Star this repository
  • 🍴 Fork and contribute
  • 📢 Share with your network
  • 💡 Suggest new features

Together, we can restore Mumbai's water bodies! 🌊

Made with ❤️ for a cleaner, healthier Mumbai

This enhanced README includes proper formatting, badges, structured sections, visual appeal, and comprehensive information that makes your project more professional and accessible to potential contributors and users.

About

PixelHack Round 2

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages