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.
- 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
- 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 | 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 |
- 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
- 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
- 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
| 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) |
- Node.js (for local dev server)
- A modern browser (Chrome / Edge recommended for camera access)
# Clone the repository
git clone https://github.com/your-username/ReGenX.git
cd ReGenX
# Install dependencies
npm install
# Start development server
npm run serveThen open http://localhost:8080 in your browser.
- 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!
- Copy
.env.exampleto.env - Fill 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
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
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 🪙
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
Coming soon — deploy and capture your dashboard!
Pull requests are welcome! For major changes, please open an issue first to discuss what you'd like to change.
This project is open source. See LICENSE for details.
Made with 💚 for a cleaner planet · ReGenX · Closing the loop on bio-waste