RisalDash

Install

Arduino IDE — Library Manager → search "RisalDash".

PlatformIO — platformio.ini:

lib_deps =
    RisalDash
    esp32async/ESPAsyncWebServer
    esp32async/AsyncTCP        ; ESP32
  ; esp32async/ESPAsyncTCP    ; ESP8266

Fake sensors — build with no hardware

Prototype and debug the whole dashboard with nothing plugged in. #include <RisalFake.h> gives you realistic drifting readings — a slow trend + wobble + a little noise, not a flat sine — so the UI looks live while you iterate on layout and logic.

#include <RisalFake.h>
RisalFakeEnv env;                 // temperature / humidity / pressure / soil / air quality

void setup() { env.begin(); /* ...declare widgets bound to temp/hum/... ... */ }
void loop() {
  env.update();
  temp = env.temperature();       // °C   — later: aht.readTemperature()
  hum  = env.humidity();          // %
  pres = env.pressure();          // hPa
  dash.update();
}

Need one value of any other quantity? RisalFake(center, amp, noise):

RisalFake volts(12.4, 0.3, 0.05);   // 12.4 V, ±0.3 drift, a little jitter
voltage = volts.read();

When the real sensor arrives, swap the reads for your driver's — same variable names, the rest of the sketch is unchanged. Opt-in and Zero-Waste: nothing is compiled unless you include it. Works on ESP8266 and ESP32. The ESP32-C6-LCD-1.47 example ships with it.

Examples

• Minimal — a few widgets over an access point.
• FirstBoot — captive-portal Wi-Fi provisioning (signal levels, timezone), then your network.
• Layouts — multi-page dashboard with the swipe-up page switcher + accent()/timezone().
• AllWidgets — every widget type, grouped by purpose, plus a sensor preset.

Integrations & control

dash.enableMCP("risal_pat_token");   // GET /api/mcp/manifest → AI tools (see tools/risal-mcp-bridge)
dash.enableOTA();                    // GET/POST /update → firmware update over the air
dash.mqtt("broker.local", 1883, "greenhouse");  // needs -D RISAL_ENABLE_MQTT + PubSubClient
dash.enableHomeAssistant("greenhouse");          // Home Assistant MQTT auto-discovery (after mqtt())

MCP — enableMCP(token) exposes GET /api/mcp/manifest, turning every widget into an AI tool (read sensors, drive controls). The companion risal-dash-mcp bridge connects a device to Claude Desktop / Claude Code. 📝 Walkthrough: Control your ESP32 from an AI agent.

Home Assistant — after mqtt(), enableHomeAssistant() publishes MQTT discovery configs so HA auto-creates entities (sensors, switches, numbers, binary sensors, buttons), all grouped under one device. No YAML.

Wi-Fi: first boot vs. fixed credentials

dash.begin();                          // saved creds → STA; otherwise captive setup portal
dash.begin("ssid", "password");        // connect to this network (falls back to the portal)
dash.beginAP("Greenhouse", "12345678");// plain dashboard over its own access point
dash.apName("Greenhouse-Setup");       // name of the captive-portal AP (optional)

On first boot the device appears as a RisalDash-Setup Wi-Fi. Connect to it — the setup page opens automatically (captive portal). Pick your network, enter the password; the device reboots and serves the dashboard on your Wi-Fi.