Dashboard overview

The dashboard is the main fullscreen UI on your mirror. It is composed of regions (zones) that contain modules (widgets). Some modules are built-in; others come from addons.

What you see

Top bar / corners — time, weather summary, or quick actions (build-dependent).
Main columns — calendar, news, smart home tiles, sports, health summaries.
Ambient layer — background, theme, and optional screensaver when idle.

💡 Tip: Start with a minimal preset in the wizard, then add one module at a time so you can spot performance issues early.

Edit layout (typical flow)

Open Settings (gear icon, touch gesture, or USB keyboard shortcut per your build).
Choose Layout or Modules.
Drag modules between regions or toggle them on/off.
Save — confirm the preview matches what you want on the wall.

Module states

State	Meaning
OK	Data refreshed on schedule
Stale	Network or API slow; last good data shown
Error	Auth expired, misconfigured API, or missing hardware

Performance

Prefer Ethernet for always-on mirrors.
Limit animated or high-frequency modules on Pi 4 if CPU stays high.
Use PM2 logs to correlate UI freezes with server errors.

⚠️ Warning: Editing layout while Kids Mode is on may be restricted — switch profiles with a PIN or admin gesture if items are greyed out.

Troubleshooting

Modules overlap after an update
Reset layout to default preset once, then re-apply custom positions.

Blank region
Check that the module’s dependency is satisfied (for example calendar requires Google link).