You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
As dashboards grow in complexity, users need a way to organize related tiles into collapsible sections. This is a standard expectation for observability dashboards — it reduces visual clutter, improves navigation on dense dashboards, and provides a performance benefit by skipping data queries for collapsed sections.
This issue covers the core mechanics: data model, layout engine changes, section header rendering, and lazy loading.
Scope
Data model
Add a section concept to the dashboard tile system. A section has:
References to child tile IDs (or tiles reference their parent section)
Keep tiles flat in the array — sections reference children, children are never moved/nested in the JSON. This avoids known pitfalls with inconsistent serialization based on collapsed state.
Update Zod schemas in packages/common-utils/src/types.ts
MongoDB model already uses Mixed for tiles — no migration needed
Layout engine
Section headers render as full-width (24-col), 1-unit-high bars in the react-grid-layout grid
On collapse: remove child tiles from the layout array, shift y-positions of everything below
On expand: re-insert child tiles, restore y-positions
Collapsed children are not mounted by React — their query hooks don't fire (lazy loading for free)
Section header component
Displays section title and collapse/expand toggle
Visually distinct from chart tiles (thin horizontal bar)
Supports both collapsed and expanded states
Lazy loading
Tiles in collapsed sections are unmounted → no API calls, no rendering
On expand, tiles mount and fetch data with the current time range
Auto-refresh and time range changes do not affect collapsed tiles
Out of scope (see follow-up issue)
Add/rename/delete section authoring UX
Drag-to-assign tiles to sections
Section settings (default collapsed state toggle in edit mode)
Activity
feat: add collapsible dashboard sections - core mechanics
feat: Collapsible dashboard sections - core mechanics (#1900)
feat: Collapsible dashboard sections - core mechanics (#1900)