🌍 CleanCred

An Intelligent, Gamified Waste Management & Tracking Platform

Developed by Team GreenLegacy

🌐 View Live Website • Features • Installation

---

📖 About

CleanCred is a comprehensive, multi-portal waste management ecosystem designed to incentivize environmental cleanliness and accountability. By combining real-time reporting, geolocation tracking, and a gamified rewards system, the platform bridges the gap between citizens, sanitation workers, and governing institutions.

The goal is simple: reward users for responsible waste disposal while providing administrators and sanitation teams with actionable, data-driven insights into city-wide environmental impacts. Whether it is tracking smart bin usage via QR codes, reporting illegal dumping sites, or analyzing an organization's ecological footprint, CleanCred digitizes and rewards the entire waste management lifecycle.

✨ Features & Portals

The application architecture is divided into specialized modules and dedicated dashboards to serve various stakeholders effectively:

Feature/Module	Description
Citizen & User Dashboard	Empowers users to log in, view their profiles, and navigate the platform.
Waste & Dumping Reporting	Allows citizens to report standard waste or flag illegal dumping sites with geolocation.
Gamified Rewards Wallet	Incentivizes users by awarding credits for verified green actions, complete with interactive audio and visual confetti feedback.
Live Tracking & Mapping	Real-time monitoring of waste collection routes and worker deployments using map utilities.
Smart QR Integration	Facilitates smart bin usage and quick verification through built-in QR generation and scanning capabilities.
Worker & Institution Portals	Dedicated interfaces for sanitation staff to track tasks, and institutions to manage local sustainability goals.
Admin & Impact Analytics	High-level overviews of system metrics, user engagement, and measurable environmental impact.

🛠️ Technology Stack

CleanCred utilizes a lightweight yet robust stack, prioritizing a smooth UI and rapid deployment:

• Frontend UI: Pure HTML5, enhanced with a modern UI relying on custom styling techniques and responsive layouts.
• Aesthetics: Modern frosted-glass visual effects (glassmorphism.css) and dynamic transitions (animations.css).
• State Management & Logic: Modular Vanilla JavaScript handling global state and core application flow.
• Backend / Server: Python-based server architecture (server.py).

📂 Project Structure

CleanCred/
├── index.html                   # Main entry point
├── server.py                    # Python backend server
├── start.bat                    # Windows startup script
├── css/                         
│   ├── animations.css           # UI transitions and keyframes
│   ├── components.css           # Modular styling for components
│   ├── glassmorphism.css        # Frosted glass UI effects
│   ├── main.css                 # Global stylesheets
│   └── responsive.css           # Mobile/tablet responsiveness
└── js/
    ├── app.js                   # Application initialization    
    ├── state.js                 # Global state management
    ├── components/              # Specialized UI modules (dashboards, portals, reports)
    └── utils/                   # Helpers (audio, confetti, maps, QR code/scanner)

🚀 Installation & Local Setup

To run CleanCred locally on your machine for development or evaluation:

1. Clone the Repository:

   git clone [https://github.com/LeagueStar/CleanCred.git](https://github.com/LeagueStar/CleanCred.git)
   cd CleanCred

2. Launch the Environment:
   • Windows: Execute the provided batch script by double-clicking start.bat or running it from the command line.
   • Manual/Cross-Platform: Run the Python server directly to host the application:

     python server.py

     (Ensure you have Python 3.x installed on your system).
3. Access the Application: Open your preferred web browser and navigate to the local port hosted by the Python server (typically http://localhost:8000 or as defined in the server output).

💡 Usage Workflow

1. Citizens: Log in, scan smart bin QR codes, or snap photos of illegal dumping sites to report them. Track your earned CleanCreds and leaderboard ranking in the Gamified Wallet.
2. Sanitation Workers: Access the Worker Portal to view active tasks, follow optimized collection routes via live tracking, and mark bins or dumping sites as cleared.
3. Institutions & Admins: Use the Admin & Impact Dashboards to monitor city-wide cleanliness, verify user reports, distribute rewards, and analyze sustainability metrics.

🤝 Contributing

This is an exclusive project developed for the Smart India Hackathon (SIH). Outside contributions, pull requests, and forks are currently not permitted to maintain project integrity.

🛡️ License & Copyright

Copyright (c) 2026 Team GreenLegacy. All Rights Reserved.

This project was developed by Team GreenLegacy for the Smart India Hackathon (SIH). This source code is proprietary and confidential. No part of this software, code, or design may be copied, reproduced, distributed, published, or modified, in whole or in part, in any form or by any means, without the prior written, explicit permission of the copyright owners.

Unauthorized copying, cloning, or use of this project is strictly prohibited.

📞 Team GreenLegacy

• Kartik Devdhawala (LeagueStar) - @LeagueStar
• Harshprit Bagga
• Shivansh Prajapati
• Suraj Singh
• Satyam Gupta
• Kreya Patel

Live Website: CleanCred Live