# Karma Design System

**Version 1.0 · 30 Oct 2026 · Owner: Shiju Shaji (IT)**

Use this for every internal page, dashboard, report, form or tool you build, whether by hand, by your team or with Claude. Everything you need is here: colours, fonts, spacing, every component, charts, icons, motion and wording.

---

## 0. How to use this with Claude (or any AI tool)

Paste this at the start of your request, and attach or paste this file:

> Follow `DESIGN_SYSTEM.md` exactly. Use only the colours, fonts, spacing, radii, shadows, components, icons, chart styles and animations it defines. Start from the **Starter CSS** in section 14. Do not invent new colours, fonts, button styles or effects. If something you need isn't covered, build it from the existing tokens and components, and tell me what you added.

For a team member, the short version: **use the starter CSS, the components in section 7, and the rules in section 13.**

---

## 1. Design principles

1. **Quiet luxury.** Black, cream and bronze, with lots of white space. Colour is used sparingly so it means something.
2. **Serif for numbers and headlines, sans-serif for everything else.** Big numbers are always in the serif font.
3. **One accent: bronze.** Red appears only for problems such as overdue, damaged or missing. Green appears only for something done or returned.
4. **Rounded and soft.** Pills for controls, 12–16 px radius for surfaces, no sharp corners.
5. **Motion with purpose.** Content rises in, charts draw in, numbers count up. Everything finishes within about 1.3 s, and it all switches off for people who turn on "reduce motion".
6. **Plain language.** Write "Who's out", not "Active checkout records".

---

## 2. Brand and logo

| Asset | Where | Use |
|---|---|---|
| Karma Group logo (gold K + wordmark, transparent background) | `assets/karma-group-logo.webp` (248×104) | Top left of the black header, 52 px tall (32 px on phones) |
| Embedded version | The same file as a base64 data URL: `<img class="logo" src="data:image/webp;base64,…">` | Use this where you can't load local files (e.g. Apps Script / HtmlService) |

Rules:
- Put the logo only on black (`#000` or `--black`). Never on cream or white.
- Never recolour, stretch, add a shadow, or set it in text instead of using the image.
- Next to the logo, use a gradient vertical rule and a two-line product name: the title in serif small caps with wide spacing, and a bronze eyebrow line below it. See the Header in section 7.1.

---

## 3. Colour

### 3.1 Tokens (use these names; never hard-code new values)

| Token | Value | Use |
|---|---|---|
| `--black` | `#0d0c0a` | Hero blocks, dark tiles, active controls, avatars, tooltips |
| *(header)* | `#000000` | Top header bar only |
| `--plane` | `#faf8f4` | Page background (cream) |
| `--card` | `#ffffff` | Cards, rows, inputs |
| `--ink` | `#0b0b0b` | Main text |
| `--ink2` | `#52514e` | Secondary text, labels |
| `--muted` | `#898781` | Hints, captions, axis labels, placeholders |
| `--grid` | `#ebe8e1` | Chart gridlines, faint dividers |
| `--axis` | `#c3c2b7` | Chart baselines, dashed empty-state borders |
| `--ring` | `rgba(11,11,11,.08)` | Default 1 px border on every surface |
| `--bronze` | `#8c7451` | **Primary accent.** Links, icons in cards, line charts, focus |
| `--bronze-lt` | `#c2a878` | Accent on dark backgrounds, active nav underline, badge counts |
| `--bronze-wash` | `#f6f1e8` | Soft accent backgrounds: icon tiles, tags |
| `--gold` | `#a8781a` | Rank #1, rare emphasis only |
| `--crit` | `#d03b3b` | Errors, overdue, damaged |
| `--crit-wash` | `#fdeceb` | Background behind red content |
| `--good` | `#1e7a43` | Done, returned, success |
| `--good-wash` | `#e9f6ee` | Background behind green content |

On dark surfaces (header, band, hero):

| Use | Value |
|---|---|
| Main text on dark | `#ffffff` (numbers, titles) / `#f0efec` (body) |
| Secondary text on dark | `#b9b5aa` |
| Faint text on dark | `#8f8a7e` |
| Inactive nav text | `#cfccc3` |
| Dividers on dark | `#211d16` / `#2a251c` |
| Icon tile on dark | background `#1b1710`, border `#2a251c`, icon `--bronze-lt` |
| Red on dark | text `#ef8a7a`, tile `#3a1512`, border `#5a1f1a` |
| Green "live" on dark | text `#9fe09f`, dot `#5fd35f`, border `#2e4a2e` |

### 3.2 Gradients (the only ones allowed)

| Name | CSS | Where |
|---|---|---|
| Band | `linear-gradient(180deg,#0d0c0a,#17140f)` | Page title band under the header |
| Hero glow | `radial-gradient(120% 140% at 0% 0%,#2a2216,#0d0c0a 60%)` | Main hero number panel |
| Bronze bar | `linear-gradient(90deg,#c2a878,#8c7451)` | Progress and value bars |
| Bronze column | `linear-gradient(180deg,#d9c29a,#8c7451)` | Vertical chart columns |
| Area fill | `#c2a878` at 50% opacity fading to 0, top to bottom | Under line charts |
| Header rule | `linear-gradient(transparent,#c2a878,transparent)` | 1 px divider next to the logo |
| Medals | Gold `#e7c873→#a8781a`, silver `#dcdad3→#9c9a92`, bronze `#d9a77a→#8c5a2b` at 135° | Rank 1, 2 and 3 only |

### 3.3 Chart palette (categorical, use in this order)

`#8c7451` bronze · `#0d0c0a` black · `#c2a878` light bronze · `#a8781a` gold · `#5f6b5a` sage · `#d9c7a3` sand · `#b9b5aa` stone

- Use up to 6 categories, then group the rest as **"Other"** in stone `#b9b5aa`.
- The **highest value** in a single-series chart can be drawn in `--black` to highlight it. Everything else uses bronze.
- Use the track colour `#f4f1ea` (or `#f1eee7` for thin bars) for the empty part of a bar or donut.

### 3.4 Heat scale (calendars, intensity)

`#efece5` (none) → `#e6d7b6` → `#c9ad7c` → `#8c7451` → `#3d3020` (most)

### 3.5 Colour rules

- Status colours mean exactly one thing each. **Red** means a problem that needs action. **Green** means done or OK. **Bronze** means neutral emphasis. Never use red or green for decoration.
- Text contrast: use `--ink` and `--ink2` on white or cream for anything that must be read. Use `--muted` only for hints and captions.
- No blues, purples or bright colours. Standard UI blue isn't part of this system.

---

## 4. Typography

