Skip to content

leogmendoza/quenchtessential

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

158 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🌱Quenchtessential: IoT Plant Watering and Monitoring

Water quenches the thirst of plants, thus it is quintessential.

🧐 What?

Quenchtessential is an ESP32-based IoT solution built to automatically water my houseplant while monitoring its health through a full-stack dashboard app!

😱 Why?

Life is busy as an eng student, so I don't want my plant to feel neglected.. Also, I was inspired by my previous company Xandar Kardian and their vital sign sensor hardware + remote patient monitoring software solution and have been meaning to clone it mwuahahahaaah😈

⭐ Features

  • Automated Watering:
    Uses an FSM to pump water and feed the plant when the moisture sensor says it meets the "thirsty threshold"

  • Live Health Monitoring:
    Displays real-time and historical moisture data on a modern web dashboard for trend visualization

  • WiFi-enabled:
    Connects to a network (w/o hardcoding credentials) using a captive portal and talks to the backend via MQTT

  • Plug-and-Play:
    Deployed & cloud-hosted full-stack app and wall-powered, so no local setup needed--as if it was a real product!

⚙️ System Architecture

Block Diagram

Tech Stack

  • Microcontroller: ESP32 (C++ on PlatformIO w/ FreeRTOS)
  • Backend: Node.js + Express (REST API)
  • Frontend: React + Chart.js (data visualization)
  • Database: PostgreSQL (hosted on Supabase)
  • Protocols: MQTT (sensor data), HTTP (dashboard)
  • Hosting: GitHub Pages (frontend), Render (backend)
  • CI/CD: Docker (backend containerization), GitHub Actions (build/deploy)

Circuit Components

  • ESP32 Dev Board
  • Capacitive Soil Moisture Sensor
  • 5V Relay Module
  • 5V Water Pump
  • 9V Breadboard Power Supply

📸 Demos

Pumping Test

WiFi Setup

Overview Video

Overview Video

Pumping Demo Video

Pumping Demo Video

GitHub Actions Workflows

Frontend Deployment

ESP32 Build

Backend Build

Call the Backend API yourself!:

Resources/Inspo

About

Built an automatic plant watering & monitoring system!

Resources

Stars

Watchers

Forks

Contributors