ronaldgosso/gas-detector-api

An end-to-end IoT gas detection and monitoring system integrating Arduino hardware, Flutter mobile intelligence, and a Node.js cloud backend with SMS alerting for Tanzania. This system provides real-time gas detection, edge intelligence processing, cloud analytics, and automated emergency SMS alerts — designed for homes, laboratories. # 🔥 Gas Monitoring Arduino Based Project An end-to-end IoT gas detection and monitoring system integrating **Arduino hardware**, **Flutter mobile intelligence**, and a **Node.js cloud backend** with SMS alerting for Tanzania. This system provides **real-time gas detection**, **edge intelligence processing**, **cloud analytics**, and **automated emergency SMS alerts** — designed for homes, laboratories, and industrial environments. --- --- ## 🌐 Live Demo **Web Dashboard:** Web Dashboard View: - Real-time gas levels - Historical data analytics - System status - Emergency contacts **API Documentation (Postman):** Postman Link --- --- # ✨ Key Features ## 📱 Mobile App (Flutter) - Animated real-time charts - Edge intelligence (avg > 800 PPM transmission logic) - Offline resilience - Exponential retry queue - Tanzania optimized (+255 validation) - Dark & Light themes --- ## 💻 Web Dashboard - Live gas monitoring charts - Daily & monthly analytics - Emergency contact management - Bluetooth status monitoring - Export functionality (JSON, CSV, PDF) - Fully responsive UI --- ## ⚙️ Backend API (Node.js) - RESTful endpoints - SMS alerts via NextSMS Tanzania - 30-second SMS cooldown - Secure Aiven MySQL cloud database - SSL/TLS encrypted connections - Bluetooth connection tracking --- ## 📡 Hardware Integration - MQ-2 detects LPG, smoke, methane - 0–1023 PPM sensitivity range - HC-05 Bluetooth (10m range) - Local buzzer & LED alerts - Battery backup support --- # 🛠️ Hardware Requirements | Component | Specification | Qty | |-----------|--------------|-----| | Arduino UNO | ATmega328P | 1 | | MQ-2 Gas Sensor | LPG/Smoke/Methane | 1 | | HC-05 Bluetooth | Master/Slave | 1 | | Active Buzzer | 5V | 1 | | Resistors | 220Ω, 1kΩ, 2kΩ | 4 | | Breadboard | Full-size | 1 | | Jumper Wires | Male/Female | 20 | --- # 🧠 Smart Logic Design ## Edge Intelligence Instead of sending every sensor reading: - Flutter calculate …