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.
| Key | English | Arabic |
|---|---|---|
followers | followers | متابع |
| Key | English | Arabic |
|---|---|---|
instagram | انستجرام | |
tiktok | TikTok | تيك توك |
youtube | YouTube | يوتيوب |
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
- Wrapper (
span.kit-fol): column, centred, 5px gap. - Total (
b,dir="ltr"): compact sum + hidden " followers". - Platforms (
span.kit-mplats): oneIconper platform with followers,titleand hidden text "Instagram 48.2K".
Variants
None. What shows depends on data and the provider's platforms.
States
| State | Trigger | Look |
|---|---|---|
| Several platforms | counts on 2–3 | Total + 2–3 glyphs |
| One platform | one count | Total + one glyph |
| None | all 0 / null / missing | "0" and no glyph row |
| Platform turned off | not in provider platforms | Excluded 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
platformsto the platforms the app works with.
Don't
- Don't pre-format counts as strings.
- Don't use it outside tables;
PlatformFollowers/PlatformPillread better in cards.
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
titletooltip 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.
Related
PlatformFollowers: per-platform counts side by side.PlatformPill: one platform as a pill.FollowerBars/FollowerLine: follower breakdowns in panels.
See also: useBricks · Icon · Avatar · AvatarStack · Button · ButtonLink
Source
src/kit/primitives/FollowersCell.tsx (line 25) on GitHub.