AurumTransactionListCard
A status-tinted transaction row for payment / withdrawal / savings history lists.
| family | Cards |
|---|---|
| platform | iOS 17+ · SwiftUI |
| figma | component master ↗ |
| source | Sources/Aurum/Component/Card/AurumTransactionListCard.swift |
| code connect | FigmaConnect/Sources/AurumFigmaConnect/AurumTransactionListCard.figma.swift |
| snapshots | 1 baselines · iPhone 17 Pro · iOS 26.5 |
A status-tinted transaction row for payment / withdrawal / savings
history lists. The SwiftUI port of aurum-android's
AurumTransactionListCard (Figma node 5576:19749).
Outer feedback.* wash wraps a white inner card with leading slot,
label + date, status badge, and amount (+ optional gold-weight suffix).
helperText renders below in the matching status colour.
Intended use
Use as a single transaction row inside a scrollable history list — savings, withdrawals, gold buy / sell, referral payouts. For a "this just happened" callout use the Toast / Banner family; for a full transaction-detail screen use the bespoke detail layout.
Do
- Pre-format
dateText,amount, andsuffixTextat the call site with locale-aware utilities — the view takes strings only. - Drive
statusfrom real backend state (success / error / pending); wash + badge + amount colour all flow from it. - Pass
helperTexton failed / pending rows for inline context; leave itnilfor happy-path success rows.
Don’t
- Pass raw
Date/Decimalvalues throughString(describing:)— locale-broken output ships the moment a user switches device language. - Recolour the surface, badge, or amount with raw
Colorliterals —feedback.*tokens are the source of truth. - Use this for non-transactional rows (notifications, settings, search) — pick a neutral list-item primitive instead.
Snapshots
Recorded on the pinned simulator — iPhone 17 Pro · iOS 26.5 · Xcode 26.6.
Code Connect
Mapped to Figma node 5576:19749 ↗ — SwiftUI snippets appear in Dev Mode for the latest release.