Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

11 - Design System Mapping (Health Module)

Maps the Health module onto the global design system. Tokens in 00-shared/02, mapping conventions in 00-shared/04, components in 00-shared/03. All screens (proposed).


1. Status semantics → color tokens

SemanticTokenHex (from 00-shared/02 palette)Usage
Dependency upcolor-successgreenStatusDot, card border, banner positive
Dependency downcolor-errorredStatusDot, card border, banner negative
Stale / cautioncolor-warningamberstale badge, dlq > 0 chip (07 §3)
Neutralcolor-surface-*greyscard base, skeleton
Textcolor-text-*on-surfacelabels, detail lines

Never color-only: every status token is paired with text (up/down/stale) (00-shared/09, 07 §2).

2. Typography

ElementTokenExample
Screen titletext-title"App Health"
Banner verdicttext-body strong"1 of 5 degraded — Redis is down"
Card titletext-label"Redis"
Card statustext-label + color"up" / "down"
Detail linetext-caption"ping: PONG"
Monospace payload (S2)text-codedata.error.redis render

3. Spacing / layout tokens

  • Card grid: 8 dp gutter (space-2), 16 dp page padding (space-4).
  • 2-column grid ≥ 700 dp (00-shared/11); single column below.
  • Banner: full-width AppBanner, 12 dp internal padding.

4. Component mapping (all 00-shared/03 unless module-defined)

Screen elementComponentSource
Overall verdictAppBanner (custom OverallBanner, 07 §5)S1
Status cardsAppCard + StatusCard (07 §1)S1
Status indicatorStatusDot (07 §2)S1/S2
Queue backlogPendingJobsTile (07 §3)S1
Last-check timeLastCheckedLabel (07 §4)S1
RetryAppButton (outlined, m-app- style)S1
SkeletonsAppSkeletonS1 loading
OfflineAppOfflineBannerS1
DetailAppBottomSheet + SelectableText monospaceS2

5. Icons

IconWhereNote
Icons.favorite-style heartbeat glyph (checkmark/circle per library)banner positivesemantic, not decorative
Icons.refreshRetrystandard action glyph
Icons.info_outlinestale badgepairs with amber

6. Theming notes

  • Health colors ride the existing semantic tokens - no new palette entries, no module-local color constants (00-shared/04).
  • Dark mode: status colors keep contrast ≥ 4.5:1 against color-surface (00-shared/09); amber-on-dark validated for stale badge.
  • Motion tokens per 10 §4 (00-shared/08).