Alert Widget

✦ Special

The Alert widget monitors a virtual pin value and displays a colored alert banner inside the dashboard when a threshold condition is met. Unlike the Notification system (which sends server-generated push or email alerts), the Alert widget is purely visual — a real-time in-dashboard indicator that requires no firmware changes.

Default size: 3 × 2 grid cells

---

Configuration

Property	Type	Default	Description
condition	gt | lt | eq | gte | lte | neq	gt	Comparison operator
threshold	number	80	Threshold value to compare against
severity	info | warning | error	warning	Alert color/style
message	string	Alert triggered	Message displayed when condition is true
acknowledgeButton	boolean	false	Show "Acknowledge" button to dismiss the alert
Device	device	—	The device to monitor
Pin	V0–V255	—	The virtual pin to watch
Label	string	—	Widget label

---

Conditions

Condition code	Meaning
gt	Value > threshold
lt	Value < threshold
gte	Value ≥ threshold
lte	Value ≤ threshold
eq	Value = threshold
neq	Value ≠ threshold

---

Severity styles

Severity	Color	Use for
info	Blue #3B82F6	Informational state changes
warning	Amber #F59E0B	Elevated but not critical
error	Red #EF4444	Critical / action required

---

Firmware example

No firmware changes needed — just push the pin value normally:

void loop() {
  Vwire.run();

  float temp = readTemperature();
  Vwire.virtualSend(V5, temp);  // Alert widget is configured to trigger when temp > 85
  delay(10000);
}

The Alert widget watches V5 on the configured device and shows the alert banner whenever temp > 85.

---

Alert widget vs Notification system

Feature	Alert Widget	Server Notifications	Device notify()
Trigger	Client-side (browser)	Server-side (always on)	Device firmware
Delivery	Dashboard banner only	Push, email, in-app bell	Push, email, in-app bell
Requires open dashboard	✅	❌	❌
Firmware changes needed	❌	❌	✅
Configuration	Widget settings	Notification rules panel	In firmware code

For push notifications and emails sent directly from your device code, see Alerts & Notifications.