### 4.1 Fonts

```html
<link rel="preconnect" href="https://fonts.googleapis.com">
<link href="https://fonts.googleapis.com/css2?family=Cormorant+Garamond:ital,wght@0,500;0,600;1,500&display=swap" rel="stylesheet">
```

| Role | Stack |
|---|---|
| `--serif` (display) | `"Cormorant Garamond","Cormorant",Optima,Georgia,serif` |
| Sans (everything else) | `system-ui,-apple-system,"Segoe UI",sans-serif` |
| Mono (IDs, asset tags, codes) | `ui-monospace,SFMono-Regular,Menlo,monospace` |

### 4.2 Type scale

| Style | Font | Size / weight | Extras | Example |
|---|---|---|---|---|
| Page title (H1) | serif | 40px / 500 | UPPERCASE, `letter-spacing:.06em`, white on band | OVERVIEW |
| Hero number | serif | 72px / 500 | `line-height:1`, tabular numbers | 26 |
| Hero stat number | serif | 40px / 500 | | 13 |
| Tile number | serif | 30px / 600 | | 1.6 |
| Big list number | serif | 24–26px / 600 | | 7 |
| Empty-state title | serif | 24px / 600 | | Every device is back |
| Card title (H3) | sans | 14.5px / 600 | with an 17px bronze icon before it | Busiest days |
| Body | sans | 14px / 400 | `line-height:1.45` | |
| Row primary | sans | 13–14px / 600 | | Arjun Nair |
| Secondary | sans | 12–13px | `--ink2` | |
| Hint / caption | sans | 12px | `--muted` | Per week, last 26 weeks |
| Eyebrow | sans | 11px / 400 | UPPERCASE, `letter-spacing:.24em`, `--bronze-lt` on dark | IT · COMPANY DEVICES |
| Table / list header | sans | 11px | UPPERCASE, `letter-spacing:.08em`, `--muted` | PERSON |
| Badge | sans | 10.5px / 700 | UPPERCASE, `letter-spacing:.1em` | OVERDUE |
| Product name in header | serif | 15px | `letter-spacing:.34em` | DEVICE LOG |

Rules:
- **Every metric or count shown large is in the serif font.** Small numbers inside tables stay in sans with `font-variant-numeric:tabular-nums`.
- Use sentence case everywhere except eyebrows, page titles, table headers and badges, which are uppercase.
- Don't use more than three sizes in one card.

---

## 5. Spacing, radius, borders, shadows

**Spacing scale (px):** 2 · 4 · 6 · 8 · 10 · 12 · 14 · 16 · 18 · 20 · 22 · 26 · 28 · 40

| Use | Value |
|---|---|
| Gap between cards and grid gap | 14px |
| Section spacing (`.mt`) | 14px |
| Card padding | 18px 20px |
| Tile / row padding | 12–16px × 16–18px |
| Page side padding | 28px (14px on phones) |
| Max content width | 1440px, centred |

**Radius:**

| Element | Radius |
|---|---|
| Hero block | 16px |
| Cards, tiles, out-cards, empty states | 14px |
| List rows, device mini-cards | 12px |
| Icon tiles | 10–12px |
| Tooltips | 8px |
| Small tags (`.dchip`, `.flag`) | 4–7px |
| Buttons, segmented controls, search, chips, badges | 999px (pill) |
| Avatars, rank badges, dots | 50% |

**Borders:** always `1px solid var(--ring)`. Rows use `rgba(11,11,11,.07)`. Dividers inside lists use `#f3f1ec` / `#f0eee8`.

**Shadows (only these):**

| Name | Value | Where |
|---|---|---|
| Hover lift | `0 8px 26px #0d0c0a10` | Card hover |
| Item hover | `0 6px 18px #0d0c0a12` / `0 10px 26px #0d0c0a14` | Row / out-card hover |
| Hero | `0 12px 34px #0d0c0a26` | Dark hero block |
| Tooltip | `0 6px 20px #0000002e` | Tooltip |
| Focus ring | `0 0 0 3px #8c74511f` + border `--bronze` | Inputs in focus |

Surfaces are flat at rest. Shadows appear only on hover or for the hero.

---

## 6. Layout

```
┌──────────────────────────────────────────────── header 72px, #000, sticky ─┐
│ [logo] │ PRODUCT NAME          Nav · Nav (badge) · Nav            ● LIVE    │
├──────────────────────────────── band: gradient, padding 30/28/26 ──────────┤
│ EYEBROW                                                      [line-art     │
│ PAGE TITLE (serif, uppercase)                                 illustration]│
│ One-line description                                                       │
├──────────────────────────── main: max 1440, padding 22/28/40, cream ───────┤
│ ● Live status line · Refresh                                               │
│ [ HERO (dark) ........................................................... ]│
│ [tile] [tile] [tile] [tile]                       ← .grid.g4               │
│ [ wide card 2fr ............. ] [ card 1fr ]      ← .grid.g21              │
│ [ card ] [ card ]                                 ← .grid.g2               │
│ [ full-width card ]                                                        │
│ [ card ] [ card ] [ card ]                        ← .grid.g3               │
├──────────────────────────────── footer: 11.5px muted ──────────────────────┤
```

Grids: `.g4` (4 equal columns), `.g3`, `.g2`, `.g21` (2fr + 1fr). They are all `gap:14px` and use `minmax(0,1fr)` so text never pushes a column wider.

**Breakpoints:**

| Width | What changes |
|---|---|
| ≤1100px | g4 → 2 columns · g3/g21 → 1 column · hero stacks, stats in 2×2 · list header hidden, rows drop secondary columns |
| ≤900px | Illustration hidden · product name and LIVE pill hidden · nav scrolls sideways · g2 → 1 column |
| ≤640px | g4 → 1 column · page padding 14px · H1 30px · nav icons hidden, nav text 12.5px · logo 32px |

---

## 7. Components

Each component lists its class names. Copy the CSS from section 14.

### 7.1 Header (`.kh`)
- 72px tall, `#000`, sticky at the top, bottom border `#1d1b17`.
- Order: **logo → gradient rule → product name stack** (serif 15px, `.34em` spacing, with a bronze 10px uppercase line below) → **nav** pushed right → **LIVE pill**.
- **Nav buttons:** 13.5px, `#cfccc3`, icon 17px in `#8a8375`. Hover or active: white text with a bronze-lt icon. The active tab gets a **2px bronze-lt underline** at the bottom edge that grows in from the left.
- **Nav count badge:** pill, `--bronze-lt` background, `#14110c` text, 11px. It turns `#ef8a7a` when it counts a problem.
- **LIVE pill:** green outline pill with a pulsing 6px dot.

