Skip to content
Quick start Product guide

Dashboard widgets

Choose Enter Dashboard to open the project. If no device is bound, the app shows No Device Bound first. Not flashed yet, design dashboard first opens the canvas and turns on Edit Layout. After a device is bound, turn on Edit Layout before adding, dragging, resizing, or tapping the wallpaper icon on the top toolbar to change the canvas background color or image. Widgets do not overlap. Double-tap a widget to change its title, color, JSON key, and the range or options that belong to it. After the project is connected, display widgets update live and controls can be used.

BLE, WiFi, and MQTT share one format. The board places every reading in a single JSON object, and the app updates the widget with the matching key. When you use a control, the app sends {"key": value}.

WizDash Add Widget picker sheet showing Control, Display, and Layout category tabs and the 8 / 10 free widget quota
Step 1 — Add Widget: tap ”+” in Edit Layout to browse Control, Display, and Layout widgets and check your quota.
WizDash Edit Layout mode showing the top toolbar, grid snap lines, resize handles, and settings gear buttons
Step 2 — Arrange & Resize: turn on grid snapping to drag and resize widgets, or change the canvas background.
WizDash widget settings dialog showing label name, JSON key (co2), and color selection
Step 3 — Set JSON Key: double-tap a widget or tap its gear icon to edit the title, case-sensitive JSON key, and color.

Each widget type holds at most 20. Input Send and Numeric Input share one set of 20. Level and Level Slider share another.

On the free version, a project holds 10 functional widgets. Icon and Spacer are not counted. Text Label and Image are counted. A project that is already over the allowance still opens and works. It cannot gain another functional widget.


The app sends these values to the board when you interact with widgets on your phone.

Button widget preview

Button Command Button

App ➔ Board
JSON{"pump_cmd": 1}

Tap to dispatch your configured command. Numbers are sent as numeric values, others as text strings.

Switch widget preview

Switch Toggle Switch

Two-Way Sync
JSON{"fan_sw": 1}

Sends on or off commands (defaults 1 and 0). If the board returns 1 or true on the same key, it syncs to ON.

Slider widget preview

Slider Linear Slider

App ➔ Board
JSON{"pwm_val": 75}

Sends an integer from 0 to 100. Supports horizontal or vertical orientation, step sizes 1, 5, 10, 20, 25, 50, or continuous.

Level Slider widget preview

Level Slider Touch Bar

App ➔ Board
JSON{"target_lvl": 68}

Large-touch draggable level bar sending numbers between min and max. Can wait until release before sending.

Input Send widget preview

Input Send Text Input

App ➔ Board
JSON{"serial_cmd": "CALIB_ZERO"}

Type text strings and tap send to dispatch to the board. Great for custom commands, device names, or serial commands.

Numeric Input widget preview

Numeric Input Number Stepper

App ➔ Board
JSON{"target_temp": 26.5}

Dedicated numeric stepping panel with - / + buttons and direct input, with min, max, step, and decimal places.

Selector widget preview

Selector Segmented / Dropdown

App ➔ Board
JSON{"mode": 1}

Supports segmented buttons or dropdown presentation. Tap an option to send its configured value (numbers sent as numeric type).

Joystick widget preview

Joystick Dual-Axis Joy

App ➔ Board
JSON{"joy": [0.38, 0.42]}

While held, continuously sends [x, y] dual-axis coordinates (-1.00 to 1.00) at your set interval, resets on release.

Color Picker widget preview

Color Picker RGB Wheel

App ➔ Board
JSON{"rgb_hex": "#2391EB"}

Built-in color wheel, brightness slider, and preset swatches. Sends hex color in #RRGGBB format to drive RGB strips.


The board sends values to the app in a single JSON payload. The app updates matching widgets automatically.

Data Card widget preview

Data Card Value Card

Board ➔ App
JSON{"co2": "428 ppm"}

Displays numbers or text with large typography, ideal for real-time readings, bus voltage, or sensor units.

Text Display widget preview

Text Display Status Board

Board ➔ App
JSON{"status": "Status: All Greenhouse Sensors OK"}

Single-line dynamic text board. New incoming text replaces the previous value, ideal for status alerts or operating modes.

LED Indicator widget preview

LED Indicator Light

Board ➔ App
JSON{"drv_ok": 1}

Compares incoming numbers with your threshold; lights up in designated color when reaching threshold, off color otherwise.

Level Bar widget preview

Level Progress Bar

Board ➔ App
JSON{"bat_pct": 84}

Draws horizontal or vertical progress fill between min and max, ideal for battery level, water tank, or system load.

Map widget preview

Map GPS Position

Board ➔ App
JSON{"gps": "25.0330,121.5654"}

Receives “lat,lng” text, automatically loads OpenStreetMap street imagery with a red marker (WizDash does not read phone GPS).

Thermometer widget preview

Thermometer Mercury Tube

Board ➔ App
JSON{"temp": 26.8}

Displays numbers on a vertical mercury thermometer with customizable scale and °C/°F units.

Humidity Ball widget preview

Humidity Ball Fluid Wave

Board ➔ App
JSON{"hum": 62.5}

Visualizes 0–100 values as a dynamic double-layer fluid wave ball, perfect for humidity or liquid capacity.

Gauge widget preview

Gauge Dial Meter

Board ➔ App
JSON{"fan_rpm": 78}

Draws an arc dial gauge with needle and unit between min and max, ideal for fan RPM, pressure, power, or speed.

Pie Chart widget preview

Pie Chart Donut Ratio

Board ➔ App
JSON{"mem_used": 64}

Displays a percentage value on a circular pie chart, suitable for memory usage, energy share, or yield rate.

Line Chart widget preview

Line Chart Live Trend

Board ➔ App
JSON{"temp": 26.8}

Plots real-time trend curve with incoming numbers (retains last ~50 points), with custom min, max, unit, and precision.

Terminal widget preview

Terminal Serial Monitor

Two-Way Terminal
JSON{"term": "DHT22: T=26.8C H=62.5%"}

Appends incoming text line by line with timestamps; also lets you type and send text back to the board on the same key.

WizDash robotics control dashboard with virtual joystick, RGB color picker, slider, battery level bar, serial terminal, and data cards
A control and telemetry dashboard combining a joystick, RGB color picker, slider, level bar, and two-way serial terminal.

Text Label, Icon, Image, and Spacer arrange the screen and do not exchange JSON data.

Text Label widget preview

Text Label Section Header

Layout (Quota Counted)
JSONNo JSON key needed

Custom text label with font size and color for organizing dashboard sections (counts toward functional quota).

Icon widget preview

Icon Visual Marker

Layout (Quota Exempt)
JSONNo JSON key needed

Built-in library of hardware and status icons to mark elements visually (excluded from free quota).

Image widget preview

Image Graphic Asset

Layout (Quota Counted)
JSONBuilt-in / Local File / Web URL

Insert project logo, schematic, or web image URL (downloads directly from web, counts toward functional quota).

Spacer widget preview

Spacer Canvas Gap

Layout (Quota Exempt)
JSONNo JSON key needed

Pure transparent spacing element (hidden in normal mode, shows bounds and resize handle in Edit Layout mode).