Docs menu

Native Components

Dashboard Card

A semantic dashboard container for grouped values, status, progress and summary information. PROVEN on the current ESP32-P4 evidence ledger.

#1 — Dashboard Card

Dashboard Card in the implemented ForgeUI Native Component library.

A semantic dashboard container for grouped values, status, progress and summary information.

  • Application summaries
  • Grouped telemetry
  • Status cards
  • Dashboard foundations

Inspector capabilities and presentation

  • Title, icon, value and units
  • Secondary text and timestamp
  • Normal, warning, critical and offline status
  • Optional progress, header, footer and root click

The component remains one serialized Canvas object. Browser Preview, Live Studio and Standalone Export consume its normalized semantic model while internal LVGL composition stays private.

Generated Runtime SDK family

c
FG_Set_<DashboardCard>_Value(const char * value);
FG_Set_<DashboardCard>_Units(const char * units);
FG_Set_<DashboardCard>_Status(const char * text, uint32_t rgb);
FG_Set_<DashboardCard>_Progress(int32_t value);

Interaction and UserEvents

c
void FG_On_<DashboardCard>_Clicked(void);

When click generation is enabled, only a genuine click on the card root invokes the optional hook.

Where hooks exist, implement the exact declarations in 95_UserEvents.c. Runtime SDK calls never simulate user input.

Ownership boundary

ForgeUI owns semantic presentation, private LVGL composition, generated contracts, persisted identity, fixed storage and Browser/Live/Standalone alignment.

Browser, Live, Standalone and ESP32-P4 status

SurfaceStatus
Browser PreviewImplemented
Live StudioImplemented
Standalone ExportImplemented
Persisted identity and duplicate isolationImplemented
ESP32-P4PROVEN