๐ฟ ReGenX
Smart Circular Bio-Waste Logistics Platform with AI scanning, real-time GPS tracking, and role-based dashboards for Providers, Riders & Processing Plants.






A premium Progressive Web App that digitizes the entire bio-waste supply chain โ from hotel waste generation, through GPS-tracked rider pickup, to verified delivery at processing plants โ all powered by AI and rewarded with blockchain tokens.
โจ Features
๐ค AI-Powered Bio Scanner
Real-time waste image analysis using TensorFlow.js + MobileNet
Contamination detection and organic percentage scoring
Auto-fills dispatch form fields based on scan results
Supports live camera capture and file upload
๐ Real-Time GPS & Mapping
High-accuracy GPS detection with draggable pin refinement
Address-based geocoding via Nominatim / OpenStreetMap
50km service radius enforcement for route eligibility
Live rider tracking with Leaflet.js interactive maps
๐ฅ Role-Based Dashboards
Role | Capabilities |
|---|---|
๐จ Provider (Hotel/Hostel) | Create dispatch requests, scan waste, track active pickups, view analytics |
๐ Rider | Accept routes, navigate to pickup, confirm collection with AI scan |
โ๏ธ Plant | Monitor incoming waste flow, confirm receipt, log processed output |
๐ช $RGX Token Economy
Providers earn $RGX tokens on every verified pickup
Trade tokens on the ReGen DeFi Exchange (CSR NFTs, Smart Bin Hardware, Energy Vouchers)
Stake tokens in the Carbon Credit Fund (12.5% APY)
Contribute to the Amazon Reforestation Initiative crowdfund
๐ Impact & Analytics
COโ offset calculator (per completed dispatch)
Weekly/Monthly waste history with Chart.js bar charts
Regional Leaderboard (top waste diverters in your area)
AI-predicted waste volume for next day
The Green Wall โ live community sustainability activity feed
๐จ Premium UI/UX
Glassmorphism design with dark/light theme toggle
Live ticker bar with real-time platform activity
Smooth micro-animations and transitions
Fully responsive โ mobile-first PWA with offline support
Space Grotesk + Inter typography
๐ ๏ธ Tech Stack
Layer | Technology |
|---|---|
Structure | HTML5 (Semantic) |
Styling | Vanilla CSS3 (Glassmorphism, CSS Variables) |
Logic | Vanilla JavaScript (ES6 Modules) |
AI / ML | TensorFlow.js, MobileNet |
Maps | Leaflet.js, OpenStreetMap, Nominatim |
Charts | Chart.js |
PWA | Service Worker, Web App Manifest |
Weather | Open-Meteo API |
Storage | LocalStorage (demo-ready, no backend needed) |
๐ Getting Started
Prerequisites
Node.js (for local dev server)
A modern browser (Chrome / Edge recommended for camera access)
Run Locally
# Clone the repository
git clone https://github.com/your-username/ReGenX.git
cd ReGenX
# Install dependencies
npm install
# Start development server
npm run serve
Then open
http://localhost:8080 in your browser.First-Time Setup
Click Register and choose your role (Provider / Rider / Plant)
Set your location via GPS or address search
Login and explore your role-specific dashboard
Tip: Register at least one Provider and one Rider to simulate a full pickup flow!
๐ฆ Deployment (Appwrite Sites)
Copy
.env.example to .envFill in your Appwrite credentials:
APPWRITE_ENDPOINT=https://cloud.appwrite.io/v1
APPWRITE_PROJECT_ID=your-project-id
APPWRITE_API_KEY=your-private-api-key
Deploy:
npm run deploy:appwrite
โ ๏ธ Never expose your Appwrite API key in frontend code.
The deploy script will:
Create the Appwrite Site if it doesn't exist
Upload the static project as a new deployment
Wait for build completion and auto-activate
๐ Project Structure
ReGenX/
โโโ .github/ # GSSoC Issue and PR templates
โโโ scripts/ # Deployment scripts
โ โโโ appwrite-deploy.mjs # Appwrite automatic site deployment
โโโ src/
โ โโโ app.js # Core application logic (all roles)
โ โโโ esg-reporter.js # ESG compliance and PDF report generator
โ โโโ intelligence.js # Core data metrics computation layer
โ โโโ scanner.js # BioScanner AI module configuration
โ โโโ styles.css # Global premium design system & components
โ โโโ trust.js # Fraud prevention and token mechanics
โ โโโ vision-scanner.js # TensorFlow.js camera asset model loader
โ โโโ yield-optimizer.js # AI processing yield configuration tool
โโโ .env.example # Environment variable template
โโโ .gitignore # Git tracked-file exemptions
โโโ appwrite.config.example.json
โโโ index.html # App shell & login UI
โโโ manifest.json # PWA mobile layout configuration
โโโ package-lock.json
โโโ package.json # Build configuration and scripts
โโโ push.bat # Automated local utility execution script
โโโ README.md # Project documentation
โโโ service-worker.js # Offline caching and performance optimization
๐ Pickup Workflow
Provider creates dispatch request
โ
(Optional) BioScan AI verifies waste quality
โ
Request appears on Rider's job board
โ
Rider accepts โ navigates to pickup location
โ
Rider confirms collection (actual kg + AI scan)
โ
Rider marks "Arrived at Plant"
โ
Plant confirms receipt โ order COMPLETED
โ
Provider earns $RGX tokens ๐ช
๐ฑ Environmental Impact
Every completed dispatch through ReGenX:
Diverts bio-waste from landfills
Calculates COโ offset (0.62 kg COโ per kg bio-waste)
Mints verifiable $RGX carbon credits
Contributes to the global Green Wall feed
๐ธ Screenshots
Coming soon โ deploy and capture your dashboard!
๐ค Contributing
Pull requests are welcome! For major changes, please open an issue first to discuss what you'd like to change.
๐ License
This project is open source. See LICENSE for details.
Made with ๐ for a cleaner planet ยท ReGenX ยท Closing the loop on bio-waste
0 likes ยท 9 views ยท Jun 15, 2026
A platform for circular bio-waste logistics using AI and GPS.