FindCreatorCard
The Find creators card (.fc): the photo (64, radius 20), name, tier and niche, the TRNDR score, one highlight, the stat row (built in: sold in 90 days and orders when given, engagement; stats replaces or edits it), the follower total with its platforms, and Invite (then "Invited ✓"). The card opens the mini profile; Invite is its own button.
import { FindCreatorCard } from '@ergasti/bricks';Examples
Find creators
A discover card: avatar, tier, niche, score, a highlight, the follower line and last-90-day numbers, with Invite (and "Invited" afterwards). The card opens the profile.
Code
import { useState } from 'react';
import { FindCreatorCard, useLanguage } from '@ergasti/bricks';
import { blocksData } from './sample-data';
function Cards() {
const language = useLanguage();
const [invited, setInvited] = useState<number[]>([]);
const find = (c: (typeof blocksData.DISCOVER)[number]) => ({ ...c, niche: language === 'ar' ? c.nicheAr : c.niche, highlight: c.highlight && { ...c.highlight, text: language === 'ar' ? blocksData.HIGHLIGHT_AR[c.highlight.text] ?? c.highlight.text : c.highlight.text } });
return (
<div style={{ display: 'grid', gap: 16, gridTemplateColumns: 'repeat(auto-fill, minmax(min(100%, 280px), 1fr))' }}>
{blocksData.DISCOVER.slice(0, 3).map((c) => (
<FindCreatorCard key={c.id} creator={find(c)} invited={invited.includes(c.id)} onOpen={() => {}} onInvite={() => setInvited((v) => [...v, c.id])} />
))}
</div>
);
}Follower line
Followers by platform on one line, as used inside the card.
Code
import { FollowerLine } from '@ergasti/bricks';
function Followers() {
return <FollowerLine followers={{ instagram: 143000, tiktok: 310000, youtube: 56000 }} />;
}No seats left
inviteDisabled keeps Invite visible but not pressable (the brand's plan is full); an invited card shows "Invited" instead.
Code
import { FindCreatorCard } from '@ergasti/bricks';
import { blocksData } from './sample-data';
function SeatsFull() {
const c = blocksData.DISCOVER[0];
return (
<div style={{ display: 'grid', gap: 16, gridTemplateColumns: 'repeat(auto-fill, minmax(min(100%, 280px), 1fr))' }}>
<FindCreatorCard creator={{ ...c, highlight: undefined }} onOpen={() => {}} onInvite={() => {}} inviteDisabled />
<FindCreatorCard creator={{ ...c, highlight: undefined }} onOpen={() => {}} invited />
</div>
);
}Your own stats, invite states
stats replaces the stat row (here no cross-store figures: Engagement, Followers, On TRNDR since) or edits it as a function; a creator without sales90 / orders90 shows Engagement only. inviting makes Invite busy; inviteDisabledReason explains a disabled Invite.
Code
import { FindCreatorCard } from '@ergasti/bricks';
import { blocksData } from './sample-data';
function PoolCards() {
const c = blocksData.DISCOVER[0];
const stats = [{ key: 'eng', label: 'Engagement', value: '3.4%' }, { key: 'fol', label: 'Followers', value: '24.3K' }, { key: 'since', label: 'On TRNDR since', value: 'Mar 2026' }];
return (
<div style={{ display: 'grid', gap: 16, gridTemplateColumns: 'repeat(auto-fill, minmax(min(100%, 290px), 1fr))' }}>
<FindCreatorCard creator={c} stats={stats} onOpen={() => {}} onInvite={() => {}} inviting />
<FindCreatorCard creator={{ ...c, sales90: null, orders90: null }} onOpen={() => {}} onInvite={() => {}} inviteDisabled inviteDisabledReason="No seats left" />
</div>
);
}The mock's stat columns
Set the CSS hook --fc-cols on the card's parent to fix the stat row's columns: 1.35fr 1fr 1fr draws the brand mock's three figures, with Orders and Engagement the same width. Leave it unset (the first card) and each stat takes the width of its words.
Code
import { type CSSProperties } from 'react';
import { FindCreatorCard, useLanguage } from '@ergasti/bricks';
import { blocksData } from './sample-data';
function StatColumns() {
const language = useLanguage();
const c = blocksData.DISCOVER[0];
const creator = { ...c, niche: language === 'ar' ? c.nicheAr : c.niche };
return (
<div style={{ display: 'grid', gap: 16, gridTemplateColumns: 'repeat(auto-fill, minmax(min(100%, 290px), 1fr))' }}>
<FindCreatorCard creator={creator} onOpen={() => {}} onInvite={() => {}} />
<div style={{ '--fc-cols': '1.35fr 1fr 1fr' } as CSSProperties}>
<FindCreatorCard creator={creator} onOpen={() => {}} onInvite={() => {}} />
</div>
</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 findCreatorCard, or with the component's own prop where it has one. A {name} is a value the component fills in.
| Key | English | Arabic |
|---|---|---|
score | Score | التقييم |
sold | Sold · 90 days | اتباع · 90 يوم |
orders | Orders | الطلبات |
engagement | Engagement | التفاعل |
followers | followers | متابع |
invite | Invite | ادعُ |
invited | Invited ✓ | تمت الدعوة ✓ |
inviteName | Invite {n} | ادعُ {n} |
invitedName | {n} is invited | {n} اتبعتله دعوة |
Design guidance
How the BRICKS design system uses FindCreatorCard. Written in docs/content/components/FindCreatorCard.md; the props above are read from the code, which wins where the two disagree.
The Find creators grid card: photo, name, tier and niche, TRNDR score, one highlight, a stat row, followers by platform and Invite; use it in the Find creators card grid, where the card opens the creator's mini profile.
It is the mock's findCard() (.fc): 18px padding, --r-lg, lifts on hover. The whole card is a button (an overlay named by the creator's name) that opens CreatorProfilePanel; Invite is its own button that goes invite → sending → "Invited ✓" without ever being natively disabled. The stat row's built-in stats appear only when the server sends the figure; stats replaces or edits them (the console's pool card).
Anatomy
- Card:
article.kit-blk-fc, flex column, 16px gap, 1px line, white. - Hit button:
.kit-blk-hitover the card,aria-label= name, opens the profile. - Top row: 64px photo (radius 20, ring); name
h3(display 16 / 700, one line);TierChip+ nichePill;ScoreRingwith a tiny "SCORE" caption. - Highlight:
HighlightBadge(optional). - Stat row:
.kit-blk-fc-st, one soft box per stat (value 15 / 800 over an 11px label); unknown values dimmed. - Footer: hairline above;
FollowerLine(total + platform glyphs) and the small Invite button.
Variants
| Setup | Look | When to use |
|---|---|---|
| Built-in stats | Sold · 90 days (when sales90), Orders (when orders90), Engagement | Brand Find creators. |
stats list / function | Your boxes (e.g. Engagement, Followers, On TRNDR since) | Pool card without cross-store figures. |
No onInvite | No Invite button | Read-only. |
money | Sold display (default compact "EGP 212.0K") | Change the format. |
States
| State | Trigger |
|---|---|
| Default / hover | hover lifts 2px, border --rasp-100, shadow. |
| Inviting | inviting: Invite aria-busy, ignored clicks. |
| Invited | invited: "Invited ✓", named "Laila Saeed is invited". |
| No seats | inviteDisabled + inviteDisabledReason: off look, aria-disabled, tooltip and description give the reason. |
| Unknown engagement | engagement: null: "—", dimmed box. |
| No score | score: null: empty ring. |
Types
FindCreator (creator): id, name, avatarUrl?, tier, niche?, score, highlight? ({ kind, text }), sales90? (2-dp), orders90?, engagement (% or null), followers.
FindStat (stats): { key, label, value, none?, figure? } boxes. FindCardCopy (labels): score, sold, orders, engagement, followers, invite, invited, inviteName(n), invitedName(n).
Usage
// Brand › Find creators: seats banner, toolbar, card grid, pager
const creators: FindCreator[] = page.rows;
<Banner tone="info" icon="seat"><b>79 seats left.</b> Invite creators to fill them.</Banner>
<ListToolbar search={search} selects={filters} sort={sort} />
<DataTable<FindCreator> mode="cards" label="Creators" rows={creators} rowKey={(c) => c.id} columns={[]}
renderCard={(c) => (
<FindCreatorCard creator={c} onOpen={() => setOpen(c.id)}
invited={invited.has(c.id)} inviting={sending === c.id} onInvite={() => invite(c.id)}
inviteDisabled={seatsLeft === 0} inviteDisabledReason="No seats left" />
)} />
<Pager page={page} lastPage={lastPage} total={total} perPage={12} loading={loading} label="Creators" onPage={setPage} />Where it appears
- Brand › Find creators › card grid (
findCard()) (BrandFindCreators).
Guidelines
Do
- Show one highlight at most; pick the server's strongest.
- Give
inviteDisabledReasonwheneverinviteDisabledis set.
Don't
- Don't nest other buttons in the card; only Invite sits above the hit area.
- Don't show handles or contact details.
RTL and Arabic
- Mirrors; values LTR. The SCORE caption drops letter-spacing in RTL. Arabic: "اتباع · 90 يوم", "ادعُ", "تمت الدعوة ✓", "متابع".
Tokens
--card, --line, --r-lg, --rasp-100, --soft, --ink, --ink-2, --ink-3, --font-family-display; highlight and tier colours from their components.
Accessibility
- The card's hit button is named by the creator's name; Invite is a separate button named "Invite Laila Saeed" / "Laila Saeed is invited".
- Invite uses
aria-disabled, keeping focus; the reason is read viaaria-describedby. - Platform glyphs carry hidden text ("Instagram 143K").
Found in the source
- ARIA attributes set:
aria-label,aria-hidden,aria-disabled,aria-busy,aria-describedby.
Read from the component's source and tests. See Accessibility for the patterns the library follows.
Related
CreatorProfilePanel: what the card opens.HighlightBadge,FollowerLine,ScoreRing,TierChip: its parts.CreatorCell: the table cell for creators already in the program.
See also: Avatar · Icon · MoneyNote · Money · Pill · Button · useBricks · useLanguage · useMoneyDisplay
Source
src/blocks/creators/FindCreatorCard.tsx (line 119) on GitHub.