CreatorCell
The v3 table's creator cell (cName / person()): the profile picture (initials if none or it fails), the name, and one muted line under it: the
import { CreatorCell } from '@ergasti/bricks';Examples
Creator cell
A picture (initials if it is missing or fails), the name, the handle, a tier chip and a muted sub line. onOpen makes the name a button, still drawn bold (700) as the mocks draw every name.
Code
import { CreatorCell } from '@ergasti/bricks';
import { creators } from './sample-data';
function Creators() {
const [laila, karim, salma, , , , , , , , mona, omar] = creators;
return (
<div style={{ display: 'grid', gap: 14 }}>
<CreatorCell id={laila.id} name={laila.name} identity={laila.identity} tier="established" sub="201 orders" onOpen={() => {}} />
<CreatorCell id={salma.id} name={salma.name} identity={salma.identity} />
<CreatorCell id={mona.id} name={mona.name} identity={mona.identity} tier="rising" />
<CreatorCell id={omar.id} name={omar.name} identity={{ ...omar.identity, avatarUrl: 'data:image/png;base64,AAAA' }} tier="elite" />
<CreatorCell id={karim.id} name={null} identity={{ ...karim.identity, handle: null }} />
</div>
);
}Person cell
The plain name-and-handle cell; its avatarSrc and photo props are deprecated in favour of CreatorCell.
Code
import { PersonCell } from '@ergasti/bricks';
import { creators } from './sample-data';
function Person() {
const [laila] = creators;
return <PersonCell id={laila.id} name={laila.name} identity={laila.identity} sub="201 orders" />;
}Person cell options
onOpen makes the name a button, tier adds the tier chip, and photo with avatarSrc shows a picture (pass it only where the identity rules allow one).
Code
import { PersonCell } from '@ergasti/bricks';
import { creators } from './sample-data';
function PersonOptions() {
const c = creators[1];
return (
<div style={{ display: 'grid', gap: 12 }}>
<PersonCell id={c.id} name={c.name} identity={c.identity} tier={c.tier} photo avatarSrc={c.identity.avatarUrl ?? undefined} sub={`${c.orders} orders`} onOpen={() => {}} />
<PersonCell id={c.id} name={null} identity={{ ...c.identity, handle: null }} sub="Name hidden until they join" />
</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 personCell, or with the component's own prop where it has one. A {name} is a value the component fills in.
| Key | English | Arabic |
|---|---|---|
creator | Creator | صانع محتوى |
Design guidance
How the BRICKS design system uses CreatorCell. Written in docs/content/components/CreatorCell.md; the props above are read from the code, which wins where the two disagree.
The creator identity cell for v3 tables and lists: profile photo (or initials), bold name and one muted line with the @handle, tier chip and a short fact; use it wherever a row names a creator.
It is the mock's cName / person() cell, the first column of the brand creators, coupons, orders and gift-order tables, the Home "Top creators" list and the PR leaderboard and fraud screens. It applies the identity rule (CreatorIdentityMask): the @handle shows only for a creator this brand invited; a masked handle is never drawn, so a masked cell holds no "@" at all.
Anatomy
- Row:
span.kit-person.kit-ccell, flex, 10px gap. - Avatar:
Avatar(md),identity.avatarUrlor initials on a seeded tone; falls back to initials when the image fails.aria-hidden. - Name:
<b dir="auto">, 14px / 700, one line with ellipsis (wraps on phones); a.kit-lnkbutton with the same look whenonOpenis set. - Muted line (
.kit-psub, 12px--ink-3, 6px gaps, 3px under the name), shown when any of these exist:@handle,dir="ltr"(invited creators only);TierChip(whentieris passed, evennull);sub("201 orders", "Established · 201 orders").
Variants
| Setup | Look | When to use |
|---|---|---|
| Name only | Avatar + name | A masked creator with nothing else to say. |
tier | Tier chip in the muted line | Tables that show the tier inline (Analytics best creators, Home top creators). |
sub | Short fact after the chip | Orders, a niche, "Joined Mar 2025". |
onOpen | Name becomes a button | A list where only the name opens the drawer. |
States
| State | Trigger |
|---|---|
| With photo | identity.avatarUrl set. |
| No photo / broken photo | avatarUrl null, or the image errors: initials on the seed's tone. |
| Handle shown | identity.invitedByYou && identity.handle. |
| Masked | otherwise: no handle, no "@". |
| No name (deleted creator) | name={null}: shows the copy's "Creator" / "صانع محتوى". |
| Long name | one line with ellipsis; wraps under 860px (cards). |
| Focus-visible (openable) | kit focus ring on the name button. |
Types
CreatorIdentityProjection (identity): { handle, invitedByYou, links, avatarUrl } from the API; decides photo and handle.
tier: a tier key ('rising', 'established', 'influential', 'elite' in the TRNDR preset) for the TierChip.
Usage
// Brand › Creators › My creators table, first column
const columns: DataColumn<Creator>[] = [
{ key: 'creator', label: 'Creator', render: (c) => (
<CreatorCell id={c.id} name={c.name} identity={c.identity} tier={c.tier} sub={`${c.orders} orders`} />
) },
{ key: 'score', label: 'Score', render: (c) => <ScoreRing value={c.score} /> },
{ key: 'sales', label: 'Sales', align: 'end', render: (c) => <Money value={c.sales} compact /> },
];
<DataTable label="My creators" columns={columns} rows={creators} rowKey={(c) => c.id} onRowClick={(c) => openCreator(c.id)} />// Home › Top creators this month
<Card title="Top creators this month">
<RankList label="Top creators this month" items={top.map((c) => ({
id: c.id,
lead: <CreatorCell id={c.id} name={c.name} identity={c.identity} tier={c.tier} />,
value: <Money value={c.sales} compact />,
}))} />
</Card>// Outside a table: the name opens the drawer
<CreatorCell id={7} name="Laila Saeed" identity={laila.identity} sub="Beauty" onOpen={() => openCreator(7)} />Where it appears
- In the v3 mocks: Brand › Creators › My creators and Join requests tables (BrandCreators); Brand › Home › Top creators this month (BrandHome); Brand › Coupons › coupons table (BrandCoupons); Brand › Motivation › gift orders; Brand › Payments › Commissions › orders; Brand › Analytics › Best creators (BrandAnalytics); PR Portal › Leaderboard.
- Library only: the PR fraud case rows and detail (
FraudCaseRow,FraudCaseDetail); no fraud screen exists in the v3 mocks.
Guidelines
Do
- Pass the API's
identityunchanged; never build a handle yourself. - Keep
subto one short fact.
Don't
- Don't use
onOpenin a row that is already clickable (nested interactive elements). - Don't add a photo from another source; the identity rules decide when one may show.
- Don't use the deprecated
PersonCellin new code.
RTL and Arabic
- Flex row mirrors: avatar at the inline start.
- Arabic names render in their own direction (
dir="auto"); the @handle stays LTR. - Fallback name in Arabic: "صانع محتوى".
Tokens
--ink-3, --rasp-d (handle link), --focus-ring, --min-touch-target; avatar tones from Avatar.
Accessibility
- Avatar is
aria-hidden; the name is the accessible text. - With
onOpenthe name is a<button type="button">; on touch tiers (≤1024px) its hit area extends to 44px (--min-touch-target), on desktop it is the text's size. - Name and handle use
dir="auto"/dir="ltr"so mixed scripts read correctly.
Found in the source
- No roles, ARIA attributes or key handling are set in this component's own source; it renders native elements and the components it composes.
Read from the component's source and tests. See Accessibility for the patterns the library follows.
Related
PersonCell: deprecated 0.1.x cell (initials by default, a linked handle).ProductCell: the product counterpart.BrandCell(PR Portal): the brand counterpart.TierChip,Avatar: its parts.
See also: BulkBar · CopyLink · DataTable · FilterChips
Source
src/kit/patterns/PersonCell.tsx (line 63) on GitHub.