### 7.2 Page band (`.kband`)
- Eyebrow, then the serif uppercase H1 (rises in on every page change), then one sentence in `#b9b5aa`.
- On the right is an optional **line-art illustration**: stroke `#c2a878`, 1.4px, round caps, no fills except `#0d0c0a` cut-outs, with one moving or twinkling detail at most. Hide it at 900px and below.

### 7.3 Buttons

There are only four button types.

| Type | Class | Look | Use |
|---|---|---|---|
| **Segmented control** | `.seg > button` | White pill group with a `--ring` border and 3px padding. Options are 12.5px `--ink2`. The selected option is **black pill, white text**. | Switching views or filters (Daily/Weekly/Monthly, All/Out/In) |
| **Primary action** | `.btn` | Black pill `--black`, white 13px text, padding 9px 18px. Hover: `#2a251c`. | The one main action on a screen (Submit, Export) |
| **Secondary action** | `.btn-more` | White pill, `--ring` border, padding 9px 18px. Hover: bronze border. | "Show more", "Cancel", second actions |
| **Text link** | `.linkbtn` | 12.5px `--bronze`, underlined with a 2px offset. | Inline actions (Refresh, Try again, View all) |

Rules: never use square buttons, never more than one black primary button per view, and nothing on a light background ever has a coloured fill.

### 7.4 Tags, badges and chips

| Component | Class | Look | Use |
|---|---|---|---|
| Status badge | `.badge` | 10.5px bold uppercase pill, bronze-wash background, `#5f4518` text | Neutral state: OUT, NEW |
| Alert badge | `.badge.red` | `--crit` background, white text, **pulses** | Needs action: OVERDUE |
| Action pill | `.act.out` / `.act.in` | 12px semibold pill with a 13px arrow icon. *Out* = black with bronze-lt text. *In* = good-wash with green text. | Direction or type of a log entry |
| Summary chip | `.chip` / `.chip.red` | White pill with an icon, a serif 20px number and a label | Totals above a list |
| Item tag | `.dchip` | `#f6f4ef` background, 7px radius, 11.5px, 14px bronze icon | Items inside a card (Laptop, Charger) |
| Warning flag | `.flag` | 10.5px semibold, crit-wash background, red text, 4px radius | Inline warning under a row value |
| Count badge | `.cnt` | See header nav | Counts in nav or tabs |

### 7.5 Cards (`.card`)
- White, `--ring` border, 14px radius, padding 18px 20px.
- On hover the shadow lifts to `0 8px 26px #0d0c0a10`.
- **Card header (`.hd`):** H3 title with an icon, then a `.hint` line under it. Controls such as `.seg` or `.linkbtn` sit on the right.
- Every card has a title and a one-line hint that explains what it shows.

### 7.6 Hero block (`.hero`)
- Dark, 16px radius, with the hero shadow. Grid: **main panel (1.1fr) | 4 stat cells (3fr)**.
- **Main panel:** hero-glow gradient, eyebrow label, 72px serif number, a `#b9b5aa` sentence, and a **sparkline** at the bottom.
- **Stat cells (`.hs`):** a 34px icon tile, 12px label, 40px serif number, and a 12px description. Clickable cells get a hover tint of `#c2a87812` and a "→" at the end of the description.
- **Alert stat (`.hs.alert`):** red icon tile that pulses, with the number in `#ef8a7a`.
- Use one hero per page, at the top.

### 7.7 KPI tile (`.tile`)
- White, 14px radius. A **44px bronze-wash icon tile** (22px icon) on the left, then a label (12px), a serif 30px number, and a description (11.5px muted).
- On hover it rises by 2px and gains a shadow.
- **Warning tile (`.tile.warn`):** red icon tile and a red number. Use it only when the value is a problem greater than 0.

### 7.8 Lists and rows (`.lr`) — the default way to show records
- Each record is its **own white rounded row** (12px radius, 12px 16px padding, 8px gap between rows), not a table line.
- Columns: avatar · primary (bold) with a secondary line · status pill · date with a relative time · details.
- On hover: bronze border, item shadow, and a 1px lift.
- Above the rows is the **list header** (`.lhead`): 11px uppercase muted labels on the same grid.
- Long lists show 30 rows, then a **"Show more · N left"** `.btn-more`.

### 7.9 Tables (`table`) — for dense numeric data only
- Full width, `border-collapse:collapse`, 13px.
- `th`: left-aligned, 12px weight 500, `--ink2`, padding 8px 10px, bottom border `--grid`, sticky white background.
- `td`: padding 9px 10px, bottom border `#efeee9`. Right-align number columns with `.n` and tabular numbers.
- Row hover: `#faf6ec`.
- Wrap it in `.tablewrap` (scrolls, 8px radius, max-height 620px) when it can be long.

### 7.10 Inputs
- **Search (`.lsearch`):** white pill, `--ring` border, 16px search icon in muted, borderless input 13px. In focus it gets a bronze border and the 3px bronze focus ring.
- **Select / text input:** white, `--ring` border, 999px radius, padding 8px 12px, 13px. The same focus style applies.
- Placeholder text: `--muted`, written as an example ("Search name, asset tag, reason, manager…").

### 7.11 Avatar (`.av`)
32px circle, `--black` background, initials (max 2) in serif 13.5px `--bronze-lt`. It is never a photo or a random colour.

### 7.12 Rank badge (`.rk`)
24px circle. Ranks 1, 2 and 3 use the gold, silver and bronze medal gradients with white text. The rest use `#f3f1ec` with muted text.

### 7.13 Progress and value bars (`.bar`)
6px (lists) or 9px (`.hb` rows) tall, track `#f1eee7`, fill uses the bronze bar gradient, fully rounded. The fill grows from the left on load.

### 7.14 Ring gauge (`.ring`)
72px, track `#f1eee7`, 6px stroke, round caps, starts at 12 o'clock. Bronze normally, `--crit` when overdue. Inside: a serif 26px number and a tiny 9.5px uppercase unit. It sweeps in on load.

### 7.15 Tooltip (`.tt`)
`--black` background, `#f0efec` 12px text, 8px radius, tooltip shadow. The first line is the title in `--bronze-lt` semibold, then the values. It follows the cursor at a 14px offset and flips near screen edges. Fade time is .1s. **Every chart mark has one.**

### 7.16 Status line (`.notice`)
12.5px `--ink2`: green 7px dot with a soft ring · "Live from … · updated 30 Oct, 10:00" · `Refresh` link.

