Thanks to visit codestin.com
Credit goes to github.com

Skip to content
Β 
Β 

Latest commit

Β 

History

79 Commits

Folders and files

NameName
Last commit message
Last commit date
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🌍 CleanCred

Verified Waste Action & Green Credits Platform

Smart India Hackathon 2026 Β· Problem Statement SIH26195 Β· Team GreenLegacy (ID: GSIH26015) Theme: Clean & Green Technology Β· Category: Software

Live Demo SIH 2026 License

🌐 Live Website Β· ✨ Features Β· βš™οΈ How It Works Β· πŸ› οΈ Tech Stack Β· πŸš€ Setup Β· πŸ‘₯ Team


πŸ“– About

CleanCred is a proof-backed waste management and collection platform built for Smart India Hackathon 2026. Instead of rewarding citizens for simply reporting waste, CleanCred only issues Green Credits once an action is independently verified β€” turning municipal waste tracking into a closed-loop, auditable system.

Every claimed action is checked against multiple independent signals before a credit is minted, which means the credit ledger reflects real, confirmed cleanup activity rather than self-reported claims. This gives municipalities a trustworthy dataset for monitoring, accountability, and planning β€” while giving citizens a transparent, gamified reason to participate.

Report β†’ Verify β†’ Collect β†’ Record β†’ Earn

🚨 The Problem

Most civic waste-reporting apps stop at "report" β€” a citizen submits a complaint or photo, and there's no reliable way to confirm the waste was actually segregated, collected, or resolved. This creates:

  • Reward systems that can be gamed with fake or duplicate submissions
  • No verifiable link between a citizen's claimed action and the outcome on the ground
  • Municipalities with reporting data but no confidence in its accuracy

πŸ’‘ Our Solution

CleanCred closes that gap with multi-signal verification β€” a claim only becomes a credit once it clears every checkpoint in the pipeline:

Signal What It Confirms
πŸ€– AI Segregation Check Whether the submitted waste is properly segregated
πŸ“ GPS Proximity That the citizen was actually at the reported location
⏱️ Timestamp Verification That the action happened when it was claimed to
πŸ”³ QR-Based Collection Sanitation staff confirm physical collection at source

Why It's Different

  • Proof-backed action β€” every credit is tied to verifiable evidence, not a self-report
  • Multi-signal verification β€” AI + GPS + QR + timestamp working together, not any single check alone
  • Closed-loop accountability β€” a full Report β†’ Verify β†’ Collect β†’ Record cycle, not a one-way complaint box
  • Behaviour-linked rewards β€” credits are issued after verification, never merely for submitting
  • Municipal visibility β€” the same verified event doubles as clean data for monitoring and analytics

✨ Features & Portals

CleanCred is a multi-portal ecosystem, with a dedicated experience for every stakeholder in the waste-management lifecycle:

Portal / Module Description
πŸ§‘β€πŸ€β€πŸ§‘ Citizen Dashboard Login, profile, and a central home to track activity and impact
πŸ“ Waste & Dumping Reporting Report standard waste or flag illegal dumping sites with geolocation
🎁 Rewards Wallet Verified green actions earn Green Credits, with confetti + audio feedback
πŸ† Leaderboard Community rankings that drive friendly competition and engagement
πŸ—ΊοΈ Live Tracking & Mapping Real-time view of collection routes and worker deployment
πŸ”³ Smart QR Integration QR generation and in-browser scanning for smart-bin and collection verification
🧹 Worker Portal Sanitation staff view assigned tasks and mark bins/sites as cleared
🏒 Institution Portal Institutions manage local sustainability goals and participation
πŸ“Š Admin & Impact Analytics System-wide metrics, verified-report oversight, and environmental impact tracking

βš™οΈ How It Works

   β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”     β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”     β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”     β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”     β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
   β”‚  1. REPORT β”‚ ──▢ β”‚  2. VERIFY  β”‚ ──▢ β”‚ 3. COLLECT β”‚ ──▢ β”‚ 4. RECORD  β”‚ ──▢ β”‚ 5. EARN  β”‚
   β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜     β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜     β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜     β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜     β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
   Citizen submits     AI + GPS +          Sanitation staff    Verified event      Green Credits
   evidence of a       Timestamp check     confirm pickup      logged for city-    minted to the
   segregated/         the claim           via QR scan         wide analytics      citizen's wallet
   disposed action
  1. Report β€” A citizen submits evidence (photo + location) of waste segregation, disposal, or an illegal dumping site.
  2. Verify β€” The system checks AI-based segregation quality, GPS proximity to the reported site, and timestamp authenticity.
  3. Collect β€” A waste collector arrives and confirms pickup by scanning a QR code, closing the loop physically.
  4. Record β€” The verified event is logged into city-wide monitoring and impact-analytics dashboards.
  5. Earn β€” Only now are Green Credits issued to the citizen's Rewards Wallet.

πŸ› οΈ Technology Stack

