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 (Payments)

Maps payments components to Material 3 + Flutter widget + tokens. Reference 00-shared/04 for the global mapping.


Component mapping

ComponentM3 roleFlutter widgetSpacingTypographyElevationRadiusColors
PaymentRowList itemListTile customh ≥ 72, gap 12titleSmall refe-0r-mdsurface / onSurface
RefundTextMoney displayText + tabulartitleMediumonSurface
StatusBadgeBadgeChip/BadgelabelMediume-0r-fullper status on *Container
ReceiptViewCardElevated cardCardpadding 24body/bodye-1r-lgsurfaceContainerLowest
PaymentActionsRowAction rowWrap of buttonsgap 8labelLarger-mdprimary/error
MoneyProgressProgressLinearProgressIndicatorbodySmallr-smprimary/success
NewPaymentFormFormForm+AppTextFieldgap 16bodyMediume-1r-mdsurfaceVariant
Reconcile radiosRadio groupRadioListTilebodyMediumprimary

Iconography

  • Offline gateways: cash/cheque/bank_transfer.
  • Gateway logos (generic icons; no brand logo w/o asset) (forward-looking).
  • Status icons: check_circle, schedule, cancel, replay.

Motion

  • Page transitions m-base; sheet m-base; FAB m-entrance; money updates 150 ms m-fast; reduced motion → fades.

Responsive

  • Phone: single column, FAB, bottom nav.
  • Tablet (600–839): two-column payment list; detail in master pane.
  • Landscape tablet / desktop: table layout (columns: ref, payer, gateway, amount, status, date), filter rail, hover actions.