### 7.17 Empty state (`.empty`)
White, 14px radius, **1px dashed `--axis` border**, centred, 46px padding. Optional line-art illustration (bronze strokes, `#f6f1e8` fills, gently floating), a serif 24px title, then one plain sentence. It must say something reassuring or useful, not "No data".

### 7.18 Loading and error
- **Loading:** centred, 90px vertical padding, an 18px spinner (`#e3dccb` ring with a bronze top) and a sentence ("Loading the device log…").
- **Error (`.err`):** crit-wash box, `#f3c6c4` border, 12px radius, `#7a1f1a` text. It contains a bold first sentence, the reason, and a `Try again` link.

### 7.19 Leaderboard row (`.lb`)
Rank badge · avatar · name (bold) + dept (muted) with a bar under it · serif 24px count on the right.

### 7.20 Mini card grid (`.devs > .dev`)
Auto-fill tiles 118px minimum wide, 12px radius: icon tile (38px) · serif 26px number · label · bar · tiny "in 81% of trips" caption. On hover the tile lifts and the icon **wiggles**.

---

## 8. Icons

- **Style:** outline only. `viewBox="0 0 20 20"`, `fill="none"`, `stroke="currentColor"`, `stroke-width="1.5"`, round caps and joins.
- **Sizes:** 13px (inside pills) · 14px (tags) · 16px (inputs) · 17–18px (titles, nav) · 20–22px (tiles).
- **Colour:** inherits from its parent. Bronze in cards, bronze-lt on dark, red only in alert contexts.
- Never use filled icons, emoji, icon fonts or mixed icon sets.

Helper (copy as is):

```js
const ic = (name, s = 18) => `<svg viewBox="0 0 20 20" width="${s}" height="${s}" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true">${P[name]}</svg>`;
```

Icon library (`P`):

| Name | Path |
|---|---|
| grid | `<path d="M3 3h6v8H3zM11 3h6v5h-6zM11 10h6v7h-6zM3 13h6v4H3z"/>` |
| home | `<path d="M3 9.5L10 4l7 5.5V17H3z"/><path d="M8 17v-4h4v4"/>` |
| list | `<path d="M7 5h10M7 10h10M7 15h10M3 5h.01M3 10h.01M3 15h.01"/>` |
| users | `<circle cx="7" cy="7" r="3"/><path d="M2 17c0-3 2.2-5 5-5s5 2 5 5"/><circle cx="14" cy="6" r="2.4"/><path d="M13 11.2c2.6 0 4.6 1.8 4.6 4.6"/>` |
| clock | `<circle cx="10" cy="10" r="7"/><path d="M10 6v4l2.5 2"/>` |
| bell (off) | `<path d="M5 14V9a5 5 0 0 1 10 0v5l1.5 2h-13z"/><path d="M8.5 18h3M3 3l14 14"/>` |
| calendar | `<rect x="3" y="4.5" width="14" height="12.5" rx="2"/><path d="M3 8.5h14M7 3v3M13 3v3"/>` |
| alert | `<path d="M10 3l8 14H2z"/><path d="M10 8.5v3.5M10 14.5v.01"/>` |
| trend | `<path d="M3 15l4.5-4.5 3 3L17 7"/><path d="M12.5 7H17v4.5"/>` |
| trophy | `<path d="M6 3h8v5a4 4 0 0 1-8 0zM6 5H3v1.5A3 3 0 0 0 6 9.5M14 5h3v1.5a3 3 0 0 1-3 3M10 12v3M7 17h6"/>` |
| target | `<circle cx="10" cy="10" r="7"/><circle cx="10" cy="10" r="3.5"/><circle cx="10" cy="10" r=".6"/>` |
| flame | `<path d="M10 17a5 5 0 0 0 5-5c0-3-2-5-3.5-7 0 2-1.5 3-2.5 3C9 6 8.5 4.5 9 3 6.5 5 5 8 5 12a5 5 0 0 0 5 5z"/>` |
| building | `<rect x="4" y="3" width="9" height="14" rx="1"/><path d="M13 8h3v9h-3M7 6h.01M10 6h.01M7 9h.01M10 9h.01M7 12h.01M10 12h.01M8 17v-2.5h1V17"/>` |
| search | `<circle cx="9" cy="9" r="6"/><path d="M14 14l4 4"/>` |
| out (arrow) | `<path d="M6 14L14 6M8 6h6v6"/>` |
| in (arrow) | `<path d="M14 6L6 14M12 14H6V8"/>` |
| check | `<circle cx="10" cy="10" r="7"/><path d="M6.8 10.2l2.2 2.2 4.3-4.6"/>` |
| laptop | `<rect x="4" y="4.5" width="12" height="8.5" rx="1.2"/><path d="M2 15.5h16"/>` |
| charger | `<path d="M7 3v4M13 3v4M5 7h10v3a5 5 0 0 1-10 0zM10 15v3"/>` |
| mouse | `<rect x="6" y="2.5" width="8" height="15" rx="4"/><path d="M10 5.5v3"/>` |
| keyboard | `<rect x="2" y="5.5" width="16" height="9" rx="1.5"/><path d="M5 8.5h.01M8 8.5h.01M11 8.5h.01M14 8.5h.01M6 11.5h8"/>` |
| headset | `<path d="M4 12v-2a6 6 0 0 1 12 0v2"/><rect x="3" y="11" width="3" height="5" rx="1"/><rect x="14" y="11" width="3" height="5" rx="1"/>` |
| monitor | `<rect x="2.5" y="3.5" width="15" height="10" rx="1.2"/><path d="M7 17h6M10 13.5V17"/>` |
| box (other) | `<path d="M3 6.5l7-3.5 7 3.5v7L10 17l-7-3.5z"/><path d="M3 6.5l7 3.5 7-3.5M10 10v7"/>` |

To make a new icon, draw it on the same 20×20 grid with a 1.5px stroke and round ends, and keep it simple enough to read at 14px.

---

## 9. Charts and data visualisation

All charts are **hand-built SVG** (no chart library), so they match exactly. Build each chart type below as a small reusable function that returns SVG.

### General rules
- **No chart borders, no 3D, no default library blues, no legends you can avoid.** Label values directly.
- Gridlines use `--grid`, the baseline uses `--axis`, and axis text is 11px `--muted`. Use about 4 y-ticks at round values (1, 2, 5 × 10ⁿ).
- Value labels sit above or after the mark in 11px semibold `--ink`.
- Every mark has a tooltip (section 7.15), with the title in bronze-lt plus the value and its share ("7 take-homes · 27%").
- Use plurals properly: "1 take-home" / "3 take-homes".

| Chart | When | Style |
|---|---|---|
| **Area line** (`areaChart`) | A trend over time | Smooth curve, 2.4px `--bronze` line that **draws in**, gradient fill below, white dots with a bronze outline. On hover the dot grows to r=6 and fills, with a dashed bronze-lt guide line. Has a Daily/Weekly/Monthly `.seg`. |
| **Sparkline** (`spark`) | A small trend inside the hero or tiles | 1.6px bronze-lt line plus a faint fill, no axes, 54px tall |
| **Rounded columns** (`columns`) | A few categories in order (weekdays, months) | Full-height pill **track** `#f4f1ea` behind each column, bronze-column gradient fill, max value in `--black` and bold label, columns **grow up** one after another |
| **Donut** (`donut`) | Share of a whole, up to 6 slices plus Other | r=72, 26px stroke, 4px gaps between slices, chart palette in order, serif total in the centre with a tiny uppercase unit, legend list on the right (dot · label · count · %). Slices **sweep in**; on hover the stroke widens to 32. |
| **Heat calendar** (`heatmap`) | Daily activity over weeks | Rounded squares (3.5px radius) on a Mon–Sun grid, heat scale, month labels on top, "Less ▢▢▢▢▢ More" key. Squares **pop in** by column. |
| **Leaderboard** (`leaderboard`) | Top N people or items | See section 7.19, top 8 |
| **Horizontal bars** (`hbars`) | Ranked categories (departments, managers) | Label · rounded 9px bar · value, top 8 |
| **Ring gauge** (`ring`) | Progress against a target or time limit | See section 7.14 |
| **Icon mini cards** (`.devs`) | Counts of things that have an icon | See section 7.20 |

