Product guide
WizDash is a phone interface for the ESP32. You arrange a dashboard on the phone, match JSON keys to values in your firmware, and generate an Arduino sketch for the connection that project uses. There is no WizDash account. The project stays on the phone.

Where each connection fits
Section titled “Where each connection fits”- BLE is for close range. The phone needs to stay within Bluetooth range of the board.
- WiFi requires the phone and the ESP32 to be on the same local network. They connect over a WebSocket.
- MQTT uses your own MQTT broker. A remote connection works only when the phone, the board, and the broker can all reach one another.
WizDash has to stay running and connected. WizDash does not provide cloud alerts that are guaranteed to arrive after the app is backgrounded or closed by the system.
The full path
Section titled “The full path”- Create a project. The free version allows one.
- Choose a connection. Open Connection Settings from the project menu and select BLE, WiFi, or MQTT. Fill in what that mode asks for. A project uses one connection at a time. Changing it unbinds the device.


- Arrange the dashboard. Choose Enter Dashboard. If nothing is bound yet, the app opens No Device Bound. Choose Not flashed yet, design dashboard first to lay out widgets. I’ve flashed firmware, connect device is for a board that is already running the sketch. Adding, dragging, and resizing happen in Edit Layout. After a device is bound, the dashboard opens outside Edit Layout; turn it on before changing the layout. Double-tap a widget to set its title and JSON key. The key must match the name in firmware exactly, including case.


- Generate the sketch and flash it. Choose Generate Arduino Code. Check the pins and the connection values, then flash the sketch with the Arduino IDE.
- Bind the device. BLE and WiFi can find the board only after the sketch is flashed and the board is running. MQTT binding is completed when the phone connects to your broker.
- Use the dashboard. The board reports its readings as one JSON object. When you use a control, the app sends
{"key": value}.

