# Iconography

> One icon pack, three sizes, one stroke, and a word beside almost every icon. Which glyph each Kwark module uses, which glyphs may stand alone, and what a chevron promises.

Source: https://kwark.space/designSystem/foundations/iconography

## One pack

Every icon in Kwark comes from Lucide, through `lucide-react` (`^0.562.0` in the app's `package.json`). One pack means one drawing hand: the same 24-unit grid, the same round joins, the same weight. Mixing packs is how an interface starts to look assembled rather than designed.

- In the app, icons are drawn through the shared `Icon` component (`components/ui/Icon.tsx`), which fixes the size to one of three steps and the stroke to 1.75, and hides the icon from screen readers unless it is given a `label`.
- `IconButton` and `TextButton` use `Icon` inside, so a button never sets its own icon size.
- On this site and in framework-free work, paste Lucide's SVG markup as it ships (`viewBox="0 0 24 24"`, `stroke="currentColor"`, `fill="none"`), set the size with `--k-icon-*`, and add `aria-hidden="true"`.

> **For agents:** Use lucide-react through `Icon`, `IconButton` or `TextButton`. Never import another icon pack. Never draw an inline `<svg>` for something Lucide has. Never set an icon to a size other than 14, 16 or 20.

## Three sizes

| Size | Where |
|---|---|
| **14px** `--k-icon-sm`, `Icon size="sm"` | Beside 12px text: a chevron after a word (`TextButton` with `opens`), a tick in a menu, the breadcrumb's chevrons and ⋯, small inline actions in the editor (Note, Line note) |
| **16px** `--k-icon-md`, `Icon size="md"` (default) | Beside 14px text: inside buttons and menu items, `IconButton` on a desk, list row leads |
| **20px** `--k-icon-lg`, `Icon size="lg"` | Where the icon leads on its own: the phone header's back chevron, the phone dial, a dialog's Close |

"13 and 15 are not steps" is written into `Icon.tsx`. A bigger icon is not a more important one; importance comes from position and the word beside it. Illustrations and empty-state art are not icons, and Kwark's empty states carry no illustration at all.

The hit area is not the icon. A 16px icon sits in a 32px button on a desk and a 44px button under a thumb (`--k-tap`).

## Stroke and colour

- **Stroke 1.75** at every size, through `Icon`. Lucide's own default is 2; older code that imports a Lucide icon directly still draws at 2, and a few places force 3 or 4 for emphasis. Do not copy those: emphasis comes from colour and position, never from a heavier line.
- **Never** fill a Lucide outline icon, and never give it a second colour.
- **`currentColor` always.** The icon takes the control's colour, so hover, disabled and focus need no icon rule of their own. Quiet icons (a menu item's lead, a row's trailing chevron, an idle `IconButton`) are `--k-text-2`; on hover an `IconButton` steps to `--k-text`.
- **Never** colour an icon with the accent unless the whole control is the accent. A copper bin icon next to grey ones reads as a warning.

## Icons beside words

A control says what it is with a word. The icon helps a person find the word again next time; it does not replace it.

```html
<button class="kw-button kw-button--primary" type="button"><svg width="16" height="16" style="width:var(--k-icon-md);height:var(--k-icon-md);flex:none" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><rect width="18" height="11" x="3" y="11" rx="2" ry="2"/><path d="M7 11V7a5 5 0 0 1 10 0v4"/></svg>Lock script</button>
<button class="kw-button" type="button"><svg width="16" height="16" style="width:var(--k-icon-md);height:var(--k-icon-md);flex:none" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M6 18H4a2 2 0 0 1-2-2v-5a2 2 0 0 1 2-2h16a2 2 0 0 1 2 2v5a2 2 0 0 1-2 2h-2"/><path d="M6 9V3a1 1 0 0 1 1-1h10a1 1 0 0 1 1 1v6"/><rect x="6" y="14" width="12" height="8" rx="1"/></svg>Print call sheet</button>
<button class="kw-text-button" type="button" aria-haspopup="menu">Menu<svg width="14" height="14" style="width:var(--k-icon-sm);height:var(--k-icon-sm);flex:none" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="m6 9 6 6 6-6"/></svg></button>
<button class="kw-icon-button" type="button" aria-label="Back to Outline" title="Back to Outline"><svg width="20" height="20" style="width:var(--k-icon-lg);height:var(--k-icon-lg);flex:none" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="m15 18-6-6 6-6"/></svg></button>
<button class="kw-icon-button" type="button" aria-label="More actions for Scene 12" title="More actions for Scene 12"><svg width="20" height="20" style="width:var(--k-icon-lg);height:var(--k-icon-lg);flex:none" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><circle cx="12" cy="12" r="1"/><circle cx="19" cy="12" r="1"/><circle cx="5" cy="12" r="1"/></svg></button>
<button class="kw-icon-button" type="button" aria-label="Close Scene 12 details" title="Close Scene 12 details"><svg width="20" height="20" style="width:var(--k-icon-lg);height:var(--k-icon-lg);flex:none" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M18 6 6 18"/><path d="m6 6 12 12"/></svg></button>
```

## Glyphs that may stand alone

Only glyphs that mean the same thing in every app may appear without a word, and only where space is short (a phone header, a row, a dialog's corner). Each still has an accessible name that says what it acts on.

| Glyph | Lucide | Means | Accessible name, for example |
|---|---|---|---|
| <span style="display:inline-grid;vertical-align:middle"><svg width="16" height="16" style="width:var(--k-icon-md);height:var(--k-icon-md);flex:none" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="m15 18-6-6 6-6"/></svg></span> | `ChevronLeft` | Back | Back to Outline |
| <span style="display:inline-grid;vertical-align:middle"><svg width="16" height="16" style="width:var(--k-icon-md);height:var(--k-icon-md);flex:none" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M18 6 6 18"/><path d="m6 6 12 12"/></svg></span> | `X` | Close | Close dialog; Close Scene 12 details |
| <span style="display:inline-grid;vertical-align:middle"><svg width="16" height="16" style="width:var(--k-icon-md);height:var(--k-icon-md);flex:none" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><circle cx="12" cy="12" r="1"/><circle cx="19" cy="12" r="1"/><circle cx="5" cy="12" r="1"/></svg></span> | `MoreHorizontal` | More | More actions for Scene 12 |
| <span style="display:inline-grid;vertical-align:middle"><svg width="16" height="16" style="width:var(--k-icon-md);height:var(--k-icon-md);flex:none" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M5 12h14"/><path d="M12 5v14"/></svg></span> | `Plus` | Add | Add scene to Act 2 |
| <span style="display:inline-grid;vertical-align:middle"><svg width="16" height="16" style="width:var(--k-icon-md);height:var(--k-icon-md);flex:none" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="m21 21-4.34-4.34"/><circle cx="11" cy="11" r="8"/></svg></span> | `Search` | Search | Search scenes |
| <span style="display:inline-grid;vertical-align:middle"><svg width="16" height="16" style="width:var(--k-icon-md);height:var(--k-icon-md);flex:none" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M20 6 9 17l-5-5"/></svg></span> | `Check` | Selected (a tick in a menu, not a button) | Not a button; the menu item is announced as checked |

- **Must** give every icon-only button a `label` (`IconButton` requires one) that names the action and its object: *More actions for Scene 12*, not *More*. `IconButton` also sets it as the `title`, so a pointer user sees it on hover.
- **Never** rely on the tooltip as the name. Test with tooltips unavailable.
- **Never** make an icon-only button for anything not in this table. A *Lock script* or *Issue call sheet* button always carries its word.
- An icon beside a word is decorative: `aria-hidden="true"`, no label, so a screen reader does not say "file text Screenplay".

## What a chevron promises

A chevron is a promise about what happens next, and Kwark keeps the promise the same everywhere.

| Chevron | Promise | Where |
|---|---|---|
| <span style="display:inline-grid;vertical-align:middle"><svg width="14" height="14" style="width:var(--k-icon-sm);height:var(--k-icon-sm);flex:none" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="m6 9 6 6 6-6"/></svg></span> Chevron down, 14px, after a word | This opens a menu or a list here | `TextButton` with `opens`, the phone header's **Menu**, the breadcrumb's switchers (Decision 0044) |
| <span style="display:inline-grid;vertical-align:middle"><svg width="14" height="14" style="width:var(--k-icon-sm);height:var(--k-icon-sm);flex:none" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="m9 18 6-6-6-6"/></svg></span> Chevron right, 14px, at the end of a row | This row opens another page of choices | `MenuSheet` rows that drill down. As the breadcrumb's separator on a desk it means *inside*: Blank Pages › Outline |
| <span style="display:inline-grid;vertical-align:middle"><svg width="20" height="20" style="width:var(--k-icon-lg);height:var(--k-icon-lg);flex:none" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="m15 18-6-6 6-6"/></svg></span> Chevron left, 20px, at the start of a header | Back to where you came from | `PageHeader` on a phone, `MenuSheet`'s back row |

- **Never** put a chevron on a button that does something at once (Save, Delete, Export PDF).
- **Never** use an arrow (`ArrowRight`) as a chevron. An arrow means something moves or is sent: *Move to Act 2*, a next step in a sequence.
- Decision 0044 gives the phase switch (*Write* / *Prepare to shoot*) and the module switch the same chevron treatment, so a writer learns it once.

## The icons Kwark's modules use

A module's icon is the same on the project board, in the breadcrumb's module switcher, in the production office's menu and on the phone. It is read from one place: `shared/board/boardTemplate.ts` (Write, and the board's built-in modules) and `pages/PreProduction/shared/productionModules.ts` and `departments.ts` (Prepare to shoot).

### Write

```html
<div style="display:grid;grid-template-columns:repeat(auto-fill,minmax(150px,1fr));gap:var(--k-space-2);width:100%">
<div style="display:flex;align-items:center;gap:var(--k-space-2);min-height:var(--k-tap);padding:0 var(--k-space-3);background:var(--k-surface);border:1px solid var(--k-line);border-radius:var(--k-radius-card);font:500 var(--k-fs-meta)/1.3 var(--k-font-ui);color:var(--k-text)"><span style="display:grid;color:var(--k-text-2)"><svg width="20" height="20" style="width:var(--k-icon-lg);height:var(--k-icon-lg);flex:none" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M16 21v-2a4 4 0 0 0-4-4H6a4 4 0 0 0-4 4v2"/><path d="M16 3.128a4 4 0 0 1 0 7.744"/><path d="M22 21v-2a4 4 0 0 0-3-3.87"/><circle cx="9" cy="7" r="4"/></svg></span>Characters & Locations</div>
<div style="display:flex;align-items:center;gap:var(--k-space-2);min-height:var(--k-tap);padding:0 var(--k-space-3);background:var(--k-surface);border:1px solid var(--k-line);border-radius:var(--k-radius-card);font:500 var(--k-fs-meta)/1.3 var(--k-font-ui);color:var(--k-text)"><span style="display:grid;color:var(--k-text-2)"><svg width="20" height="20" style="width:var(--k-icon-lg);height:var(--k-icon-lg);flex:none" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><circle cx="12" cy="12" r="10"/><path d="M12 2a14.5 14.5 0 0 0 0 20 14.5 14.5 0 0 0 0-20"/><path d="M2 12h20"/></svg></span>World & Lore</div>
<div style="display:flex;align-items:center;gap:var(--k-space-2);min-height:var(--k-tap);padding:0 var(--k-space-3);background:var(--k-surface);border:1px solid var(--k-line);border-radius:var(--k-radius-card);font:500 var(--k-fs-meta)/1.3 var(--k-font-ui);color:var(--k-text)"><span style="display:grid;color:var(--k-text-2)"><svg width="20" height="20" style="width:var(--k-icon-lg);height:var(--k-icon-lg);flex:none" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><rect x="16" y="16" width="6" height="6" rx="1"/><rect x="2" y="16" width="6" height="6" rx="1"/><rect x="9" y="2" width="6" height="6" rx="1"/><path d="M5 16v-3a1 1 0 0 1 1-1h12a1 1 0 0 1 1 1v3"/><path d="M12 12V8"/></svg></span>Outline</div>
<div style="display:flex;align-items:center;gap:var(--k-space-2);min-height:var(--k-tap);padding:0 var(--k-space-3);background:var(--k-surface);border:1px solid var(--k-line);border-radius:var(--k-radius-card);font:500 var(--k-fs-meta)/1.3 var(--k-font-ui);color:var(--k-text)"><span style="display:grid;color:var(--k-text-2)"><svg width="20" height="20" style="width:var(--k-icon-lg);height:var(--k-icon-lg);flex:none" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M6 22a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h8a2.4 2.4 0 0 1 1.704.706l3.588 3.588A2.4 2.4 0 0 1 20 8v12a2 2 0 0 1-2 2z"/><path d="M14 2v5a1 1 0 0 0 1 1h5"/><path d="M10 9H8"/><path d="M16 13H8"/><path d="M16 17H8"/></svg></span>Screenplay</div>
<div style="display:flex;align-items:center;gap:var(--k-space-2);min-height:var(--k-tap);padding:0 var(--k-space-3);background:var(--k-surface);border:1px solid var(--k-line);border-radius:var(--k-radius-card);font:500 var(--k-fs-meta)/1.3 var(--k-font-ui);color:var(--k-text)"><span style="display:grid;color:var(--k-text-2)"><svg width="20" height="20" style="width:var(--k-icon-lg);height:var(--k-icon-lg);flex:none" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M6 18h8"/><path d="M3 22h18"/><path d="M14 22a7 7 0 1 0 0-14h-1"/><path d="M9 14h2"/><path d="M9 12a2 2 0 0 1-2-2V6h6v4a2 2 0 0 1-2 2Z"/><path d="M12 6V3a1 1 0 0 0-1-1H9a1 1 0 0 0-1 1v3"/></svg></span>Research</div>
<div style="display:flex;align-items:center;gap:var(--k-space-2);min-height:var(--k-tap);padding:0 var(--k-space-3);background:var(--k-surface);border:1px solid var(--k-line);border-radius:var(--k-radius-card);font:500 var(--k-fs-meta)/1.3 var(--k-font-ui);color:var(--k-text)"><span style="display:grid;color:var(--k-text-2)"><svg width="20" height="20" style="width:var(--k-icon-lg);height:var(--k-icon-lg);flex:none" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M15 14c.2-1 .7-1.7 1.5-2.5 1-.9 1.5-2.2 1.5-3.5A6 6 0 0 0 6 8c0 1 .2 2.2 1.5 3.5.7.7 1.3 1.5 1.5 2.5"/><path d="M9 18h6"/><path d="M10 22h4"/></svg></span>Idea & Themes</div>
<div style="display:flex;align-items:center;gap:var(--k-space-2);min-height:var(--k-tap);padding:0 var(--k-space-3);background:var(--k-surface);border:1px solid var(--k-line);border-radius:var(--k-radius-card);font:500 var(--k-fs-meta)/1.3 var(--k-font-ui);color:var(--k-text)"><span style="display:grid;color:var(--k-text-2)"><svg width="20" height="20" style="width:var(--k-icon-lg);height:var(--k-icon-lg);flex:none" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M2 3h20"/><path d="M21 3v11a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V3"/><path d="m7 21 5-5 5 5"/></svg></span>Pitch</div>
</div>
```

### Prepare to shoot

```html
<div style="display:grid;grid-template-columns:repeat(auto-fill,minmax(150px,1fr));gap:var(--k-space-2);width:100%">
<div style="display:flex;align-items:center;gap:var(--k-space-2);min-height:var(--k-tap);padding:0 var(--k-space-3);background:var(--k-surface);border:1px solid var(--k-line);border-radius:var(--k-radius-card);font:500 var(--k-fs-meta)/1.3 var(--k-font-ui);color:var(--k-text)"><span style="display:grid;color:var(--k-text-2)"><svg width="20" height="20" style="width:var(--k-icon-lg);height:var(--k-icon-lg);flex:none" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M12.586 2.586A2 2 0 0 0 11.172 2H4a2 2 0 0 0-2 2v7.172a2 2 0 0 0 .586 1.414l8.704 8.704a2.426 2.426 0 0 0 3.42 0l6.58-6.58a2.426 2.426 0 0 0 0-3.42z"/><circle cx="7.5" cy="7.5" r=".5" fill="currentColor"/></svg></span>Breakdown</div>
<div style="display:flex;align-items:center;gap:var(--k-space-2);min-height:var(--k-tap);padding:0 var(--k-space-3);background:var(--k-surface);border:1px solid var(--k-line);border-radius:var(--k-radius-card);font:500 var(--k-fs-meta)/1.3 var(--k-font-ui);color:var(--k-text)"><span style="display:grid;color:var(--k-text-2)"><svg width="20" height="20" style="width:var(--k-icon-lg);height:var(--k-icon-lg);flex:none" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M12 3v18"/><rect width="18" height="18" x="3" y="3" rx="2"/><path d="M3 9h18"/><path d="M3 15h18"/></svg></span>Shots & Boards</div>
<div style="display:flex;align-items:center;gap:var(--k-space-2);min-height:var(--k-tap);padding:0 var(--k-space-3);background:var(--k-surface);border:1px solid var(--k-line);border-radius:var(--k-radius-card);font:500 var(--k-fs-meta)/1.3 var(--k-font-ui);color:var(--k-text)"><span style="display:grid;color:var(--k-text-2)"><svg width="20" height="20" style="width:var(--k-icon-lg);height:var(--k-icon-lg);flex:none" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M20.2 6 3 11l-.9-2.4c-.3-1.1.3-2.2 1.3-2.5l13.5-4c1.1-.3 2.2.3 2.5 1.3Z"/><path d="m6.2 5.3 3.1 3.9"/><path d="m12.4 3.4 3.1 4"/><path d="M3 11h18v8a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2Z"/></svg></span>Schedule & Call Sheets</div>
<div style="display:flex;align-items:center;gap:var(--k-space-2);min-height:var(--k-tap);padding:0 var(--k-space-3);background:var(--k-surface);border:1px solid var(--k-line);border-radius:var(--k-radius-card);font:500 var(--k-fs-meta)/1.3 var(--k-font-ui);color:var(--k-text)"><span style="display:grid;color:var(--k-text-2)"><svg width="20" height="20" style="width:var(--k-icon-lg);height:var(--k-icon-lg);flex:none" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="m16 13 5.223 3.482a.5.5 0 0 0 .777-.416V7.87a.5.5 0 0 0-.752-.432L16 10.5"/><rect x="2" y="6" width="14" height="12" rx="2"/></svg></span>Camera & Light</div>
<div style="display:flex;align-items:center;gap:var(--k-space-2);min-height:var(--k-tap);padding:0 var(--k-space-3);background:var(--k-surface);border:1px solid var(--k-line);border-radius:var(--k-radius-card);font:500 var(--k-fs-meta)/1.3 var(--k-font-ui);color:var(--k-text)"><span style="display:grid;color:var(--k-text-2)"><svg width="20" height="20" style="width:var(--k-icon-lg);height:var(--k-icon-lg);flex:none" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="m15 12-9.373 9.373a1 1 0 0 1-3.001-3L12 9"/><path d="m18 15 4-4"/><path d="m21.5 11.5-1.914-1.914A2 2 0 0 1 19 8.172v-.344a2 2 0 0 0-.586-1.414l-1.657-1.657A6 6 0 0 0 12.516 3H9l1.243 1.243A6 6 0 0 1 12 8.485V10l2 2h1.172a2 2 0 0 1 1.414.586L18.5 14.5"/></svg></span>Art</div>
<div style="display:flex;align-items:center;gap:var(--k-space-2);min-height:var(--k-tap);padding:0 var(--k-space-3);background:var(--k-surface);border:1px solid var(--k-line);border-radius:var(--k-radius-card);font:500 var(--k-fs-meta)/1.3 var(--k-font-ui);color:var(--k-text)"><span style="display:grid;color:var(--k-text-2)"><svg width="20" height="20" style="width:var(--k-icon-lg);height:var(--k-icon-lg);flex:none" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M20.38 3.46 16 2a4 4 0 0 1-8 0L3.62 3.46a2 2 0 0 0-1.34 2.23l.58 3.47a1 1 0 0 0 .99.84H6v10c0 1.1.9 2 2 2h8a2 2 0 0 0 2-2V10h2.15a1 1 0 0 0 .99-.84l.58-3.47a2 2 0 0 0-1.34-2.23z"/></svg></span>Costume & Makeup</div>
<div style="display:flex;align-items:center;gap:var(--k-space-2);min-height:var(--k-tap);padding:0 var(--k-space-3);background:var(--k-surface);border:1px solid var(--k-line);border-radius:var(--k-radius-card);font:500 var(--k-fs-meta)/1.3 var(--k-font-ui);color:var(--k-text)"><span style="display:grid;color:var(--k-text-2)"><svg width="20" height="20" style="width:var(--k-icon-lg);height:var(--k-icon-lg);flex:none" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M9 18V5l12-2v13"/><circle cx="6" cy="18" r="3"/><circle cx="18" cy="16" r="3"/></svg></span>Sound & Music</div>
<div style="display:flex;align-items:center;gap:var(--k-space-2);min-height:var(--k-tap);padding:0 var(--k-space-3);background:var(--k-surface);border:1px solid var(--k-line);border-radius:var(--k-radius-card);font:500 var(--k-fs-meta)/1.3 var(--k-font-ui);color:var(--k-text)"><span style="display:grid;color:var(--k-text-2)"><svg width="20" height="20" style="width:var(--k-icon-lg);height:var(--k-icon-lg);flex:none" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M12 3q1 4 4 6.5t3 5.5a1 1 0 0 1-14 0 5 5 0 0 1 1-3 1 1 0 0 0 5 0c0-2-1.5-3-1.5-5q0-2 2.5-4"/></svg></span>Stunts & Effects</div>
<div style="display:flex;align-items:center;gap:var(--k-space-2);min-height:var(--k-tap);padding:0 var(--k-space-3);background:var(--k-surface);border:1px solid var(--k-line);border-radius:var(--k-radius-card);font:500 var(--k-fs-meta)/1.3 var(--k-font-ui);color:var(--k-text)"><span style="display:grid;color:var(--k-text-2)"><svg width="20" height="20" style="width:var(--k-icon-lg);height:var(--k-icon-lg);flex:none" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M11.017 2.814a1 1 0 0 1 1.966 0l1.051 5.558a2 2 0 0 0 1.594 1.594l5.558 1.051a1 1 0 0 1 0 1.966l-5.558 1.051a2 2 0 0 0-1.594 1.594l-1.051 5.558a1 1 0 0 1-1.966 0l-1.051-5.558a2 2 0 0 0-1.594-1.594l-5.558-1.051a1 1 0 0 1 0-1.966l5.558-1.051a2 2 0 0 0 1.594-1.594z"/><path d="M20 2v4"/><path d="M22 4h-4"/><circle cx="4" cy="20" r="2"/></svg></span>VFX</div>
<div style="display:flex;align-items:center;gap:var(--k-space-2);min-height:var(--k-tap);padding:0 var(--k-space-3);background:var(--k-surface);border:1px solid var(--k-line);border-radius:var(--k-radius-card);font:500 var(--k-fs-meta)/1.3 var(--k-font-ui);color:var(--k-text)"><span style="display:grid;color:var(--k-text-2)"><svg width="20" height="20" style="width:var(--k-icon-lg);height:var(--k-icon-lg);flex:none" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M20 10c0 4.993-5.539 10.193-7.399 11.799a1 1 0 0 1-1.202 0C9.539 20.193 4 14.993 4 10a8 8 0 0 1 16 0"/><circle cx="12" cy="10" r="3"/></svg></span>Locations</div>
<div style="display:flex;align-items:center;gap:var(--k-space-2);min-height:var(--k-tap);padding:0 var(--k-space-3);background:var(--k-surface);border:1px solid var(--k-line);border-radius:var(--k-radius-card);font:500 var(--k-fs-meta)/1.3 var(--k-font-ui);color:var(--k-text)"><span style="display:grid;color:var(--k-text-2)"><svg width="20" height="20" style="width:var(--k-icon-lg);height:var(--k-icon-lg);flex:none" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M16 21v-2a4 4 0 0 0-4-4H6a4 4 0 0 0-4 4v2"/><path d="M16 3.128a4 4 0 0 1 0 7.744"/><path d="M22 21v-2a4 4 0 0 0-3-3.87"/><circle cx="9" cy="7" r="4"/></svg></span>Cast & Crew</div>
<div style="display:flex;align-items:center;gap:var(--k-space-2);min-height:var(--k-tap);padding:0 var(--k-space-3);background:var(--k-surface);border:1px solid var(--k-line);border-radius:var(--k-radius-card);font:500 var(--k-fs-meta)/1.3 var(--k-font-ui);color:var(--k-text)"><span style="display:grid;color:var(--k-text-2)"><svg width="20" height="20" style="width:var(--k-icon-lg);height:var(--k-icon-lg);flex:none" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M8 2v4"/><path d="M16 2v4"/><rect width="18" height="18" x="3" y="4" rx="2"/><path d="M3 10h18"/><path d="M8 14h.01"/><path d="M12 14h.01"/><path d="M16 14h.01"/><path d="M8 18h.01"/><path d="M12 18h.01"/><path d="M16 18h.01"/></svg></span>Calendar</div>
<div style="display:flex;align-items:center;gap:var(--k-space-2);min-height:var(--k-tap);padding:0 var(--k-space-3);background:var(--k-surface);border:1px solid var(--k-line);border-radius:var(--k-radius-card);font:500 var(--k-fs-meta)/1.3 var(--k-font-ui);color:var(--k-text)"><span style="display:grid;color:var(--k-text-2)"><svg width="20" height="20" style="width:var(--k-icon-lg);height:var(--k-icon-lg);flex:none" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M19 7V4a1 1 0 0 0-1-1H5a2 2 0 0 0 0 4h15a1 1 0 0 1 1 1v4h-3a2 2 0 0 0 0 4h3a1 1 0 0 0 1-1v-2a1 1 0 0 0-1-1"/><path d="M3 5v14a2 2 0 0 0 2 2h15a1 1 0 0 0 1-1v-4"/></svg></span>Budget</div>
<div style="display:flex;align-items:center;gap:var(--k-space-2);min-height:var(--k-tap);padding:0 var(--k-space-3);background:var(--k-surface);border:1px solid var(--k-line);border-radius:var(--k-radius-card);font:500 var(--k-fs-meta)/1.3 var(--k-font-ui);color:var(--k-text)"><span style="display:grid;color:var(--k-text-2)"><svg width="20" height="20" style="width:var(--k-icon-lg);height:var(--k-icon-lg);flex:none" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M13 22h5a2 2 0 0 0 2-2V8a2.4 2.4 0 0 0-.706-1.706l-3.588-3.588A2.4 2.4 0 0 0 14 2H6a2 2 0 0 0-2 2v3.3"/><path d="M14 2v5a1 1 0 0 0 1 1h5"/><path d="m7.69 16.479 1.29 4.88a.5.5 0 0 1-.698.591l-1.843-.849a1 1 0 0 0-.879.001l-1.846.85a.5.5 0 0 1-.692-.593l1.29-4.88"/><circle cx="6" cy="14" r="3"/></svg></span>Paperwork</div>
<div style="display:flex;align-items:center;gap:var(--k-space-2);min-height:var(--k-tap);padding:0 var(--k-space-3);background:var(--k-surface);border:1px solid var(--k-line);border-radius:var(--k-radius-card);font:500 var(--k-fs-meta)/1.3 var(--k-font-ui);color:var(--k-text)"><span style="display:grid;color:var(--k-text-2)"><svg width="20" height="20" style="width:var(--k-icon-lg);height:var(--k-icon-lg);flex:none" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M12 7v14"/><path d="M3 18a1 1 0 0 1-1-1V4a1 1 0 0 1 1-1h5a4 4 0 0 1 4 4 4 4 0 0 1 4-4h5a1 1 0 0 1 1 1v13a1 1 0 0 1-1 1h-6a3 3 0 0 0-3 3 3 3 0 0 0-3-3z"/></svg></span>Director’s Book</div>
<div style="display:flex;align-items:center;gap:var(--k-space-2);min-height:var(--k-tap);padding:0 var(--k-space-3);background:var(--k-surface);border:1px solid var(--k-line);border-radius:var(--k-radius-card);font:500 var(--k-fs-meta)/1.3 var(--k-font-ui);color:var(--k-text)"><span style="display:grid;color:var(--k-text-2)"><svg width="20" height="20" style="width:var(--k-icon-lg);height:var(--k-icon-lg);flex:none" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M12 22a1 1 0 0 1 0-20 10 9 0 0 1 10 9 5 5 0 0 1-5 5h-2.25a1.75 1.75 0 0 0-1.4 2.8l.3.4a1.75 1.75 0 0 1-1.4 2.8z"/><circle cx="13.5" cy="6.5" r=".5" fill="currentColor"/><circle cx="17.5" cy="10.5" r=".5" fill="currentColor"/><circle cx="6.5" cy="12.5" r=".5" fill="currentColor"/><circle cx="8.5" cy="7.5" r=".5" fill="currentColor"/></svg></span>Look Book</div>
</div>
```

| Module | Lucide icon | Module | Lucide icon |
|---|---|---|---|
| Characters & Locations | `Users` | World & Lore | `Globe` |
| Outline | `Network` | Screenplay | `FileText` |
| Research | `Microscope` | Idea & Themes | `Lightbulb` |
| Pitch | `Presentation` | Breakdown | `Tag` |
| Shots & Boards | `Table` | Schedule & Call Sheets | `Clapperboard` |
| Camera & Light | `Video` | Art | `Hammer` |
| Costume & Makeup | `Shirt` | Sound & Music | `Music` |
| Stunts & Effects | `Flame` | VFX | `Sparkles` |
| Locations | `MapPin` | Cast & Crew | `Users` |
| Calendar | `CalendarDays` | Budget | `Wallet` |
| Paperwork | `FileBadge2` | Director’s Book | `BookOpen` |
| Look Book | `Palette` |  |  |

Navigation around them: `Home` for Home in the breadcrumb (icon only, named *Home*), `LayoutGrid` for *Back to the project*, `SlidersHorizontal` for *Choose departments*, `Tv` for *Episodes* in a series, `Orbit` for a franchise.

- **Must** take a module's icon from the module list, never choose one in a screen.
- **Never** reuse a module's icon for something else. `Sparkles` is VFX in Kwark; it is never a badge for "AI" or "new", and Kwark has no sparkle decoration anywhere ([AI and authorship](https://kwark.space/designSystem/foundations/ai-and-authorship.md)).
- `Users` currently stands for two modules, Characters & Locations and Cast & Crew. They sit in different phases, and each always carries its word, so this is tolerated, not a pattern.
- An unknown module name gets `Tag`, a neutral mark, so a board saved by a newer copy of the app still draws (`boardIcon`).

## Custom SVG

Kwark draws its own SVG only for things that are not icons and that Lucide cannot have: the timeline's scene blocks, the script overview's page thumbnails, lighting and blocking overheads, charts, the Kwark mark in the loader. In November 2026, 32 files under `pages`, `components` and `shared` contain an inline `<svg>`; most are these. An inline SVG that draws a chevron, a bin, a plus or a close is a bug.

## Right-to-left and direction

A screenplay line in Urdu, Arabic, Persian or Hebrew runs right to left (Decision 0046), but Kwark's chrome stays in English and left to right. Directional chrome glyphs (back, the drill-down chevron) therefore do not mirror today. If the chrome is ever translated into a right-to-left language, back and forward chevrons mirror; play, rewind and timeline direction do not, because time runs the same way on every screen.

## Do and don't

**Do:** A row for Scene 12 with a 16px `FileText` lead, the title, and a ⋯ `IconButton` named *More actions for Scene 12*. The phone header's back chevron at 20px, named *Back to Outline*.

**Don't:** A toolbar of seven unlabelled icons (lock, eye, layers, zap, sliders, copy, bin) with tooltips as their only names, two of them from a different pack and one hand-drawn.

**Do:** *Menu* with a 14px chevron down, because it opens a menu. *Export PDF* with no chevron, because it starts at once.

**Don't:** *Save* with a chevron because it sits in a row of buttons that have them, or a chevron right on a row that opens a dialog instead of another page.

## AI readiness test

**Task:** Add a "Dailies" entry to the Prepare to shoot module list, with its icon, and a ⋯ button on each day's row in the Dailies list.

**Give the agent:** This page, productionModules.ts, departments.ts, the ListRow and IconButton components.

**Constraint:** Use only Lucide. Do not reuse an icon another module already uses.

**A reliable answer:**
- One Lucide icon chosen that no other module uses, registered in the module list, not in the screen
- Drawn through Icon at one of the three sizes (md in menus), stroke 1.75
- Every row's ⋯ is an IconButton with a label like More actions for Day 4
- No chevron on buttons that act at once
- No inline SVG and no second icon pack
