Skip to Content
BBRICKSv0.7.4
KitPatterns

ProofList

A list of payout receipts, one labelled "View proof" each: what replaces the v2 single bare "View proof" link (which only reached the first receipt of a day's batch, UX-5). Each row names who was paid and how, so every creator's proof is reachable. Used in the Payout drawer and the wallet's Top-ups group.

import { ProofList } from '@ergasti/bricks';

Examples

Payout proofs

One row per payment with its amount and a "Transfer proof" button; context gives each button a specific accessible name.

Code
import { Money, ProofList } from '@ergasti/bricks';

function Payouts() {
  const items = [['Laila Saeed', 12050], ['Karim Hosny', 3225], ['Salma Hosny', 24600]].map(([name, amount], i) => ({
    id: i, title: name, sub: `Bank transfer · ref ${88412 + i}`, amount: <Money value={Number(amount).toFixed(2)} />, context: `${name}, ref ${88412 + i}`, onOpen: () => {},
  }));
  return <div style={{ maxWidth: 460 }}><ProofList label="Paid to" items={items} /></div>;
}

Empty

Code
import { ProofList } from '@ergasti/bricks';

function Empty() {
  return <div style={{ maxWidth: 460 }}><ProofList label="Paid to" items={[]} /></div>;
}

Your own empty line

empty replaces the default sentence when there are no proofs.

Code
import { ProofList } from '@ergasti/bricks';

function CustomEmpty() {
  return <div style={{ maxWidth: 460 }}><ProofList label="Paid to" items={[]} empty="No transfers in this batch yet." /></div>;
}

Props

Prop

Type

Labels

Every word this component draws, in both languages. Override one per component and language with BricksProvider labels under the key proofList, or with the component's own prop where it has one. A {name} is a value the component fills in.

proofList
KeyEnglishArabic
noneNo proof uploaded yet.لسه مفيش إثبات اترفع.

Design guidance

How the BRICKS design system uses ProofList. Written in docs/content/components/ProofList.md; the props above are read from the code, which wins where the two disagree.

A list of payment proofs, one row per receipt with who was paid, how, the amount and its own "View proof" button; use it wherever a batch of payments needs every receipt reachable.

ProofList replaces v2's single bare "View proof" link, which only reached the first receipt of a day's batch (UX-5). Each row is a soft rounded tile naming who was paid and how ("Bank transfer · ref 88412 · 11 Nov 2026"), the amount, and a ProofButton whose accessible name includes the row's context, so ten rows are never ten identical "View proof" buttons. With no items it says "No proof uploaded yet." or your empty.

Anatomy

  1. List (ul.kit-prooflist, aria-label): column, 8px gap.
  2. Row (li): wraps, 12px 16px padding, 16px radius, --soft.
  3. Text (.kit-prooflist-t): bold title (dir="auto") and the sub line.
  4. Amount (b.kit-prooflist-amt, optional): no wrap.
  5. ProofButton: "View proof", named with context.

Variants

None; each row's ProofButton follows onOpen (button) or href (link in a new tab).

States

StateTriggerLook
Itemsitems.length > 0Rows
Emptyitems=[]"No proof uploaded yet." / "لسه مفيش إثبات اترفع." (13px --ink-3) or empty
No targetitem without onOpen and safe hrefThat row has no button
Narrowsmall widthThe amount and button wrap under the text

Types

ProofItem: id (required), title (required), sub, amount (a <Money>), context (required, plain words for AT: "Laila Saeed, ref 88412"), onOpen, href.

Usage

The payout drawer:

<Drawer open title="11 Nov payout" onClose={close}>
  <ProofList label="Receipts" items={batch.payments.map((p) => ({
    id: p.ref,
    title: p.creatorName,
    sub: `Bank transfer · ref ${p.ref} · 11 Nov 2026`,
    amount: <Money value={p.amount} />,
    context: `${p.creatorName}, ref ${p.ref}`,
    onOpen: () => openProof(p.ref),
  }))} />
</Drawer>

A wallet top-ups group:

<ProofList label="Top-ups" empty="No top-ups yet." items={[
  { id: 1, title: 'Card top-up', sub: 'Visa ·· 4242 · 2 Nov 2026', amount: <Money value="20000.00" />, context: 'Card top-up, 2 Nov 2026', href: receiptUrl },
]} />

Where it appears

  • Brand › Payments › Payouts › payout batch drawer (every creator's receipt).
  • Brand › Payments › Wallet › Top-ups group.
  • Screen: Payments › Wallet.

Guidelines

Do

  • Make context unique per row (name + reference).
  • Put the method and reference in sub.

Don't

  • Don't use it for a single receipt; use ProofButton alone.

RTL and Arabic

  • Rows mirror; title uses dir="auto" so Latin names read correctly in Arabic.

Tokens

--soft, --ink-3, plus ProofButton's --rasp-50, --rasp-100, --rasp-d.

Accessibility

  • A named <ul>; each button reads "View proof · Laila Saeed, ref 88412".

Found in the source

  • ARIA attributes set: aria-label.
  • Its tests cover: “one labelled row per receipt: who, how, the amount and its own proof button”; “keyboard: Tab reaches each proof in order”.

Read from the component's source and tests. See Accessibility for the patterns the library follows.

See also: Money · Accordion · Card · HeroCard · KeyValue

Source

src/kit/patterns/ProofList.tsx (line 28) on GitHub.

On this page