**Don't use:** pie charts (use the donut), stacked 3D, dual axes, rainbow colours, or charts with more than 7 colours.

---

## 10. Motion

| Token | Value |
|---|---|
| `--ease` | `cubic-bezier(.2,.7,.2,1)` (fast start, soft landing). Use it for everything. |
| Hover transitions | .15s–.2s |
| Entrance | .6s |
| Chart draw | 0.8s–1.3s |
| Number count-up | 1.1s, ease-out cubic |
| Stagger step | 70ms per item (`animation-delay:calc(var(--i)*70ms)`), up to 12 items |

### Keyframes (the complete set — don't add others without updating this list)

| Name | Effect | Used for |
|---|---|---|
| `rise` | fades in from 12px below | Cards, rows, tiles, chips: everything entering |
| `fade` | opacity 0 → 1 | Chart area fills |
| `grow-x` | scaleX 0 → 1 from the left | Bars, active nav underline |
| `grow-y` | scaleY 0 → 1 from the bottom | Chart columns |
| `pop` | scale .3 → 1 with a fade | Heat squares |
| `arc` | dash 0 → full | Donut slices |
| `ring` | dash offset → value | Ring gauges |
| `pulse` | expanding green halo | LIVE dot |
| `pulse-red` | expanding red halo | Overdue badges, alert icon tiles |
| `march` | dashes moving along a path | Illustration trail |
| `twinkle` | opacity .25 ↔ 1 | Illustration stars |
| `floaty` | 6px up and down | Empty-state illustration |
| `wiggle` | ±8° rotation | Icon on mini-card hover |
| `spin` | 360° | Loading spinner |

Behaviour:
- **Numbers count up** from 0 (`data-count`, plus `data-dec` for decimals).
- **Line charts draw themselves** by animating `stroke-dashoffset`.
- **Hover:** cards gain a shadow, tiles, rows and cards rise by 1–2px, and borders turn bronze. Nothing scales up by more than about 3%.
- Infinite animations are **only for status** (live, overdue) and illustrations. Never on content.
- **Resize:** re-draw without animation (add `body.still`).
- **Accessibility:** `@media (prefers-reduced-motion: reduce)` turns every animation and transition off, and the JS skips count-ups and line drawing.

---

## 11. Content and formatting

| Thing | Format | Example |
|---|---|---|
| Date (full) | D Mon YYYY | 30 Oct 2026 |
| Date (short, same year) | D Mon | 30 Oct |
| Date and time | D Mon, HH:MM | 30 Oct, 10:00 |
| Relative time | n min ago · nh ago · nd ago (up to 45 days, then a date) | 2d ago |
| Week label | Week of 26 Oct 2026 | |
| Month label (axis) | Mon ’YY | Oct ’26 |
| Percent | Whole number with % | 27% |
| Missing value | en dash `–`, or a muted phrase | not given |
| IDs, asset tags | mono font | LT-0412 |

Voice:
- Short, plain and friendly. Prefer "Who takes devices home most" to "Top users by checkout frequency".
- Every chart has a hint that says what it shows ("Purpose given on the form").
- Warnings say what's wrong and what to do ("3 take-homes to follow up").
- Use singular and plural correctly every time.

---

## 12. Accessibility

- Base text is at least 12px; only badges and eyebrows go down to 10.5–11px.
- Body text uses `--ink`/`--ink2` on white or cream. Don't use `--muted` for anything someone must read to act.
- Interactive elements are `<button>`s. Keep the visible focus (`outline:2px solid var(--bronze)`, or `--bronze-lt` on dark).
- Charts are `role="img"` with an `aria-label`. Icons are `aria-hidden="true"`.
- Never show meaning by colour alone: red items also say OVERDUE or Damaged in words.
- Reduced motion is respected (section 10).
- Escape every piece of user-entered text before putting it into HTML (replace `& < > " '` with HTML entities).

---

## 13. Do and don't

| Do | Don't |
|---|---|
| Use the tokens in section 3 | Add new colours, especially blue, purple or bright greens |
| Use serif for big numbers and page titles | Use serif for body text or buttons |
| Use pill-shaped controls | Use square or sharp-cornered buttons |
| Use one black primary button per view | Fill buttons with bronze, red or green |
| Use a white card with a `--ring` border on cream | Use heavy borders, dark cards on light pages (except the hero) |
| Show records as rounded rows (7.8) | Use a dense grey table for people or records |
| Use outline icons from section 8 | Use emoji, filled icons or icon fonts |
| Draw charts in bronze and black from the chart palette | Use chart-library defaults |
| Use red only for real problems | Use red or green for decoration |
| Stagger entrance animations by 70ms | Use bouncy, spinning or looping content animations |
| Put a title and a one-line hint on every card | Leave a chart unexplained |
| Write "Nothing is out right now" | Write "No data" |

---

## 14. Starter CSS (copy this into every new page)

