Skip to Content
BBRICKSv0.7.4
BlocksCreators

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.

findCreatorCard
KeyEnglishArabic
scoreScoreالتقييم
soldSold · 90 daysاتباع · 90 يوم
ordersOrdersالطلبات
engagementEngagementالتفاعل
followersfollowersمتابع
inviteInviteادعُ
invitedInvited ✓تمت الدعوة ✓
inviteNameInvite {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

  1. Card: article.kit-blk-fc, flex column, 16px gap, 1px line, white.
  2. Hit button: .kit-blk-hit over the card, aria-label = name, opens the profile.
  3. Top row: 64px photo (radius 20, ring); name h3 (display 16 / 700, one line); TierChip + niche Pill; ScoreRing with a tiny "SCORE" caption.
  4. Highlight: HighlightBadge (optional).
  5. Stat row: .kit-blk-fc-st, one soft box per stat (value 15 / 800 over an 11px label); unknown values dimmed.
  6. Footer: hairline above; FollowerLine (total + platform glyphs) and the small Invite button.

Variants

SetupLookWhen to use
Built-in statsSold · 90 days (when sales90), Orders (when orders90), EngagementBrand Find creators.
stats list / functionYour boxes (e.g. Engagement, Followers, On TRNDR since)Pool card without cross-store figures.
No onInviteNo Invite buttonRead-only.
moneySold display (default compact "EGP 212.0K")Change the format.

States

StateTrigger
Default / hoverhover lifts 2px, border --rasp-100, shadow.
Invitinginviting: Invite aria-busy, ignored clicks.
Invitedinvited: "Invited ✓", named "Laila Saeed is invited".
No seatsinviteDisabled + inviteDisabledReason: off look, aria-disabled, tooltip and description give the reason.
Unknown engagementengagement: null: "—", dimmed box.
No scorescore: 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 inviteDisabledReason whenever inviteDisabled is 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 via aria-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.

See also: Avatar · Icon · MoneyNote · Money · Pill · Button · useBricks · useLanguage · useMoneyDisplay

Source

src/blocks/creators/FindCreatorCard.tsx (line 119) on GitHub.

On this page