Skip to Content
BBRICKSv0.7.4
KitPrimitives

FollowersCell

The v3 mock's .fol: the follower total (Jakarta 17/800, "48.2K") over the glyph of each platform the creator is on. Only the provider's platforms count and show. Each glyph's count is in its tooltip and read out ("Instagram 48.2K"), so the split is never colour or icon only.

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

Examples

Followers cell

Totals with a per-platform breakdown; a platform with null or 0 is left out.

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

function Cell() {
  return <FollowersCell followers={{ instagram: 143000, tiktok: 310000, youtube: 56000 }} />;
}

Platform pill and list

One platform with its count, or every platform a creator has.

Code
import { PlatformFollowers, PlatformPill } from '@ergasti/bricks';

function Pills() {
  return (
    <div style={{ display: 'grid', gap: 12 }}>
      <PlatformPill platform="instagram" count={48200} />
      <PlatformFollowers followers={{ instagram: 48200, tiktok: 120300, youtube: null }} />
    </div>
  );
}

Props

Prop

Type

Labels

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

followersCell
KeyEnglishArabic
followersfollowersمتابع
platforms
KeyEnglishArabic
instagramInstagramانستجرام
tiktokTikTokتيك توك
youtubeYouTubeيوتيوب

Design guidance

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

A table cell showing a creator's total followers ("48.2K") over a small glyph for each platform they are on; use it as the Followers column.

FollowersCell is the v3 mock's .fol: the compact total in Jakarta 17/800 above a row of 13px platform glyphs (Instagram, TikTok, YouTube) in muted ink. Only the platforms the provider lists in platforms count and show, and only those with a positive count get a glyph. Each glyph's count is in its tooltip and read aloud ("Instagram 48.2K"), so the split never relies on an icon alone.

Anatomy

  1. Wrapper (span.kit-fol): column, centred, 5px gap.
  2. Total (b, dir="ltr"): compact sum + hidden " followers".
  3. Platforms (span.kit-mplats): one Icon per platform with followers, title and hidden text "Instagram 48.2K".

Variants

None. What shows depends on data and the provider's platforms.

States

StateTriggerLook
Several platformscounts on 2–3Total + 2–3 glyphs
One platformone countTotal + one glyph
Noneall 0 / null / missing"0" and no glyph row
Platform turned offnot in provider platformsExcluded from total and glyphs

Types

Helper: followerTotal(followers, platforms?) returns the sum used for the total.

Usage

interface Creator { id: number; name: string; ig: number | null; tt: number | null }
const columns: DataColumn<Creator>[] = [
  { key: 'name', label: 'Creator', primary: true, render: (c) => <b>{c.name}</b> },
  { key: 'followers', label: 'Followers', sortKey: 'followers', align: 'center',
    render: (c) => <FollowersCell followers={{ instagram: c.ig, tiktok: c.tt }} /> },
];

Within the My creators table:

<DataTable label="My creators" rowKey={(c) => c.id} rows={rows} columns={[
  { key: 'creator', label: 'Creator', primary: true, render: (c) => <CreatorCell id={c.id} name={c.name} identity={c.identity} /> },
  { key: 'tier', label: 'Tier', render: (c) => <TierChip tier={c.tier} /> },
  { key: 'score', label: 'Score', render: (c) => <ScoreRing value={c.score} /> },
  { key: 'followers', label: 'Followers', render: (c) => <FollowersCell followers={c.followers} /> },
  { key: 'sales', label: 'Sales', align: 'end', render: (c) => <Money value={c.sales} /> },
]} footer={<Pager {...pager} />} />

Where it appears

  • Brand › Creators › My creators and Join requests tables (Followers column).
  • PR Portal › Creators table; PR Portal › Approvals › New creators table.
  • Screens: Creators, PR · Creators, PR · Approvals.

Guidelines

Do

  • Pass raw integers; it compacts them.
  • Set the provider's platforms to the platforms the app works with.

Don't

RTL and Arabic

  • The total is dir="ltr"; the glyph row follows the page direction.
  • Arabic names: "انستجرام", "تيك توك", "يوتيوب"; word "متابع".

Tokens

--font-family-display (total), --ink-3 (glyphs), --lh-ar (Arabic line height of the total).

Accessibility

  • Read as "48.2K followers, Instagram 48.2K, TikTok 12K"; glyphs are not the only carrier.
  • Each glyph also has a title tooltip for mouse users.

Found in the source

  • Its tests cover: “has nothing focusable”.

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

See also: useBricks · Icon · Avatar · AvatarStack · Button · ButtonLink

Source

src/kit/primitives/FollowersCell.tsx (line 25) on GitHub.

On this page