webdev123-tech/ecocycle

EcoCycle — Smart Waste, Clean Cities. A real full-stack PWA waste-management ecosystem for Kampala, Uganda. Aligned with UN SDG 11, 12 & 13. # ♻️ EcoCycle — Smart Waste, Clean Cities A **smart waste-management ecosystem** connecting **citizens, waste collectors and city administrators** on one platform. Installable **Progressive Web App** + a **real Node/SQLite backend**. > Aligned with **UN SDG 11** (Sustainable Cities), **SDG 12** (Responsible Consumption) and > **SDG 13** (Climate Action). Demo context: **Kampala, Uganda** 🇺🇬 This is **not a mockup** — it has a real database, real accounts, real JWT auth, real file uploads, real on-device AI, and real (or sandbox-ready) SMS, email, payments and Google login. See **COMPETITIVE.md** for how it out-competes Yo-Waste, Homeklin and T-Bin. > ### 🌐 Live demo: **ecocycle-gsx4.onrender.com** > Hosted on Render. The first visit may take ~30s to wake (free tier), then it's fast. > Sign in with any demo account below. 📄 A full project report and pitch deck are in `docs/`. --- ## 🚀 Run it ### 1. Start the backend (serves the app **and** the API on one port) ```bash cd /opt/lampp/htdocs/ecocycle/server npm install # first time only node server.js ``` You'll see: `♻️ EcoCycle server running → localhost` ### 2. Open the app ``` localhost ``` ### Install on a phone 📲 Open the **live URL** above (or `http:// :4000/` on the same Wi-Fi) in Chrome → **menu → Install app**. It installs to the home screen, runs full-screen, and works offline (including the AI model). ### Android app (.apk) 🤖 EcoCycle ships as a real Android package built from the PWA (Trusted Web Activity): 1. Go to **pwabuilder.com** and enter the live URL above. 2. **Package For Stores → Android** → keep package id `ug.ecocycle.app` → **Download**. 3. Install the generated `.apk` on any Android phone. The site already serves `/.well-known/assetlinks.json`, so once you paste the package's SHA-256 fingerprint into that file the app runs **full-screen with no browser bar**. --- ## 👤 Accounts **Demo logins** (pre-filled on the sign-in screen — ta …