Offline (read-only) mode - The last connected radio is remembered; with no radio the app opens on its saved contacts, channels, messages and unread counts. - Main screens stay open on disconnect. A Connect button replaces the battery and signal indicators, with a sheet to reconnect, choose a radio or stop a pending reconnect. - While disconnected everything is read-only: the composer becomes a "connect to send" bar (drafts kept) and controls that change the radio or stored history are disabled or hidden. - Resending while disconnected no longer deletes the message; a different radio no longer shows the previous radio's channels. - Notification taps open the saved chat while offline. Chats and menus - Channel chat menu: notifications, edit channel, delete channel; the filter row lines up with the others; bell moved out of the app bar. - DM and room menus: remove from contacts; rooms get room management. - Search field uses the full app bar; long-press a result to copy. - Hashtag channel titles no longer read "# #name"; more room around the radio activity dot. - Repeat filter: short messages from one sender are caught at the same count as long ones. Layout - Shared menu row (wraps to two lines) and segment label (never splits a word) used across the app. - One Scan button on the scanner; consistent settings tile titles; contact "last seen" wraps instead of truncating; unfetched repeater settings are dimmed. Localization - New European Portuguese locale (pt_PT); regional locales are handled by the language picker, notifications and the background service. - Fill 67 missing strings per locale, including backup and restore. - Keep "Flood" and "Zero Hop" untranslated, shorten "last seen" and routing labels, and fix mistranslated scan, theme and hop strings. - Received-image strings, badge and caption come from translations. - Regenerate the Czech localizations, which were missing strings. Docs - Add documentation/design.md (UI reference) and offline-mode.md; update channel, chat, navigation and scanner docs.
24 KiB
UI Design Reference
How MeshCore Open's interface is built today, and the rules to follow when adding or changing UI. Every value below comes from the code it cites. If you change one of those sources, or settle on a new pattern, update this page in the same change.
The source of truth is lib/theme/mesh_theme.dart (theme), lib/widgets/mesh_ui.dart (shared widgets) and lib/widgets/mesh_nav_tile.dart (settings rows). Where the code disagrees with this page, fix one of them; do not copy the inconsistency.
1. Principles
- Readable first. Many users are older. Use the sizes in Typography as minimums, keep text and icons high-contrast, and never use colour as the only signal.
- Theme and shared widgets, not ad-hoc values. Take colours from
Theme.of(context).colorScheme(or the theme extensions), text styles fromTheme.of(context).textTheme, radii fromMeshRadii, and build rows, cards, menus and sheets from the shared widgets in section 5. - Every label must survive a long translation. The app ships 19 locales. Text wraps or scales; it never clips or breaks mid-word.
- Respect the system text size. The app does not clamp the system text scale (only
ReviewModeBannerusesMediaQuery.withClampedTextScaling). Layouts must grow, wrap or scroll at large scales. - Material only. No Cupertino widgets (
AGENTS.md).
2. Colour and theme
lib/main.dart applies MeshTheme.light(), MeshTheme.dark(), or MeshTheme.fromCustom(customTheme) for custom, preset and holiday themes. All three go through MeshTheme._build, so component themes are identical; only the ColorScheme and three extensions change.
| Need | Use |
|---|---|
| Page background | scheme.surface (scaffold default) |
| Card / sheet / dialog / menu surface | scheme.surfaceContainerLow (cards, sheets, dialogs), surfaceContainerHigh (popup menus, snackbars, input fill) |
| Primary text | scheme.onSurface |
| Secondary text, icons, subtitles | scheme.onSurfaceVariant (the default iconTheme colour) |
| Borders and dividers | scheme.outlineVariant (card borders, dividers); scheme.outline (stronger: outlined buttons, input border) |
| Accent, selection, primary actions | scheme.primary / onPrimary |
| Destructive or error | scheme.error; banners use errorContainer / onErrorContainer |
| Warning | scheme.tertiary (amber), or MeshPalette.warn |
| Good / bad signal | MeshTheme.snrColor(snr, blocked:); MeshPalette.signal, .warn, .alert for status ramps (e.g. battery in repeater_status_screen.dart) |
| Own chat bubbles | MeshBubbleTheme.of(context) |
| Map overlays and markers | MapPalette, MeshMapTheme.of(context); line-of-sight charts use LosPalette |
| Coloured text or icon on a tinted background | pass it through readableAccent(color, background, minContrast:) (mesh_ui.dart), 4.5 for text, 3 for icons |
Rules:
- Do not use
MeshPalette.ink*,bg*orline*directly in normal screens. They are the dark-theme values and are wrong in the light theme and in custom themes. Use the matchingColorSchemerole. - Do not use raw
Colors.red,Colors.grey[600]and so on for UI chrome. - Status colours (
error,tertiary,secondary) are copied from the stock scheme of the same brightness infromCustom, so they keep their meaning in custom themes. StatusChipshows how to colour a status: the label keepsonSurface, and only the dot or icon carries the colour.
Custom, preset and holiday themes (colours, icons, map markers, chat backgrounds) are described in themes.md. Use ThemedIcon(ThemeIconSlot.…) for the icons a theme can replace (tabs, send, settings, node avatars).
3. Typography
Fonts (MeshFonts): Inter (sans, the default), JetBrains Mono (mono), each with system fallbacks. MeshTheme.display() (serif) exists but is not used.
The text theme is the Material 3 2021 type scale (Typography.material2021) with Inter and onSurface colour applied in MeshTheme._build. Sizes are Flutter's defaults:
| Style | Size / weight | Used for |
|---|---|---|
titleLarge |
22 / 400 | Rare large headings |
titleMedium |
16 / 500 | Sheet titles (BottomSheetHeader, w700), empty-state titles (EmptyState, w600) |
titleSmall |
14 / 500 | Sub-headings inside cards, banner titles (RadioDisconnectedBanner, w700) |
bodyLarge |
16 / 400 | Body text; settings tile titles at w600 (meshTileTitleStyle) |
bodyMedium |
14 / 400 | Default Text; tile subtitles in onSurfaceVariant |
bodySmall |
12 / 400 | Sheet subtitles, captions |
labelMedium |
12 / 500 | Bottom navigation labels (QuickSwitchBar) |
labelSmall |
11 / 500 | Avoid for anything the user must read |
Component text set explicitly in MeshTheme._build:
| Component | Style |
|---|---|
| App bar title | 20, w600, letter-spacing -0.2 |
| Filled / elevated button | 14, w600 |
| Segmented button | 13, w600 |
| Tab bar | 13.5, w700 selected, w500 unselected |
| Chip label | 12.5, w600 |
| Snackbar content | 16 |
| Tooltip | 12 |
| Slider value label | mono 12 |
Which style to use:
| Text | Style |
|---|---|
| Screen title | App bar default (20/w600); don't override |
| Section header above a card | SectionHeader (upper-cased MeshTheme.accentLabel, 13, w700, letter-spacing 0.6, onSurfaceVariant) |
| Settings / list row title | meshTileTitleStyle(theme) = bodyLarge w600. Inside MeshSettingsTileTheme, stock ListTile/SwitchListTile/CheckboxListTile titles get it automatically |
| Row subtitle | bodyMedium, onSurfaceVariant (stock ListTile default; MeshNavTile sets it) |
| Body copy, dialog content | bodyMedium / bodyLarge |
| Numbers, units, keys, hashes, CLI output, counts | MeshTheme.mono(...) (tabular figures). StatTile values are mono 20/w600 with a mono 12 unit |
| Timestamps, meta text | 12 minimum (bodySmall or fontSize: 12) |
| Chat message body | 14 × chat text scale (chat_screen.dart bodyFontSize) |
Minimum sizes: no hard-coded fontSize below 12 exists in lib/screens or lib/widgets; keep it that way. MeshTheme.accentLabel() defaults to 11, so always pass fontSize: (12 or more). Prefer a textTheme style over a literal fontSize.
Chat text scale. ChatTextScaleService (0.8–1.8, pinch in chat_zoom_wrapper.dart) multiplies chat text only. It stacks with the system scale. Read it with context.select<ChatTextScaleService, double>((s) => s.scale).
4. Spacing, shape and sizing
| Thing | Value | Source |
|---|---|---|
| Screen side padding | 16 | MeshCard.margin, SectionHeader.padding, MeshNavTile.padding |
| Card | margin 16 horizontal / 4 vertical, padding 14, radius MeshRadii.md (14), 1px outlineVariant border, surfaceContainerLow fill, no elevation |
MeshCard |
| Card holding tiles | MeshCard(padding: EdgeInsets.zero), rows separated by Divider(height: 1, indent: 16) |
app_settings_screen.dart, settings_screen.dart |
| Section header | padding 16, 20, 16, 8 (LTRB) | SectionHeader |
| Settings row | padding 16 / 12, 24px icon, 16 gap, chevron 24 | MeshNavTile |
| Switch row | SwitchListTile, contentPadding 16 / 4, secondary icon size 24 |
app_settings_screen.dart |
| Popup menu row | 20px icon, 12 gap | MeshMenuItemRow |
| Banner | padding 16 / 12, 24px icon, 12 gap | RadioDisconnectedBanner |
| Sheet header | padding 20, 8, 8, 4 (LTRB), 36×4 drag handle | BottomSheetHeader |
| Radii | MeshRadii.xs 6, sm 10, md 14 (cards, inputs, menus, snackbars, list tiles), lg 18 (sheets, dialogs), xl 24, pill 999 (buttons, chips, FAB) |
MeshRadii |
| Default icon size | 22 | iconTheme |
| Avatar | 40 | AvatarCircle |
| List bottom padding under a FAB | 88 | channels_screen.dart |
Icon sizes in use: 24 for tile and banner icons, 20 for menu icons and small action buttons, 18 for inline refresh icons and spinners. Keep tappable icons at 20 or more.
Tap targets. Keep Flutter's 48×48 minimum (the default materialTapTargetSize and IconButton size). Don't shrink with VisualDensity.compact, MaterialTapTargetSize.shrinkWrap or small BoxConstraints unless the control sits inside a larger tappable row.
5. Components
| Need | Use | Notes |
|---|---|---|
| Group of related content | MeshCard |
onTap/onLongPress give ink feedback; long-press adds a selection haptic |
| Label above a group | SectionHeader(label, trailing:) |
Upper-cases for you; pass the normal-case l10n string |
| Settings navigation row | MeshNavTile |
onTap: null dims it to 50 % and reports it as disabled; use subtitle to say why |
| Settings switch | SwitchListTile inside MeshSettingsTileTheme |
Wrap the settings screen body once in MeshSettingsTileTheme |
| Radio-style choice in a sheet | MeshSheetOption |
Used by the language picker and map time filter |
| Popup menu row | always PopupMenuItem(child: MeshMenuItemRow(icon:, label:)) |
Label wraps to 2 lines then ellipsizes; leading: for ThemedIcon; no icon keeps the 20px slot |
| Segmented button label | always ButtonSegment(label: MeshSegmentLabel(text)) |
Shrinks to 12 (before system scale), then wraps at word boundaries onto 2 centred lines; never breaks a word |
| Status | StatusChip |
Mono label, coloured dot or icon |
| Metric | StatTile |
Label wraps to 2 lines; value wraps |
| Signal | SignalBars, MeshTheme.snrColor |
|
| Route kind | RouteChip |
Direct / hop count / Flood |
| Count badge | Badge on nav icons (QuickSwitchBar, caps at 99+), UnreadBadge in lists (alert red, mono 12) |
|
| Empty list | EmptyState(icon:, title:, subtitle:, action:) |
Scrolls rather than overflowing at large text |
| Inline error with retry | ErrorRetryCard(message:, onRetry:, retryLabel:) |
Pass retryLabel: context.l10n.common_retry |
| Radio offline on a remote-node screen | RadioDisconnectedBanner |
Renders nothing while connected |
| Sync progress | SyncProgressAppBarBottom as the app bar bottom |
3px bar |
| Toast message | showDismissibleSnackBar(context, content: Text(...)) |
Tap to dismiss, replaces the current snackbar, safe after an async gap |
| List item entrance | ListEntrance(index:) |
Optional |
Buttons. Theme shapes are all pill-shaped. In use:
FilledButton/FilledButton.icon: the primary action of a dialog, sheet, empty state or form (e.g. "Add public channel" inEmptyState, Save in the discard dialog inrepeater_settings_screen.dart). One per view.FilledButton.tonal: a secondary action that still needs weight (rare).OutlinedButton(.icon): secondary actions next to a filled one.TextButton: Cancel and low-emphasis actions in dialogs; inline actions in cards.- Destructive confirm:
FilledButtonwithbackgroundColor: scheme.error,foregroundColor: scheme.onError(showConfirmClearDialoginwidgets/confirm_clear_dialog.dart), or aTextButtonwithforegroundColor: scheme.errorwhen it is not the primary action. - Dialog action order: Cancel first, primary last.
- Avoid
ElevatedButtonin new code.
FAB. One per screen, for the main "add" action (contacts_screen.dart, channels_screen.dart) or primary action (FloatingActionButton.extended in themes_screen.dart, scanner_screen.dart). Always give it a tooltip or a label.
IconButton. Always set tooltip: with a localized string. It is the accessible name.
6. Sheets, dialogs and pages
What the code does:
| Container | Call | Used for | Examples |
|---|---|---|---|
| Bottom sheet | showMeshSheet + BottomSheetHeader (28 calls in 17 files) |
Choosing from a list, an item's actions, quick tools tied to the current screen | Language picker, notification mode, add contact/channel options, emoji and GIF pickers, node info, share contact, image actions |
| Draggable sheet | showModalBottomSheet + DraggableScrollableSheet |
Tall, scrollable panels that need a drag size | ContactRoutingSheet (routing_sheet.dart), path editor, image send preview |
| Dialog | showDialog + AlertDialog (72 calls in 35 files) |
Confirming an action, a short input (one to three fields), a short message | Disconnect (showDisconnectDialog), clear (showConfirmClearDialog), unsaved changes, edit node name, rename point |
| Page | Navigator.push(MaterialPageRoute(...)) |
Anything with sections, many fields, its own save, or that the user stays in | App Settings, Repeater Settings, Themes, Theme editor, Message filter, Region management |
Rules for new UI:
- Confirmation or a single short input → dialog. Title, one sentence, Cancel + one action.
- Pick one of several options, or act on one item → sheet. Use
showMeshSheetand start the content withBottomSheetHeader(title:, subtitle:). It handles the keyboard and navigation-bar insets. Use rawshowModalBottomSheetonly when you needDraggableScrollableSheet. - Forms with sections, live remote values, or anything that needs Save/Discard → page. Guard unsaved changes with
PopScopeand a discard dialog, asrepeater_settings_screen.dartdoes. - Never stack a dialog on a sheet on a dialog. Close the sheet first, or move the flow to a page.
7. App bars
- Title: a plain localized string, ellipsized on one line. Use
AppBarTitleon top-level and settings screens; it adds the connected node name as a subtitle and battery/SNR indicators when there is room, dropping them in that order on narrow widths. UseAdaptiveAppBarTitlefor a plain one-line title. - Centre the title (
centerTitle: true,AGENTS.md); 31 screens set it explicitly because the theme default isfalse. Chat screens (chat_screen.dart,channel_chat_screen.dart) deliberately usecenterTitle: falsefor their two-line name + route title. - Actions: at most two icon buttons plus the overflow (
Icons.more_vert) menu, for exampleRadioStatsIconButton, search, ⋮ inchat_screen.dart. Put everything else in the overflow menu. - Overflow menu order: things about this screen first, then app-level items (Disconnect, Settings), with destructive items last. Destructive items use
MeshMenuItemRow(color: scheme.error)so both icon and label turn red (Clear chat inchat_screen.dart; Clear / Delete channel inchannel_chat_screen.dart). UsePopupMenuDividerbetween groups. - Search: tapping search swaps the title for the field and hides all actions (
actions: _searching ? null : [...]). The leading back arrow and the system back gesture close the search (PopScope(canPop: !_searching)) instead of leaving the screen. - Long operations: show progress as the app bar
bottom(SyncProgressAppBarBottom, or a 4pxLinearProgressIndicatorfor Refresh all inrepeater_settings_screen.dart).
8. States
| State | How to show it |
|---|---|
| Loading, nothing to show yet | Center(child: CircularProgressIndicator()), only until the first data arrives; then show partial data (channels_screen.dart). |
| Loading in place | Swap the control's icon for an 18×18 CircularProgressIndicator(strokeWidth: 2) and disable it (_buildRefreshButton in repeater_settings_screen.dart). |
| Background sync | SyncProgressAppBarBottom. |
| Empty | EmptyState with an icon, a short title, and an action when there is an obvious next step. Use a separate "no results" state (Icons.search_off) when a search or filter hides everything. |
| Error | A snackbar for a failed action. ErrorRetryCard for a failed load the user can retry. Never show raw exception text alone. |
| Companion radio disconnected | Main and chat screens stay open, read-only (offline mode). Decide with isRadioReadOnly(connector) / context.radioReadOnly (lib/utils/radio_guard.dart): disable menu items (PopupMenuItem(enabled: false), drop destructive colors) and buttons, hide FABs, and call ensureRadioConnected(context) as the safety net in handlers. The chat composer shows OfflineComposerBar. Repeater screens stay open with RadioDisconnectedBanner at the top and disable radio-dependent actions. Settings rows that need the radio pass onTap: null and show settings_requiresConnection as the subtitle (settings_screen.dart). |
| Feature unsupported by firmware | Disabled row with a subtitle that says why (settings_requiresFirmware('v1.10')). |
| Remote value not fetched yet | See below. |
Unknown remote values. A value that lives on a remote node (repeater settings, status) must not look like a real value until it has been fetched or set. repeater_settings_screen.dart does this:
_known(key)is true once the value was fetched (_loadedKeys) or edited by the user (_dirtyKeys).- Unknown values display as an em dash
—(sliders' value label, and everyStatTilevalue inrepeater_status_screen.dart);common_notAvailableis the localized form. _dimIfUnknownfades the control to 60 % opacity. It stays usable; changing it makes the value known.- Unknown switches show off, unknown dropdowns show no selection, and unknown text fields stay empty.
- While nothing is loaded, a card at the top explains this (
repeater_settings_screen.dart,repeater_settingsNotLoaded) with a Refresh all button. Each setting also has its own refresh button.
Follow the same pattern for any new remote-value screen.
9. Text and localization
- All user-facing strings go through
context.l10n(lib/l10n/l10n.dart). Add keys tolib/l10n/app_en.arbfirst. No string literals in widgets, including fallbacks. - Keep strings short: labels are a few words, subtitles one sentence.
- Keep established radio terms in English in every locale: Flood, Zero Hop, hop, SNR, RSSI, LoRa, advert, repeater names and CLI commands.
- Never put text in a fixed-width box (
SizedBox(width: 80, child: Text(...))). UseExpanded/Flexible, or let aRowwrap into aColumn/Wrapwhen space runs out. - Labels must wrap or scale, never clip and never break mid-word:
- Menus:
MeshMenuItemRow(2 lines, then ellipsis). - Segmented buttons:
MeshSegmentLabel. - Tile titles and subtitles: let them wrap. Set
maxLinesonly on lists where height matters, and addoverflow: TextOverflow.ellipsiswith it. - Do not use
TextOverflow.cliporsoftWrap: falseon translated text.
- Menus:
- Upper-casing is done in code (
SectionHeader,StatTile,RouteChip); keep the ARB strings in normal case. - Test with a long locale (German, Portuguese) and a large system font (at least 1.3×, ideally 2.0×) on a narrow phone (320dp).
test/screens/small_screen_layout_test.dartchecks many screens at 320×568 at 1.0, 1.3 and 2.0× in English; add new screens to it.
10. Checklist for a UI change
- Colours from
colorSchemeor theme extensions; no rawColors.*orMeshPalette.ink/bg/linein chrome. - Text styles from
textThemeorMeshTheme.mono; nothing below 12. - Settings rows use
MeshNavTile/SwitchListTileinsideMeshSettingsTileTheme; cards areMeshCardwith aSectionHeader. - Popup menu rows use
MeshMenuItemRow; segmented buttons useMeshSegmentLabel; destructive menu items last, inscheme.error. - Every
IconButtonand FAB has a localizedtooltip. - Tap targets at least 48×48.
- Right container: dialog for confirm/short input,
showMeshSheet+BottomSheetHeaderfor choices and item actions, page for forms. - Loading, empty, error, offline and unknown-value states handled.
- All strings in
app_en.arb; checked in German or Portuguese at 1.3× and 2.0× on a narrow screen. - Light, dark and one custom theme checked.
- This page updated if you introduced or changed a pattern.
11. Known inconsistencies
The current code does not yet follow this page everywhere:
- App bar centring.
MeshTheme._buildsetscenterTitle: false, butAGENTS.mdasks for centred titles and 31 screens override it.contacts_screen.dartdoes not, so its title is left-aligned while Channels and Settings are centred. - Disconnect placement in overflow menus. It is the first item in
channels_screen.dart, but just above Settings incontacts_screen.dartandmap_screen.dart. It tints only the icon (iconColor), while Clear chat / Delete tint icon and label (color). - Menu rows not using
MeshMenuItemRow.channel_chat_screen.dartbulk-select menu (Select all / Copy) puts aListTileinsidePopupMenuItem.widgets/list_filter_widget.dartand the group menu incontacts_screen.dartuse plainTextitems, which is acceptable for icon-less lists but does not limit wrapping. - Settings toggles in two sizes.
FeatureToggleRow(widgets/elements_ui.dart, used insettings_screen.dartdialogs) uses abodyMediumw600 title andbodySmallsubtitle with a 32px refresh button.MeshNavTileand themedSwitchListTiles usebodyLargew600 /bodyMedium. Only App Settings, Message Filter and Repeater Settings wrap their body inMeshSettingsTileTheme. ErrorRetryCardis unused and its fallback label is the hard-coded English'Retry'(mesh_ui.dart); screens show load errors in their own ways.- Fixed-width label boxes.
chat_screen.dart_buildInfoRow(80px),line_of_sight_map_screen.dartendpoint label (54px,fontSize: 12),channel_message_path_screen.dart(72px, upper-casedaccentLabelat its 11px default). - 11px text.
MeshTheme.accentLabel()withoutfontSizegives 11px inchannel_message_path_screen.dartandwidgets/path_map_ui.dart(which also uses dark-onlyMeshPalette.ink3). The type scale'slabelSmall(11) is used inlist_filter_widget.dartsection titles. - Hard-coded colours.
SyncProgressAppBarBottomusesColors.red,Colors.blueandColors.green;AppBarTitlesubtitle usesColors.grey[600]at a literal 14 instead ofonSurfaceVariant;telemetry_location_map.dartuses rawColors.*.MeshPalette.ink/bg/lineappear directly in eight screen/widget files (mostly map panels, where they are intentional; alsochannels_screen.dartandchannel_chat_screen.dartcommunity dots with an 8px icon). - Literal sizes instead of the theme. About 300 literal
fontSize:values inlib/screensandlib/widgets(most 12–14), e.g.EmptyStatesubtitle at 13.5; and 36BorderRadius.circular(<number>)calls (8 and 12 most common) instead ofMeshRadii. - Navigation bar theme.
navigationBarThemecolours selected labelsonPrimary, which is white-on-white in light mode;QuickSwitchBaroverrides it. Any otherNavigationBarwould inherit the problem. - Two badge styles.
QuickSwitchBaruses MaterialBadgecapped at 99+;UnreadBadgecaps at 9999+. - Sheets without
showMeshSheet. Besides the draggable sheets,chat_background.dart,map_screen.dart,theme_editor_screen.dart,repeater_cli_screen.dart,message_translation_button.dartandpath_map_ui.dartcallshowModalBottomSheetdirectly, so they skip the shared inset handling and most skipBottomSheetHeader. - Large forms in dialogs.
RadioSettingsDialog(widgets/radio_settings_dialog.dart, nine inputs) and the contact settings dialog inchat_screen.dartare dialogs although they behave like forms. - Dialog buttons.
showDisconnectDialog(utils/dialog_utils.dart) uses twoTextButtons with no emphasis;showConfirmClearDialoguses a redFilledButton. - Snackbars. A few places still call
ScaffoldMessenger.showSnackBardirectly (discovery_screen.dart,app_settings_screen.dart,message_filter_settings_screen.dart,region_management_screen.dart,helpers/image_send_flow.dart) and so miss tap-to-dismiss and replace-instead-of-queue. - Small tap targets.
FeatureToggleRowrefresh (32px) and 40px buttons inchat_screen.dart,channel_chat_screen.dart,reaction_chips.dart,snr_indicator.dart,path_map_ui.dart; 44px inrouting_sheet.dart,path_editor_sheet.dart. - Unknown placeholders. Repeater and companion stats screens use
—;line_of_sight_map_screen.dartuses--. - Missing tooltip. The Contacts FAB (
contacts_screen.dart) has no tooltip; about 18 of 111IconButtons have no tooltip nearby. - Stale doc comments.
SectionHeaderis described as "mono" but uses the sansaccentLabel; theStatusChipcomment sits abovemeshContrastRatio.