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.
| Key | English | Arabic |
|---|---|---|
none | No 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
- List (
ul.kit-prooflist,aria-label): column, 8px gap. - Row (
li): wraps, 12px 16px padding, 16px radius,--soft. - Text (
.kit-prooflist-t): boldtitle(dir="auto") and thesubline. - Amount (
b.kit-prooflist-amt, optional): no wrap. - ProofButton: "View proof", named with
context.
Variants
None; each row's ProofButton follows onOpen (button) or href (link in a new tab).
States
| State | Trigger | Look |
|---|---|---|
| Items | items.length > 0 | Rows |
| Empty | items=[] | "No proof uploaded yet." / "لسه مفيش إثبات اترفع." (13px --ink-3) or empty |
| No target | item without onOpen and safe href | That row has no button |
| Narrow | small width | The 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
contextunique per row (name + reference). - Put the method and reference in
sub.
Don't
- Don't use it for a single receipt; use
ProofButtonalone.
RTL and Arabic
- Rows mirror;
titleusesdir="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.
Related
ProofButton: one proof.PayoutBatchDetail,WalletLedger: the blocks that show it.
See also: Money · Accordion · Card · HeroCard · KeyValue
Source
src/kit/patterns/ProofList.tsx (line 28) on GitHub.