docs/briefs/token-wallet.md

Module brief: TokenWalletModule

Slug / tier / group / category: token-wallet · advanced · features · Membership One-liner: Token balance, purchase packs, top-up, transaction history. Closest references: ProductModule fields sub-card (packs); Collection Rows (history); NotificationsModule meta alignment. Source: YOU Studio wireframes §4a, §4c.

Anatomy

  • ModuleShell, title default "Wallet"
  • Balance block: big token count + muted scope line (e.g. "Studios 4 & 5")
  • Packs: selectable rows in a raised sub-card (name · tokens · price), selected outlined
  • CtaRow "Top up" (solid, fires with selected pack)
  • History: rows label + date · signed delta right-aligned (+ medium, − muted)

Content model

balance, scope?, packs[] {id,name,tokens,price}, transactions[] {id,label,date,delta}, onTopUp(packId).

Fields

title text · header toggle

Out of scope

Payment capture (PaymentModule), server-side balance.