BrandLead
A brand's square as a queue row's lead (money alerts on Home).
import { BrandLead } from '@ergasti/bricks';Examples
The "needs you" queue
Join requests as rows (creator, brand, where the request came from, how long it has waited) with Approve and Reject, under a queue header with a count and "See all". Tiles above summarise each queue and filter it.
Code
import { useState } from 'react';
import { ApprovalRow, BrandLead, Card, IconSquare, PrCountPill, PrStatusPill, QueueHeader, QueueTile, TaskRow } from '@ergasti/bricks';
import { brands, joinRequests } from './pr';
function Queue() {
const [tile, setTile] = useState(0);
return (
<div style={{ display: 'grid', gap: 16 }}>
<div style={{ display: 'grid', gridTemplateColumns: 'repeat(auto-fit, minmax(200px, 1fr))', gap: 12 }}>
{([['rasp', 'approvals', 'Approvals waiting', 9], ['butter', 'wallet', 'Money alerts', 2], ['sky', 'star', 'Challenges to act on', 2]] as const).map(([tone, icon, label, count], i) => (
<QueueTile key={label} tone={tone} icon={icon} label={label} count={count} active={tile === i} onClick={() => setTile(tile === i ? -1 : i)} />
))}
</div>
<Card>
<QueueHeader title="Join requests" count={5} onSeeAll={() => {}} />
<ul className="kit-pr-queue">
{joinRequests.slice(0, 3).map((j) => <ApprovalRow key={j.id} creator={j.creator} brand={j.brand} source={j.source === 'public_challenge' ? 'Public challenge' : 'Creator request'} days={j.days} onApprove={() => {}} onReject={() => {}} onOpen={() => {}} />)}
</ul>
<QueueHeader title="To review" count={2} />
<ul className="kit-pr-queue">
<TaskRow lead={<BrandLead brand={brands.kemet} />} title="Kemet Home is below zero" meta="− EGP 8,400 · day 4 of 7" tag={<PrCountPill status="pauses_in" count={3} />} onOpen={() => {}} />
<TaskRow lead={<IconSquare name="star" tone="sky" />} title="Nile Threads requested a challenge" meta="Sell 30 in December · EGP 15,000" tag={<PrStatusPill status="new_request" />} onOpen={() => {}} />
<TaskRow lead={<IconSquare name="user" tone="lime" />} title="5 new creators to vet" meta="Pending until you approve them" tag={<PrCountPill status="waiting_count" count={5} />} onOpen={() => {}} />
</ul>
</Card>
</div>
);
}Actions and waiting time
ApprovalActions is the Approve / Reject pair on its own (busy disables it while a request runs); WaitingCell shows how long something has waited and turns urgent after the reminder thresholds.
Code
import { ApprovalActions, WaitingCell } from '@ergasti/bricks';
function Parts() {
return (
<div style={{ display: 'grid', gap: 14 }}>
<ApprovalActions onApprove={() => {}} onReject={() => {}} />
<ApprovalActions onApprove={() => {}} onReject={() => {}} busy size="sm" />
<div style={{ display: 'flex', gap: 24 }}>
<WaitingCell days={1} variant="cell" />
<WaitingCell days={3} variant="cell" />
<WaitingCell days={9} variant="cell" />
</div>
</div>
);
}Task rows: no lead, or an action
lead is optional (the title starts the row). action puts a control of the row's own where the chevron was (the Tiers screen's "Recent automatic moves" with "Change"); the row is then not one button, and with onOpen too the title becomes the open button, so no button sits inside another.
Code
import { Avatar, Button, Card, PrStatusPill, TaskRow } from '@ergasti/bricks';
function TaskRows() {
return (
<Card>
<ul className="kit-pr-queue">
<TaskRow title="Double commission week" meta="Every delivered sale · ×2 commission" tag={<PrStatusPill status="trndr_wide" />} onOpen={() => {}} />
<TaskRow lead={<Avatar name="Sara Ali" seed={1} />} title="Sara Ali" meta="Rising → Established · 2 days ago" action={<Button size="sm">Change</Button>} />
<TaskRow lead={<Avatar name="Hana Rami" seed={2} />} title="Hana Rami" meta="Established → Influential · 3 days ago" onOpen={() => {}} action={<Button size="sm">Change</Button>} />
</ul>
</Card>
);
}Task rows in Arabic
The chevron mirrors and the pills read in Arabic.
Code
import { BrandLead, Card, IconSquare, PrCountPill, TaskRow } from '@ergasti/bricks';
import { brands } from './pr';
function TaskRowsArabic() {
return (
<Card>
<ul className="kit-pr-queue" dir="rtl">
<TaskRow lead={<BrandLead brand={brands.kemet} />} title="Kemet Home تحت الصفر" meta="يوم 4 من 7" tag={<PrCountPill status="pauses_in" count={3} language="ar" />} onOpen={() => {}} />
<TaskRow lead={<IconSquare name="user" tone="lime" />} title="5 صنّاع محتوى جداد محتاجين مراجعة" meta="مستنيين موافقتك" tag={<PrCountPill status="waiting_count" count={5} language="ar" />} onOpen={() => {}} />
</ul>
</Card>
);
}Busy rows and named actions
While a request for a row runs, pass busy: the row dims, says it is busy to screen readers and its Approve / Reject are disabled. ApprovalActions shows short "Approve" / "Reject" text; approveLabel / rejectLabel give each button an accessible name that says which row it acts on (a table of many rows).
Code
import { ApprovalActions, ApprovalRow, Card } from '@ergasti/bricks';
import { joinRequests } from './pr';
function BusyAndNamed() {
const [j] = joinRequests;
return (
<div style={{ display: 'grid', gap: 14 }}>
<Card>
<ul className="kit-pr-queue">
<ApprovalRow creator={j.creator} brand={j.brand} source="Creator request" days={j.days} onApprove={() => {}} onReject={() => {}} onOpen={() => {}} busy />
</ul>
</Card>
<ApprovalActions onApprove={() => {}} onReject={() => {}} approveLabel={`Approve ${j.creator.name} into ${j.brand.name}`} rejectLabel={`Reject ${j.creator.name} from ${j.brand.name}`} size="md" />
</div>
);
}Full-width actions
In a drawer footer the pair should fill the width: fullWidth gives Reject and Approve equal halves, 10px apart (the PR mock's creator drawer). The default sizes the buttons to their words and keeps them at the end, for a table cell or a row. Default on top, fullWidth below, both in a 380px drawer-wide box.
Code
import { ApprovalActions } from '@ergasti/bricks';
import { joinRequests } from './pr';
function FullWidth() {
const [j] = joinRequests;
return (
<div style={{ display: 'grid', gap: 14, maxWidth: 380 }}>
<ApprovalActions onApprove={() => {}} onReject={() => {}} size="md" />
<ApprovalActions onApprove={() => {}} onReject={() => {}} size="md" fullWidth approveLabel={`Approve ${j.creator.name} into ${j.brand.name}`} rejectLabel={`Reject ${j.creator.name} from ${j.brand.name}`} />
</div>
);
}Full-width actions in Arabic
"ارفض" and "وافق" share the drawer footer; the order mirrors.
Code
import { ApprovalActions } from '@ergasti/bricks';
function FullWidthArabic() {
return (
<div style={{ maxWidth: 380 }}>
<ApprovalActions onApprove={() => {}} onReject={() => {}} size="md" fullWidth approveLabel="وافق على سارة علي في Glow Lab" rejectLabel="ارفض سارة علي في Glow Lab" />
</div>
);
}Section headers
QueueHeader puts a count after the title when you pass count; leave it out for a section that has no count. seeAllLabel renames "See all" for a link that goes somewhere specific (the brand page's "Stock requests →").
Code
import { Card, QueueHeader } from '@ergasti/bricks';
function Headers() {
return (
<Card>
<QueueHeader title="Join requests" count={5} onSeeAll={() => {}} />
<QueueHeader title="Gift stock" onSeeAll={() => {}} seeAllLabel="Stock requests →" />
<QueueHeader title="Recent activity" />
</Card>
);
}A tag on the age
ageTag puts a node after the waiting age's reminder line, in the row and in the table's WaitingCell: the PR mock's open-decision tag ("S1": when a reminder goes out) sits there.
Code
import { ApprovalRow, Card, DecisionTag, WaitingCell } from '@ergasti/bricks';
import { joinRequests } from './pr';
function AgeTag() {
const [j, k] = joinRequests;
return (
<Card>
<ul className="kit-pr-queue">
<ApprovalRow creator={j.creator} brand={j.brand} source="Creator request" days={j.days} onApprove={() => {}} onReject={() => {}} ageTag={<DecisionTag id="S1" variant="open" />} />
<ApprovalRow creator={k.creator} brand={k.brand} source="Creator request" days={k.days} onApprove={() => {}} onReject={() => {}} ageTag={<DecisionTag id="S1" variant="open" />} />
</ul>
<WaitingCell days={3} variant="cell" ageTag={<DecisionTag id="S1" variant="open" />} />
</Card>
);
}Props
Prop
Type
Design guidance
How the BRICKS design system uses BrandLead. Written in docs/content/components/BrandLead.md; the props above are read from the code, which wins where the two disagree.
A brand's square avatar sized as a queue row's lead; use it as TaskRow's lead for brand alerts ("Kemet Home is below zero").
It is a thin wrapper: BrandAvatar with the brand's name and color. Without a colour the square is ink (--ink).
Anatomy
- Square (
BrandAvatar, md 38px, radius--radius-md): the brand's initials in the display face on its colour (ink without one);aria-hidden.
Variants
brand.color | Look |
|---|---|
| set | The brand's colour. |
| omitted | Ink square (story NoColour). |
States
Static, decorative.
Types
StackBrand (brand): { id, name, color? }.
Usage
<TaskRow lead={<BrandLead brand={{ id: 'kemet', name: 'Kemet Home', color: '#6D4C41' }} />}
title="Kemet Home is below zero" meta="− EGP 8,400 · day 4 of 7"
tag={<PrCountPill status="pauses_in" count={3} />} onOpen={openBrand} />// PR Home › My brands mini list
<MiniList label="My brands">
{brands.map((b) => <MiniRow key={b.id} lead={<BrandLead brand={b} />} title={b.name} sub={`${b.creators} creators`} trailing={<WalletHealthPill health={b.health} />} />)}
</MiniList>Where it appears
- PR Portal › Home › To review (brand alerts) and My brands. Screen: PR · Home.
Guidelines
Do
- Pass the brand's colour from the server so squares match everywhere.
Don't
- Don't use it as a standalone brand identity; use
BrandCell(square and name).
RTL and Arabic
- No mirroring; Latin brand initials.
Tokens
--ink (no colour), --color-text-inverted, --radius-md, --font-family-display.
Accessibility
- Purely decorative: the square is
aria-hiddenand has no role or name, and it is not focusable. The row it leads (TaskRow,MiniRow) must name the brand in its title ("Kemet Home is below zero"). - In a
TaskRowthe whole row is one button; the lead adds nothing to its accessible name, so the title and meta carry the full message. - Colour comes from the brand's record and says nothing about state; status is the row's pill (
PrCountPill,WalletHealthPill), in words.
Found in the source
- ARIA attributes set:
aria-label,aria-busy,aria-hidden,aria-pressed. - Its tests cover: “a toggle button with the count and label; Enter toggles; Arabic”.
Read from the component's source and tests. See Accessibility for the patterns the library follows.
Related
See also: Avatar · Button · PrIcon · useLanguage · Money · QueueTile · Card · QueueHeader · ApprovalRow · PrCountPill · IconSquare · PrStatusPill
Source
src/pr/Approvals.tsx (line 209) on GitHub.