Skip to Content
BBRICKSv0.7.4
KitLists and tables

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.

personCell
KeyEnglishArabic
creatorCreatorصانع محتوى

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

  1. Row: span.kit-person.kit-ccell, flex, 10px gap.
  2. Avatar: Avatar (md), identity.avatarUrl or initials on a seeded tone; falls back to initials when the image fails. aria-hidden.
  3. Name: <b dir="auto">, 14px / 700, one line with ellipsis (wraps on phones); a .kit-lnk button with the same look when onOpen is set.
  4. Muted line (.kit-psub, 12px --ink-3, 6px gaps, 3px under the name), shown when any of these exist:
    1. @handle, dir="ltr" (invited creators only);
    2. TierChip (when tier is passed, even null);
    3. sub ("201 orders", "Established · 201 orders").

Variants

SetupLookWhen to use
Name onlyAvatar + nameA masked creator with nothing else to say.
tierTier chip in the muted lineTables that show the tier inline (Analytics best creators, Home top creators).
subShort fact after the chipOrders, a niche, "Joined Mar 2025".
onOpenName becomes a buttonA list where only the name opens the drawer.

States

StateTrigger
With photoidentity.avatarUrl set.
No photo / broken photoavatarUrl null, or the image errors: initials on the seed's tone.
Handle shownidentity.invitedByYou && identity.handle.
Maskedotherwise: no handle, no "@".
No name (deleted creator)name={null}: shows the copy's "Creator" / "صانع محتوى".
Long nameone 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 identity unchanged; never build a handle yourself.
  • Keep sub to one short fact.

Don't

  • Don't use onOpen in 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 PersonCell in 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 onOpen the 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.

See also: BulkBar · CopyLink · DataTable · FilterChips

Source

src/kit/patterns/PersonCell.tsx (line 63) on GitHub.

On this page