A real-time water-tank monitoring & dispatch platform
Digital logistics and automatic control for municipal water tanks.
- About
- Features
- Screenshots
- Quick Start
- Directory Overview
- Contributing
- License
- Contact & Acknowledgements
Water shortages are worsening in many Pakistani cities. Households often rely on private tankers booked by phone and logged in paper registers. The process is slow, opaque and error-prone.
Quench Thirst replaces manual ledgers with a real-time web system that:
- measures tank levels with IoT sensors
- auto-dispatches tanker routes through an Express API
- gives residents and municipal teams a live dashboard
The stack is familiar—Node.js | Express | MongoDB | React—so local devs can extend it without steep learning curves.
- Live tank-level charts with 5-second polling
- Automatic SMS / WhatsApp alerts when levels fall below a threshold
- One-click tanker dispatch; optimal routes via Google Maps API
- Role-based access (Resident, Driver, Admin)
- Audit log of deliveries and complaints
- PWA install for offline-first field use
- UI inspired by Google Keep—clean panels, soft shadows
- See the detailed repository on GitIngest:
GitIngest - Quench Thirst
| View | Preview |
|---|---|
| Login Page |  |
| Admin Dashboard |  |
| User Dashboard |  |
| Employee Dashboard |  |
| Sales Tracking |  |
| Order Management |  |
(PNG assets live under ./assets/)
| Tool | Version |
|---|---|
| Node.js | ≥ 18 LTS |
| MongoDB | ≥ 6.0 |
| Yarn | ≥ 1.22 |
git clone https://github.com/your-org/quench-thirst.git
cd quench-thirst
cp .env.example .env # add your keys
yarn && yarn bootstrap # install root + workspace depsFork ➜ Create branch ➜ Commit ➜ Pull request- Follow the ESLint/Prettier rules (yarn lint --fix).
- Small, focused PRs are easier to review. Questions? Open a draft PR early.
Distributed under the MIT License. See LICENSE for details.
Maintainers:
- Abdul Ahad · @AbdulAHAD968
- Team Quench Thirst, Islamabad