Skip to content
Cook
Documentation Browse

Design

Navigation and data

Active Rail, Card, Table, Activity Log, Avatar, Approval Card and Brand Icons: how Cook lays out a workspace and shows its work.

Active Rail

The primary navigation is a rail beside the page. It never eats vertical space. The active row gets a Cook blue bar and a duotone icon.

Workspace rail

AAtlas Growth Co
Morning Brief3
Chat
Drive
Funnels
CRM
Routines
Playbooks
Client Portal
<Rail.Root value={active} onValueChange={setActive}>
  <Rail.Item value="brief" icon={MorningBriefIcon} badge={3}>Morning Brief</Rail.Item>
  <Rail.Item value="chat" icon={DirectChatIcon}>Chat</Rail.Item>
  <Rail.Item value="funnels" icon={FunnelIcon}>Funnels</Rail.Item>
</Rail.Root>

Icon rail

The collapsed rail. A solid icon marks the active tab.

<Rail.Root collapsed>
  <Rail.Item value="home" icon={HomeIcon} activeIcon={<HomeIcon variant="solid" />} />
</Rail.Root>

Properties

PropTypeDefaultDescription
valuestring—Controlled active item.
onValueChange(value: string) => void—Called when a row is pressed.
collapsedbooleanfalseIcon-only rail with tooltips.
badgenumber | string—Count shown at the row end.

Card

Cards are white on the weak backdrop with a 1px hairline. No nested cards, no gradients.

Stat cards

Booked calls36+1248h
Leads answered214+38%avg 2m 14s
Ad spend$1,812−6%of $2,000 cap
<StatCard icon={BookCallIcon} label="Booked calls" value={36} delta="+12" caption="48h" />

Department card

Client SuccessClient Success
Onboards every client, checks in before they ask, and flags churn early.3 onboarding1 at risk
<DepartmentCard deptKey="clientsuccess" />

Properties

PropTypeDefaultDescription
variant"default" | "weak""default"White or weak surface.
interactivebooleanfalseHover border and pointer.

Table

Tables are for scanning. Keep columns few, align numbers right, and put status in a badge.

Leads

Leads5 leadsFilterAdd lead
Name ↓SourceStatusLast touchScore
DRDana ReyesMeta · Storm damageBookedThu 10:3092
MLMarcus LeeGoogle · Roof repairQualified2h ago81
PSPriya ShahFunnel · InspectionNew14m ago64
TBTom BeckerMeta · Storm damageWent quiet3d ago38
AOAna OrtizReferralBookedFri 09:0088
<Table.Root>
  <Table.Header>
    <Table.Row><Table.Head sortable>Name</Table.Head>…</Table.Row>
  </Table.Header>
  <Table.Body>{leads.map((l) => <LeadRow key={l.id} lead={l} />)}</Table.Body>
</Table.Root>

Activity Log

Every action lands in the log with the reason. You wake up to a brief, not a backlog.

One night on the platform

Activity logAllMarketingSalesResearch
02:14marketingPaused 3 fatigued adsCTR fell below 0.6% on “Storm damage v2”.
02:15marketingMoved $40/day to winners“Roof Repair · Winners” at 4.2× ROAS.
03:41salesBooked a call with Dana R.Thu 10:30 on your Google Calendar.
04:02salesReplied to 9 new leadsAverage first reply in 2m 14s.
05:30researchFound 2 new anglesInsurance-claim confusion up 31% on r/Roofing.
06:00staffPosted the morning briefTo #chief-of-staff and Slack.
<ActivityLog.Root filter={dept}>
  {events.map((e) => (
    <ActivityLog.Item key={e.id} time={e.at} dept={e.dept} icon={e.icon} title={e.title} reason={e.reason} />
  ))}
</ActivityLog.Root>

Avatar

Every avatar is round. A department avatar puts the face on its pastel ground; a person’s avatar uses initials on a neutral ground.

Sizes

Research20
Research24
Research32
Research40
Research56
Research72
<AgentAvatar deptKey="research" size={40} />

Group and status

A stack shows who worked a thread. The dot marks live activity.

Chief of StaffResearchMarketingSalesClient Success+3
MarketingSG
<AvatarGroup max={5}>
  {departments.map((d) => <AgentAvatar key={d} deptKey={d} size={36} />)}
</AvatarGroup>
<AgentAvatar deptKey="marketing" status="live" />

Properties

PropTypeDefaultDescription
deptKeyDeptKey—One of the 8 department keys.
sizenumber32Pixel size. Always a circle.
status"live" | "idle" | "off"—Optional activity dot.

Approval Card

Work that spends money or reaches someone outside your team waits here. The card spells out the change before anything happens. See How to approve work.

Budget change

MarketingMarketing wants to increase budget · 2m agoNeeds approval
Increase “Roof Repair · Winners” budget by 15%
Daily budget$120.00$138.00ReasonROAS 4.2× over 3 days, CPA $38 vs $61 target
ApproveReject

Resolved, the card says what happened: Approved by you · Marketing applied the change, or Rejected · Marketing kept $120.00.

<ApprovalCard
  dept="marketing"
  title="Increase “Roof Repair · Winners” budget by 15%"
  diff={[{ label: "Daily budget", from: "$120.00", to: "$138.00" }]}
  onApprove={approve}
  onReject={reject}
/>

Outbound message

A message to people outside the team shows the audience and the first line.

SalesSales wants to send a sequence · nowNeeds approval
Send “Spring inspection” email to 214 leads
“Hi {first_name}, the hail season left a lot of roofs in Plano worse than they look…”
Approve and sendReject

Resolved: Sending to 214 leads · first replies in #sales, or Rejected · nothing was sent.

<ApprovalCard dept="sales" kind="message" audience={214} preview={firstLine} />

Properties

PropTypeDefaultDescription
deptDeptKey—The department that asked. Draws its face.
titlestring—The change in one sentence.
diff{ label, from, to }[]—Before and after values.
kind"spend" | "message" | "rule" | "delete""spend"What the gate is holding.
onApprove / onReject() => Promise<void>—Resolve the request.

Brand Icons

An integration mark renders in full colour on a neutral tile. Use one only to name a third-party service.

Integrations

GoHighLevelGoHighLevelMeta AdsMeta AdsGoogleGoogleGoogle AdsGoogle AdsGoogle CalendarGoogle CalendarGmailGmailSlackSlackDiscordDiscordZoomZoomStripeStripeClaudeClaudeOpenAIOpenAIHubSpotHubSpotShopifyShopifyNotionNotionWhopWhopYouTubeYouTubeInstagramInstagramXXLinkedInLinkedIn
<BrandIcon name="slack" size={20} />

Connect row

The pattern used in Integrations and the connect wizard.

GoHighLevelGoHighLevelPipelines and conversationsConnected
Meta AdsMeta AdsLaunch and read ad setsConnected
GoogleGoogleCalendar, Gmail, DriveConnect
SlackSlackRun it from the chatConnect
<IntegrationRow provider="meta" status="connected" />

Don't recolour a third-party mark or use it as a decorative icon. Use a cookicon for a generic action.