```css
:root{
  --plane:#faf8f4;--card:#fff;--ink:#0b0b0b;--ink2:#52514e;--muted:#898781;--grid:#ebe8e1;--axis:#c3c2b7;--ring:rgba(11,11,11,.08);
  --black:#0d0c0a;--bronze:#8c7451;--bronze-lt:#c2a878;--bronze-wash:#f6f1e8;--gold:#a8781a;
  --crit:#d03b3b;--crit-wash:#fdeceb;--good:#1e7a43;--good-wash:#e9f6ee;
  --serif:"Cormorant Garamond","Cormorant",Optima,Georgia,serif;--ease:cubic-bezier(.2,.7,.2,1)
}
*{box-sizing:border-box}
html,body{margin:0}
body{font:14px/1.45 system-ui,-apple-system,"Segoe UI",sans-serif;background:var(--plane);color:var(--ink)}
button,input,select{font:inherit;color:inherit}
svg{display:block}
[hidden]{display:none!important}
:is(a,button,input,select,[tabindex]):focus-visible{outline:2px solid var(--bronze);outline-offset:2px}

/* header */
.kh{background:#000;color:#f0efec;position:sticky;top:0;z-index:20;border-bottom:1px solid #1d1b17}
.kh-in{max-width:1440px;margin:0 auto;padding:0 28px;height:72px;display:flex;align-items:center;gap:28px}
.lockup{display:flex;align-items:center;gap:14px;flex:none}
.logo{height:52px;width:auto;display:block}
.lk-rule{width:1px;height:34px;background:linear-gradient(#0000,var(--bronze-lt),#0000)}
.lk-txt{display:flex;flex-direction:column;gap:5px}
.lk-p{font-family:var(--serif);font-size:15px;letter-spacing:.34em;line-height:1}
.lk-s{font-size:10px;letter-spacing:.3em;text-transform:uppercase;color:var(--bronze-lt)}
.knav{display:flex;gap:2px;margin-left:auto;height:100%}
.knav button{all:unset;cursor:pointer;padding:0 16px;height:100%;display:flex;align-items:center;gap:8px;font-size:13.5px;color:#cfccc3;position:relative}
.knav button svg{color:#8a8375}
.knav button:hover,.knav button.on{color:#fff}
.knav button.on svg{color:var(--bronze-lt)}
.knav button.on:after{content:"";position:absolute;left:16px;right:16px;bottom:0;height:2px;background:var(--bronze-lt);transform-origin:left;animation:grow-x .35s var(--ease)}
.cnt{font-size:11px;color:#14110c;background:var(--bronze-lt);border-radius:999px;padding:0 7px;line-height:17px;font-variant-numeric:tabular-nums}
.cnt.red{background:#ef8a7a}
.live{flex:none;font-size:11px;letter-spacing:.12em;text-transform:uppercase;color:#9fe09f;border:1px solid #2e4a2e;border-radius:999px;padding:4px 11px;display:flex;align-items:center;gap:7px}
.live i{width:6px;height:6px;border-radius:50%;background:#5fd35f;animation:pulse 2s infinite}

/* band */
.kband{background:linear-gradient(180deg,#0d0c0a,#17140f);color:#f0efec;overflow:hidden}
.kband-in{max-width:1440px;margin:0 auto;padding:30px 28px 26px;display:flex;justify-content:space-between;align-items:center;gap:20px}
.eyebrow{font-size:11px;letter-spacing:.24em;text-transform:uppercase;color:var(--bronze-lt)}
.kband h1{font-family:var(--serif);font-weight:500;font-size:40px;letter-spacing:.06em;text-transform:uppercase;margin:6px 0 2px;color:#fff;animation:rise .6s var(--ease) both}
.kband .sub{color:#b9b5aa;font-size:13.5px}

/* layout */
.kmain{max-width:1440px;margin:0 auto;padding:22px 28px 40px}
.kfoot{max-width:1440px;margin:0 auto;padding:6px 28px 40px;font-size:11.5px;color:var(--muted);letter-spacing:.04em}
.grid{display:grid;gap:14px}
.g4{grid-template-columns:repeat(4,minmax(0,1fr))}.g3{grid-template-columns:repeat(3,minmax(0,1fr))}.g2{grid-template-columns:repeat(2,minmax(0,1fr))}.g21{grid-template-columns:2fr 1fr}
.mt{margin-top:14px}

/* card */
.card{background:var(--card);border:1px solid var(--ring);border-radius:14px;padding:18px 20px;min-width:0;transition:box-shadow .2s,transform .2s}
.card:hover{box-shadow:0 8px 26px #0d0c0a10}
.card .hd{display:flex;justify-content:space-between;align-items:flex-start;gap:10px;margin-bottom:12px}
.card h3{margin:0;font-size:14.5px;font-weight:600;display:flex;align-items:center;gap:8px}
.card h3 svg{color:var(--bronze)}
.hint{color:var(--muted);font-size:12px;margin-top:2px}

/* buttons */
.seg{display:inline-flex;border:1px solid var(--ring);border-radius:999px;padding:3px;background:#fff;flex:none}
.seg button{all:unset;cursor:pointer;padding:5px 13px;font-size:12.5px;color:var(--ink2);border-radius:999px;transition:background .2s,color .2s}
.seg button.on{background:var(--black);color:#fff}
.btn{all:unset;cursor:pointer;background:var(--black);color:#fff;border-radius:999px;padding:9px 18px;font-size:13px;transition:background .2s}
.btn:hover{background:#2a251c}
.btn-more{all:unset;cursor:pointer;border:1px solid var(--ring);background:#fff;border-radius:999px;padding:9px 18px;font-size:13px;transition:border-color .2s}
.btn-more:hover{border-color:var(--bronze)}
.linkbtn{all:unset;cursor:pointer;font-size:12.5px;color:var(--bronze);text-decoration:underline;text-underline-offset:2px}

/* hero */
.hero{display:grid;grid-template-columns:minmax(280px,1.1fr) 3fr;background:var(--black);border-radius:16px;overflow:hidden;color:#f0efec;box-shadow:0 12px 34px #0d0c0a26}
.hero-main{padding:26px 28px;background:radial-gradient(120% 140% at 0% 0%,#2a2216,#0d0c0a 60%);border-right:1px solid #2a251c;display:flex;flex-direction:column}
.hl{font-size:11px;letter-spacing:.24em;text-transform:uppercase;color:var(--bronze-lt)}
.hv{font-family:var(--serif);font-size:72px;line-height:1;margin-top:10px;color:#fff;font-weight:500;font-variant-numeric:tabular-nums}
.hsub{font-size:13px;color:#b9b5aa;margin-top:6px}
.hero-stats{display:grid;grid-template-columns:repeat(4,minmax(0,1fr))}
.hs{all:unset;box-sizing:border-box;padding:24px 22px;border-left:1px solid #211d16;display:flex;flex-direction:column;gap:6px;transition:background .2s}
.hs:first-child{border-left:0}
.hs[data-go]{cursor:pointer}.hs[data-go]:hover{background:#c2a87812}
.hs .ic{width:34px;height:34px;border-radius:10px;background:#1b1710;color:var(--bronze-lt);display:flex;align-items:center;justify-content:center;border:1px solid #2a251c}
.hs .l{font-size:12px;color:#b9b5aa;margin-top:6px}
.hs .v{font-family:var(--serif);font-size:40px;line-height:1;color:#fff;font-weight:500;font-variant-numeric:tabular-nums}
.hs .d{font-size:12px;color:#8f8a7e}
.hs.alert .ic{background:#3a1512;color:#ef8a7a;border-color:#5a1f1a;animation:pulse-red 2.2s infinite}
.hs.alert .v{color:#ef8a7a}

/* tile */
.tile{background:var(--card);border:1px solid var(--ring);border-radius:14px;padding:16px 18px;display:flex;gap:14px;align-items:center;transition:transform .2s,box-shadow .2s}
.tile:hover{transform:translateY(-2px);box-shadow:0 8px 22px #0d0c0a12}
.tile .ic{width:44px;height:44px;border-radius:12px;background:var(--bronze-wash);color:var(--bronze);display:flex;align-items:center;justify-content:center;flex:none}
.tile .l{font-size:12px;color:var(--ink2)}
.tile .v{font-family:var(--serif);font-size:30px;font-weight:600;line-height:1.05}
.tile .d{font-size:11.5px;color:var(--muted)}
.tile.warn .ic{background:var(--crit-wash);color:var(--crit)}
.tile.warn .v{color:var(--crit)}

/* tags & badges */
.badge{font-size:10.5px;letter-spacing:.1em;text-transform:uppercase;font-weight:700;padding:3px 9px;border-radius:999px;background:var(--bronze-wash);color:#5f4518;flex:none}
.badge.red{background:var(--crit);color:#fff;animation:pulse-red 2.2s infinite}
.act{display:inline-flex;align-items:center;gap:6px;font-size:12px;font-weight:600;padding:4px 10px;border-radius:999px;width:max-content}
.act.out{background:var(--black);color:var(--bronze-lt)}
.act.in{background:var(--good-wash);color:var(--good)}
.chip{display:inline-flex;align-items:center;gap:8px;background:#fff;border:1px solid var(--ring);border-radius:999px;padding:7px 14px;font-size:13px}
.chip b{font-family:var(--serif);font-size:20px;line-height:1}
.chip.red{background:var(--crit-wash);border-color:#f3c6c4;color:#7a1f1f}
.dchip{display:inline-flex;align-items:center;gap:5px;font-size:11.5px;color:var(--ink2);background:#f6f4ef;border-radius:7px;padding:3px 8px}
.dchip svg{color:var(--bronze)}
.flag{display:inline-block;font-size:10.5px;font-weight:600;color:var(--crit);background:var(--crit-wash);border-radius:4px;padding:1px 6px;width:max-content}
.mono{font-family:ui-monospace,SFMono-Regular,Menlo,monospace;font-size:12px}

/* avatar, rank, bar */
.av{width:32px;height:32px;border-radius:50%;background:var(--black);color:var(--bronze-lt);font-family:var(--serif);font-size:13.5px;display:flex;align-items:center;justify-content:center;letter-spacing:.04em;flex:none}
.rk{width:24px;height:24px;border-radius:50%;display:flex;align-items:center;justify-content:center;font-size:11px;font-weight:700;color:var(--muted);background:#f3f1ec}
.rk.r1{background:linear-gradient(135deg,#e7c873,#a8781a);color:#fff;box-shadow:0 2px 6px #a8781a55}
.rk.r2{background:linear-gradient(135deg,#dcdad3,#9c9a92);color:#fff}
.rk.r3{background:linear-gradient(135deg,#d9a77a,#8c5a2b);color:#fff}
.bar{height:6px;border-radius:3px;background:#f1eee7;margin-top:6px;overflow:hidden}
.bar i{display:block;height:100%;width:var(--w);border-radius:3px;background:linear-gradient(90deg,var(--bronze-lt),var(--bronze));transform-origin:left;animation:grow-x 1s var(--ease) both;animation-delay:calc(var(--i,0)*80ms)}

/* list rows */
.lhead,.lr{display:grid;grid-template-columns:40px minmax(150px,1.3fr) 140px 120px minmax(150px,1.1fr) minmax(180px,1.5fr);gap:14px;align-items:center}
.lhead{padding:0 16px 8px;font-size:11px;letter-spacing:.08em;text-transform:uppercase;color:var(--muted)}
.llist{display:flex;flex-direction:column;gap:8px}
.lr{background:#fff;border:1px solid rgba(11,11,11,.07);border-radius:12px;padding:12px 16px;transition:border-color .15s,box-shadow .15s,transform .15s}
.lr:hover{border-color:var(--bronze);box-shadow:0 6px 18px #0d0c0a12;transform:translateY(-1px)}
.lc{display:flex;flex-direction:column;gap:3px;min-width:0;font-size:13px}
.lc b{font-weight:600;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
.lc span{font-size:12px;color:var(--muted);white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
.more{display:flex;justify-content:center;padding:12px}

/* table */
table{width:100%;border-collapse:collapse;font-size:13px}
th{text-align:left;font-weight:500;color:var(--ink2);font-size:12px;padding:8px 10px;border-bottom:1px solid var(--grid);white-space:nowrap;position:sticky;top:0;background:var(--card)}
td{padding:9px 10px;border-bottom:1px solid #efeee9;vertical-align:middle}
td.n,th.n{text-align:right;font-variant-numeric:tabular-nums}
tbody tr:hover{background:#faf6ec}
.tablewrap{overflow:auto;max-height:620px;border-radius:8px}

/* inputs */
.lsearch{display:flex;align-items:center;gap:8px;background:#fff;border:1px solid var(--ring);border-radius:999px;padding:0 14px;flex:1 1 260px;max-width:380px;color:var(--muted);transition:border-color .2s,box-shadow .2s}
.lsearch:focus-within{border-color:var(--bronze);box-shadow:0 0 0 3px #8c74511f}
.lsearch input{border:0;outline:0;padding:9px 0;width:100%;background:transparent;font-size:13px;color:var(--ink)}
.field{border:1px solid var(--ring);border-radius:999px;padding:8px 12px;background:#fff;font-size:13px;color:var(--ink);outline:0;transition:border-color .2s,box-shadow .2s}
.field:focus{border-color:var(--bronze);box-shadow:0 0 0 3px #8c74511f}

/* feedback */
.notice{display:flex;align-items:center;gap:10px;flex-wrap:wrap;font-size:12.5px;color:var(--ink2);margin:0 0 16px}
.notice .dot{width:7px;height:7px;border-radius:50%;background:var(--good);box-shadow:0 0 0 3px #1e7a4326}
.tt{position:fixed;pointer-events:none;background:var(--black);color:#f0efec;font-size:12px;padding:8px 11px;border-radius:8px;box-shadow:0 6px 20px #0000002e;z-index:50;opacity:0;transition:opacity .1s;max-width:260px}
.tt .tl{color:var(--bronze-lt);font-weight:600;margin-bottom:2px}
.empty{padding:46px 20px;text-align:center;color:var(--ink2);background:#fff;border-radius:14px;border:1px dashed var(--axis)}
.empty b{display:block;font-family:var(--serif);font-size:24px;font-weight:600;color:var(--ink)}
.loading{display:flex;align-items:center;gap:12px;padding:90px 0;justify-content:center;color:var(--ink2)}
.spin{width:18px;height:18px;border-radius:50%;border:2px solid #e3dccb;border-top-color:var(--bronze);animation:spin .8s linear infinite}
.err{background:var(--crit-wash);border:1px solid #f3c6c4;border-radius:12px;padding:14px 16px;color:#7a1f1f}

/* chart text */
.chart{position:relative;width:100%}
.chart text{font-size:11px;fill:var(--muted);font-variant-numeric:tabular-nums}
.chart .val,.chart .b{fill:var(--ink);font-weight:600}

/* motion */
.rise{animation:rise .6s var(--ease) both;animation-delay:calc(var(--i,0)*70ms)}
.grow{transform-box:fill-box;transform-origin:bottom;animation:grow-y .8s var(--ease) both;animation-delay:calc(var(--i,0)*70ms)}
@keyframes rise{from{opacity:0;transform:translateY(12px)}}
@keyframes fade{from{opacity:0}}
@keyframes grow-x{from{transform:scaleX(0)}}
@keyframes grow-y{from{transform:scaleY(0)}}
@keyframes pop{from{opacity:0;transform:scale(.3)}}
@keyframes arc{from{stroke-dasharray:0 1000}}
@keyframes ring{from{stroke-dashoffset:200}}
@keyframes spin{to{transform:rotate(360deg)}}
@keyframes march{to{stroke-dashoffset:-18}}
@keyframes twinkle{0%,100%{opacity:.25}50%{opacity:1}}
@keyframes floaty{50%{transform:translateY(-6px)}}
@keyframes wiggle{25%{transform:rotate(-8deg)}75%{transform:rotate(8deg)}}
@keyframes pulse{0%{box-shadow:0 0 0 0 #5fd35f88}70%{box-shadow:0 0 0 7px #5fd35f00}100%{box-shadow:0 0 0 0 #5fd35f00}}
@keyframes pulse-red{0%{box-shadow:0 0 0 0 #d03b3b66}70%{box-shadow:0 0 0 8px #d03b3b00}100%{box-shadow:0 0 0 0 #d03b3b00}}
body.still *{animation:none!important;transition:none!important}
@media(prefers-reduced-motion:reduce){*,*:before,*:after{animation:none!important;transition:none!important}}

/* responsive */
@media(max-width:1100px){.g4{grid-template-columns:repeat(2,1fr)}.g3,.g21{grid-template-columns:1fr}.hero{grid-template-columns:1fr}.hero-main{border-right:0;border-bottom:1px solid #2a251c}.hero-stats{grid-template-columns:repeat(2,1fr)}.hs:nth-child(3){border-left:0}.hs:nth-child(n+3){border-top:1px solid #211d16}.lhead{display:none}}
@media(max-width:900px){.kh-in{gap:14px;padding:0 14px}.lk-txt,.lk-rule,.live{display:none}.knav{overflow-x:auto}.g2{grid-template-columns:1fr}}
@media(max-width:640px){.knav button{padding:0 7px;white-space:nowrap;font-size:12.5px}.knav button svg{display:none}.logo{height:32px}.g4{grid-template-columns:1fr}.kmain{padding:16px 14px 30px}.kband h1{font-size:30px}}
```

