$ cat ~/projects/leaksafe

LeakSAFE – Smart Gas Leakage Detection System

A cross-platform mobile application integrated with ESP32 hardware sensors to deliver real-time atmospheric gas tracking, dynamic threat analysis, and automated hazardous alerts.

ROLE Lead Developer & Hardware Integrator
MOBILE FRONTEND Flutter, Dart, fl_chart
BACKEND & DATA Firebase Auth, Realtime Database
HARDWARE ESP32, MQ Gas Sensors
MAPPING & LOCATION Google Maps, Geolocator
PROJECT SCOPE Computer Science Capstone Engineering
$ cat metrics.log

At A Glance

8+ Application Screens
4 Core Services
6 Data Visualizations
3 Platform Targets
$ tree ~/projects/leaksafe

System Data Flow

ESP32 + MQ Sensors

Calibrated gas sensor modules continuously sample atmospheric PPM concentrations. Firmware on GitHub →

Firebase Realtime DB

Telemetry streams to Firebase for live synchronization and historical persistence.

Flutter Application

Cross-platform app renders real-time PPM readings with dynamic threshold UI states.

Alert & Notification

Local push notifications trigger instantly upon detecting elevated PPM thresholds.

$ cat features.md

Key Features

Real-Time Monitoring

Continuously tracks atmospheric gas concentrations with visual Safe/Moderate/Danger UI color state transitions.

Live Sensor Mapping

Google Maps integration pinpoints sensor locations geographically for precise leak origin identification.

Historical Analytics

Bar and line charts visualize historical PPM readings to identify frequency patterns and temporal safety trends.

Instant Alerts

Local push notifications and dynamic threshold triggers notify users immediately when gas levels become hazardous.

User Authentication

Firebase Auth secures user accounts, ensuring only authorized individuals access telemetry data and settings.

Customizable Thresholds

Users can configure alert thresholds in settings, tailoring safety responses to their specific environment requirements.

$ cat mechanics.md

System Mechanics

$ ls ~/stack/

Tools & Technologies

Frontend

Flutter Dart Figma fl_chart Google Maps Flutter

Backend & Data

Firebase Auth Firebase Realtime DB Geolocator

Hardware

ESP32 MQ Gas Sensors C++ (Embedded)

Tooling

Git Firebase Console Prototyping
$ tail -f lessons.log

Challenges & Solutions

HARDWARE-APP SYNC

Real-Time Telemetry Pipeline

Challenge: Ensuring low-latency data delivery from physical ESP32 sensor nodes to the mobile application without data loss or visual lag.

Solution: Implemented Firebase Realtime Database as the synchronization layer, enabling instantaneous streamed updates from hardware to app while maintaining historical persistence for analytics.

USER SAFETY

Threshold Calibration Accuracy

Challenge: Distinguishing normal atmospheric variations from dangerous PPM levels while avoiding false alarms that undermine user trust.

Solution: Designed dynamic threshold triggers with configurable user settings, combined with visual UI state transitions from Safe (green) to Danger (red) for rapid, intuitive threat assessment.

CROSS-PLATFORM

Unified Mobile Experience

Challenge: Delivering a consistent, feature-rich experience across both iOS and Android with native-level performance from a single codebase.

Solution: Leveraged Flutter's cross-platform framework with platform-adaptive plugins for geolocation, maps, and local notifications to ensure seamless parity across devices.

$ ls ~/screens/

Application Screenshots

Interested in the full implementation?

Explore the complete source code on GitHub — including the Flutter mobile application and the ESP32 Arduino hardware firmware.