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 (Reports Module)

Maps every Reports surface to the shared design system. Tokens: 00-shared/02 (Material 3, proposed defaults); components: 00-shared/03; motion: 00-shared/08; a11y: 00-shared/09. Module components 07_Component_Library.md.


1. Screens → design tokens

SurfaceColorType scaleSpacingShape
S1 catalogsurface bg; primary iconstitleLarge (list titles), bodyMedium (descriptions)list item 16-8-16; section gap 24shapeMedium tiles
S2 formsurface; primary CTA; error inlineheadlineSmall (title), bodyLarge (fields), labelMedium (chips)field gap 16; bottom padding 24shapeMedium inputs, shapeSmall chips
S3 job listsurface; status colors (C2)titleMedium rows, bodySmall metarow 12; chip gap 8shapeSmall badges
S4 detailsurfaceContainerLow cards on surfaceheadlineSmall type label, bodyMedium metacard padding 16; card gap 12shapeLarge status card
S5 resultsurface; secondaryContainer metric cards; error faileddisplaySmall metrics (fee), titleMedium labels, bodyMedium tablemetric grid gap 12; table cell 8shapeMedium cards; grade badge shapeSmall
Status palettequeued: surfaceVariant; processing: tertiary; completed: primary; failed: error

2. Component mapping

ScreenShared (00-shared/03)Module (07)
S1AppListTile, AppBadgeReportTypeTile
S2AppTextField, AppDatePicker, AppButton, AppSnackbar, AppChips(none)
S3AppListTile, AppSkeleton, AppEmptyState, RefreshIndicator, AppMenuReportStatusBadge, JobListRow
S4AppCard, AppButton, AppSnackbar, AppOfflineBannerJobProgressCard, JobParamChips, PollingRetryButton
S5AppCardMetricCard/Grid, ReportCardResult

3. Icons

schedule (queued), hourglass_top (processing), check_circle (completed), error_circle (failed) — outlined set; 20 dp grid, onSurfaceVariant.

4. Typography & density

  • Numbers (fee metrics) use tabular figures (fontFeatures: tabularFigures) — alignment-critical.
  • Mobile density 4, tablet 0 (00-shared/02).

5. Dark mode

  • All tokens dark-adaptive; status palette keeps hue, lightens on- colors.
  • Indeterminate progress: tertiaryContainer track.

6. Accessibility mapping (00-shared/09)

SurfaceRequirement
all4.5:1 text contrast; touch targets ≥ 48 dp
S4status change announced via live region (badge swap must not re-announce whole card)
S5result table: proper Semantics header mapping; grade badge label includes band
S2errors linked to fields (errorText semantics)
allReduceMotion: poll unaffected; replace slide/fade with instant swap

7. Deviations & notes

  • No brand illustration; report icons are the only imagery — matches shared baseline.
  • Progress: indeterminate only (server constraint) — do not restyle into a fake percentage (07 C3).