CleanCred uses a lightweight, dependency-light stack chosen for a smooth UI and rapid, judge-friendly deployment:

Layer Technology
Structure Semantic HTML5
Styling Tailwind CSS (utility layer) + custom main.css, components.css, animations.css, responsive.css
Application Logic Modular Vanilla JavaScript β€” a lightweight client-side router and global state manager
Interactivity Custom utilities for QR generation/scanning, live-map rendering, confetti, and audio feedback
Backend / Local Server Python (server.py) β€” a zero-dependency HTTP server for local hosting and API endpoints
Deployment Static hosting via GitHub Pages

πŸ“‚ Project Structure

CleanCred/
β”œβ”€β”€ index.html                  # Main entry point & app shell
β”œβ”€β”€ server.py                   # Python local dev / API server
β”œβ”€β”€ start.bat                   # Windows one-click startup script
β”œβ”€β”€ css/
β”‚   β”œβ”€β”€ main.css                 # Global styles & design tokens
β”‚   β”œβ”€β”€ components.css           # Component-level styling
β”‚   β”œβ”€β”€ animations.css           # Transitions & keyframes
β”‚   └── responsive.css           # Mobile / tablet responsiveness
└── js/
    β”œβ”€β”€ app.js                   # App router & controller
    β”œβ”€β”€ state.js                 # Global state management
    β”œβ”€β”€ components/               # One module per portal/view
    β”‚   β”œβ”€β”€ dashboard.js              # Citizen dashboard
    β”‚   β”œβ”€β”€ reportWaste.js            # Waste reporting flow
    β”‚   β”œβ”€β”€ illegalDumping.js         # Illegal dumping reports
    β”‚   β”œβ”€β”€ rewardsWallet.js          # Green Credits wallet
    β”‚   β”œβ”€β”€ leaderboard.js            # Community leaderboard
    β”‚   β”œβ”€β”€ liveTracking.js           # Live collection map
    β”‚   β”œβ”€β”€ workerPortal.js           # Sanitation worker portal
    β”‚   β”œβ”€β”€ institutionPortal.js      # Institution portal
    β”‚   β”œβ”€β”€ adminDashboard.js         # Admin controls
    β”‚   β”œβ”€β”€ impactDashboard.js        # Analytics & impact
    β”‚   β”œβ”€β”€ profile.js                # User profile
    β”‚   └── landing.js                # Landing page
    └── utils/                     # Shared helpers
        β”œβ”€β”€ qrCode.js                  # QR code generation
        β”œβ”€β”€ qrScanner.js               # In-browser QR scanning
        β”œβ”€β”€ mapHelper.js               # Map rendering utilities
        β”œβ”€β”€ confetti.js                # Reward celebration effects
        β”œβ”€β”€ audio.js                   # Sound feedback
        └── formatters.js              # Shared formatting helpers

πŸš€ Installation & Local Setup

Prerequisites: Python 3.x installed on your system.

  1. Clone the repository

    git clone https://github.com/LeagueStar/CleanCred.git
    cd CleanCred
  2. Launch the server

    • Windows β€” double-click start.bat, or run it from the command line
    • macOS / Linux / manual β€”
      python3 server.py
  3. Open the app

    Navigate to http://localhost:8081 (or the port printed in the server output).

No build step, no package manager, no external services required β€” clone and run.

🧭 Usage Workflow

Role What They Do
Citizens Log in, report waste or dumping sites with photo evidence, and track Green Credits and leaderboard rank in the Rewards Wallet
Sanitation Workers Open the Worker Portal to view assigned tasks, follow live collection routes, and confirm pickup via QR scan
Institutions Manage local sustainability goals and monitor participation from the Institution Portal
Admins Use the Admin & Impact Dashboards to verify reports, oversee credit distribution, and analyze city-wide environmental impact

πŸ—ΊοΈ Roadmap

  • Live backend integration for persistent credit ledger and user accounts
  • Production AI model for automated segregation-quality scoring
  • Municipal-grade analytics exports for civic bodies
  • Native mobile app for on-the-go citizen reporting

🀝 Contributing

This project was developed exclusively for the Smart India Hackathon 2026. Outside contributions, pull requests, and forks are not accepted, in order to preserve the integrity of the submission.

πŸ›‘οΈ License & Copyright

Copyright Β© 2026 Team GreenLegacy. All Rights Reserved.

This project was developed by Team GreenLegacy for the Smart India Hackathon (SIH) 2026. 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

Member GitHub
Kartik Devdhawala @LeagueStar
Harshprit Bagga β€”
Shivansh Prajapati β€”
Suraj Singh β€”
Satyam Gupta β€”
Kreya Patel β€”

🌐 Live Website Β· Built with πŸ’š for a cleaner tomorrow

About

CleanCred: An intelligent, gamified waste management and tracking platform designed to incentivize environmental cleanliness and accountability.

Topics

Resources

Security policy

Stars

2 stars

Watchers

0 watching

Forks

Used by

Contributors

Languages