Helloesp

Abstract

1. Introduction

The ESP32 holds a persistent outbound WebSocket to a Cloudflare Worker. When a browser hits helloesp.com, the Worker relays the request over that socket and streams the response back. The ESP never accepts an inbound TCP connection from the internet, only from the LAN.

Without the Worker, the site still runs on LAN via mDNS at http://helloesp.local.

A public website running entirely on a single ESP32 with 520 KB of RAM. Every page, every sensor reading, every guestbook entry is served by the microcontroller itself. There is no backend server.

2. Objective

A public website hosted on an ESP32.

This project demonstrates how HTML, Arduino, ESP32 can be applied to a real-world Internet of Things (IoT) problem.

3. Key Features / Modules

• Live dashboard: 12 sensor/system metrics, trend arrows, degraded-sensor indicators
• Real-time SSE updates (push every 15s from the device), with graceful fallback to 30s polling
• Live connection indicator (pulsing green dot) and a "Right now" request ticker on the homepage
• Historical CSV charts with day/week/month switcher; weekly/monthly/yearly aggregate archives
• Hall of Fame (lifetime extremes: peak CO₂, temp range, busiest day, longest uptime) and year-over-year monthly visitor deltas on /history
• Visitor country map, request-rate chart, changelog, photo carousel
• /console live feed: last 50 public requests with country flags, updated instantly via SSE
• Outdoor weather + air quality context (via Cloudflare Worker proxy to Open-Meteo): conditions with day/night-aware icons, feels-like, dewpoint, wind direction, pressure trend, AQI + PM2.5, atmospheric CO₂, UV index
• Guestbook with two-level reply threading, tombstone deletes, moderation queue, inline AI translation, rate limiting
• Dark mode, responsive, SRI-pinned CDN scripts, no tracking

4. Technology Stack

5. System Requirements

General requirements for this technology stack — check the README for exact versions.

• A modern web browser
• VS Code or any code editor
• Git (to clone the repository)

6. Installation & Setup

git clone https://github.com/Tech1k/helloesp.git
cd helloesp

Full setup instructions are in the project README.

7. Future Enhancements

Suggested extensions you can add to make this your own project.

• Add a mobile dashboard using Blynk or Firebase
• Store readings in a cloud database for history charts
• Add alerts via SMS / Telegram when thresholds are crossed

8. Viva / Review Questions

Common questions examiners ask for projects in this domain.

1. Which microcontroller / board and sensors are used and why?
2. How does the device send data (Wi-Fi, MQTT, HTTP, Bluetooth)?
3. Where is the sensor data stored and visualised?
4. How is power consumption managed?
5. How would you secure the device and its communication?

9. Source Code & License

This project is developed by Tech1k and published on GitHub under the MIT License. Please follow the license terms and credit the original author when you use or modify this code.