web-ui

Configure an ESP32 pool controller web UI with LittleFS assets and REST API endpoints.

25|7|Updated Mar 4, 2019
One-click install
npx skills add https://github.com/smart-swimmingpool/pool-controller --skill web-ui-smart-swimmingpool
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: web-ui
Source: https://github.com/smart-swimmingpool/pool-controller/tree/main/.opencode/skills/web-ui
Command: npx skills add https://github.com/smart-swimmingpool/pool-controller --skill web-ui-smart-swimmingpool

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides a two-layer web dashboard and REST API tooling for the ESP32 pool controller, enabling live monitoring and configuration without frequent firmware rebuilds.

Core Features & Use Cases

  • Two-layer architecture with LittleFS editable assets and PROGMEM fallback for offline reliability.
  • REST API endpoints for status, config, login, and OTA updates to support scriptable interactions and Home Assistant/openHAB integrations.
  • Development workflow that separates frontend assets from firmware logic, enabling rapid UI iteration and OTA-ready deployments.

Quick Start

Edit the web assets under data/web to customize the UI, then upload with PlatformIO to push changes to LittleFS and test via the device's REST API.

Frequently Asked Questions about web-ui

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build a web UI dashboard for an ESP32 pool controller?

To build a web UI dashboard for an ESP32 pool controller, use a two-layer architecture with LittleFS for editable assets and PROGMEM fallback for offline reliability. This setup enables live monitoring and configuration without frequent firmware rebuilds.

What is the best way to update ESP32 web interface assets without reflashing firmware?

Updating ESP32 web interface assets without reflashing firmware is done by editing files under data/web and using the uploadfs workflow via PlatformIO. This pushes changes directly to LittleFS, enabling rapid UI iteration and OTA-ready deployments.

Can I integrate Home Assistant with an ESP32 controller using a REST API?

Yes, you can integrate Home Assistant with an ESP32 controller using the provided REST API endpoints. These endpoints support status checks, configuration, login, and OTA updates, facilitating scriptable interactions and seamless openHAB or Home Assistant integrations.

Does the ESP32 pool controller web UI work offline if LittleFS fails?

The ESP32 pool controller web UI works offline if LittleFS fails because it uses a robust PROGMEM fallback architecture. This two-layer design ensures the firmware-backed fallback provides continuous reliability even when editable LittleFS assets are unavailable.

How do I separate frontend web assets from ESP32 firmware logic during development?

To separate frontend web assets from ESP32 firmware logic during development, maintain files within the data/web directory and deploy them using the uploadfs workflow. This workflow isolates UI assets from firmware logic to enable rapid iteration and OTA-ready deployments.