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
<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
| Prop | Type | Default | Description |
|---|---|---|---|
value | string | — | Controlled active item. |
onValueChange | (value: string) => void | — | Called when a row is pressed. |
collapsed | boolean | false | Icon-only rail with tooltips. |
badge | number | 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
<StatCard icon={BookCallIcon} label="Booked calls" value={36} delta="+12" caption="48h" />
Department card
<DepartmentCard deptKey="clientsuccess" />
Properties
| Prop | Type | Default | Description |
|---|---|---|---|
variant | "default" | "weak" | "default" | White or weak surface. |
interactive | boolean | false | Hover border and pointer. |
Table
Tables are for scanning. Keep columns few, align numbers right, and put status in a badge.
Leads
| Name ↓ | Source | Status | Last touch | Score | |
|---|---|---|---|---|---|
| DRDana Reyes | Meta · Storm damage | Booked | Thu 10:30 | 92 | |
| MLMarcus Lee | Google · Roof repair | Qualified | 2h ago | 81 | |
| PSPriya Shah | Funnel · Inspection | New | 14m ago | 64 | |
| TBTom Becker | Meta · Storm damage | Went quiet | 3d ago | 38 | |
| AOAna Ortiz | Referral | Booked | Fri 09:00 | 88 |
<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
<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
<AgentAvatar deptKey="research" size={40} />
Group and status
A stack shows who worked a thread. The dot marks live activity.
<AvatarGroup max={5}>
{departments.map((d) => <AgentAvatar key={d} deptKey={d} size={36} />)}
</AvatarGroup>
<AgentAvatar deptKey="marketing" status="live" />
Properties
| Prop | Type | Default | Description |
|---|---|---|---|
deptKey | DeptKey | — | One of the 8 department keys. |
size | number | 32 | Pixel 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
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.
Resolved: Sending to 214 leads · first replies in #sales, or Rejected · nothing was sent.
<ApprovalCard dept="sales" kind="message" audience={214} preview={firstLine} />
Properties
| Prop | Type | Default | Description |
|---|---|---|---|
dept | DeptKey | — | The department that asked. Draws its face. |
title | string | — | 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
<BrandIcon name="slack" size={20} />
Connect row
The pattern used in Integrations and the connect wizard.
<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.