### Page skeleton

```html
<header class="kh"><div class="kh-in">
  <div class="lockup"><img class="logo" src="assets/karma-group-logo.webp" alt="Karma Group"><span class="lk-rule"></span>
    <span class="lk-txt"><span class="lk-p">PRODUCT NAME</span><span class="lk-s">Team · What it is</span></span></div>
  <nav class="knav"><button class="on">Overview</button><button>Second view <span class="cnt">3</span></button></nav>
  <span class="live"><i></i>Live</span>
</div></header>
<div class="kband"><div class="kband-in"><div>
  <div class="eyebrow">Team · Area</div><h1>Overview</h1><div class="sub">One sentence on what this page shows</div>
</div></div></div>
<main class="kmain">
  <div class="notice"><span class="dot"></span>Live from … · updated 30 Oct, 10:00 · <button class="linkbtn">Refresh</button></div>
  <div class="grid g4">
    <div class="tile rise" style="--i:1"><span class="ic"><!-- 22px icon --></span><div><div class="l">Label</div><div class="v">42</div><div class="d">what the number means</div></div></div>
  </div>
  <div class="card mt rise" style="--i:2">
    <div class="hd"><div><h3><!-- 17px icon -->Card title</h3><div class="hint">What this shows</div></div>
      <div class="seg"><button class="on">Weekly</button><button>Monthly</button></div></div>
    <!-- content -->
  </div>
</main>
<footer class="kfoot">Karma Group · Team · Product name</footer>
<div class="tt" id="tt"></div>
```

---

## 15. Checklist before shipping anything

- [ ] Only colours from section 3. Nothing blue.
- [ ] Logo on black, at the top left.
- [ ] Big numbers and the page title in serif. Everything else in system sans.
- [ ] Buttons are pills: one black primary at most, `.seg` for switching.
- [ ] Every card has a title, an icon and a hint.
- [ ] Records are rounded rows. Tables only for dense numbers.
- [ ] Every chart mark has a tooltip. Values are labelled directly.
- [ ] Entrance animations are staggered, numbers count up, and reduced motion is respected.
- [ ] Red and green mean problem and done only, and always come with words.
- [ ] Dates read like 30 Oct 2026, and plurals are correct.
- [ ] It works at 375px wide.
