# Typography

> Three faces with three jobs, six sizes, and a screenplay page measured against printed scripts down to the character. What to set, at what size, and what never to shrink.

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

## Three faces, three jobs

Kwark uses one typeface for the interface, one for the titles of things, and one for the script. Each has one job, and a face never borrows another's.

| Role | Token | Face | Weights loaded in the app | For |
|---|---|---|---|---|
| UI | `--k-font-ui` | Poppins | 300, 400, 500, 600 | Everything that is not below: body, rows, buttons, menus, fields |
| Display | `--k-font-display` | Raleway | 400, 500, 600, 700, 800 | Page titles, section headings, row and card titles |
| Screenplay | `--k-font-screenplay` | Courier Prime | 400, 700 | The script itself, and anything that quotes it as it prints |
| Mono | `--k-font-mono` | The system monospace (SF Mono, Menlo) | System | Codes, take and slate numbers, timecodes, figures in tables |
| Script in another language | `--k-font-script-*` | Courier Prime, then the script's Noto family | 400, 600 | Screenplay lines in Hindi, Tamil, Urdu, Japanese and 13 more scripts ([below](#other-scripts-in-the-screenplay)) |

The weights are the ones `index.html` asks Google Fonts for. Poppins 700 is not loaded: a `font-weight: 700` on Poppins makes the browser fake a bold, which smears at small sizes. Use 600.

**Why Poppins and Raleway.** Poppins is geometric and open at 12–14px, which is where most of the interface lives. Raleway is narrower and more literary at 16px and up; a scene's name set in Raleway reads as the name of something, not as a label. The pairing comes from the September 2026 stylesheets, which remain the reference for Kwark's look.

**Why Courier Prime.** A screenplay is a printed artefact with a 100-year format, and its page count is how a production budgets and schedules. Every Courier is 0.6 em wide, so ten characters fill an inch at 12pt, and one page is about a minute of screen time. Courier Prime is the modern cut of that measure: same widths, better drawn. See [The screenplay page](#the-screenplay-page).

> **For agents:** Set type with `font: <weight> var(--k-fs-*)/<line-height> var(--k-font-*)`. Never write a font name, and never write a `px` font size, in a component. Never set Poppins at 700; use 600.

## Six sizes

| Token | Value | Name | Use |
|---|---|---|---|
| `--k-fs-hero` | clamp(36px, 4.5vw, 64px) | Hero | Landing and project hub, desktop only |
| `--k-fs-display` | 28px | Display | Page titles on a phone, big numbers |
| `--k-fs-head` | 20px | Heading | Section and page headings |
| `--k-fs-title` | 16px | Title | Row and card titles |
| `--k-fs-body` | 14px | Body | Body text and rows |
| `--k-fs-meta` | 12px | Meta | Captions, meta lines, chips |

| Size | Token | Weight | Line height | Use |
|---|---|---|---|---|
| 12 | `--k-fs-meta` | 400 for meta, 500 for chips and labels | 1.4 | Captions, meta lines under a row title, chips, field labels, hints |
| 14 | `--k-fs-body` | 400 for reading, 500 for controls | 1.5 | Body text, rows, buttons, menu items, inputs |
| 16 | `--k-fs-title` | Raleway 600 | 1.25 | Row titles, card titles, the phone header's one-word title, sheet titles |
| 20 | `--k-fs-head` | Raleway 500 | 1.2 | Section and page headings on a desktop |
| 28 | `--k-fs-display` | Raleway 600 | 1.15 | Page titles on a phone, big numbers |
| 36–64 | `--k-fs-hero` | Raleway 700 | 1.05 | The landing page and the project hub on a desktop only. Never on a phone, never inside a module |

There is no 13, 15 or 18. A design that seems to need one usually needs a different weight or colour at the size above or below. `--k-fs-hero` is a `clamp(36px, 4.5vw, 64px)`, so it grows with the window and never needs a phone override.

**Do:** A scene row: *Scene 12* in Raleway 600 at 16px, then *INT. EDIT SUITE – NIGHT · 1 3/8 pages* in Poppins 400 at 12px in `--k-text-2`. Two sizes, two colours, one clear title.

**Don't:** The same row in four sizes (15px title, 13px heading, 11px page count, 10px badge), so nothing is clearly the title and the smallest text cannot be read on a phone.

## Weights

- **400** for anything read: body text, meta lines, the script.
- **500** for anything pressed: buttons, menu items, chips, tabs, segmented choices.
- **600** for titles: row and card titles, the phone header, dialog titles.
- **700** only for Raleway at hero size, and for Courier Prime where a writer chose bold in the script.

Never use weight alone to say a state (selected, unread, changed). Pair it with a mark, a colour step or a word, because a weight change of 100 is invisible to many readers.

## Line height and rhythm

Body text runs at 1.5, which at 14px is a 21px line. Titles run tighter (1.25 at 16px; 1.2 at 20px) because they are one or two lines and need to hold together. Meta runs at 1.4.

The screenplay is the exception and is never changed: 12pt type on 12pt leading, six lines to the inch, which on screen is 16px on 16px. Leading is the one typographic setting that moves the page count, so the editor treats any change to it as a change to the script's length and says so where it can be changed (`pagination/typeface.ts`).

## Measure

Prose in the interface (a decision's explanation, a sheet's description, a long note) sits between 60 and 75 characters per line. The app uses `max-width: 70ch` most often for this; 64ch and 68ch also appear.

- The script has its own measure, set by the format: 61 characters of action, 33 of dialogue, 28 of a parenthetical on US Letter. It is never re-flowed to fit a window. On a narrow window the page shrinks in proportion instead.
- Tables and forms are not prose and do not take a measure; they take their columns.

## Numbers

Columns of numbers line up. Use `font-variant-numeric: tabular-nums` wherever figures stack: the stripboard, the budget, the call sheet's times, the day out of days, page counts in a scene list. The production office does this throughout (`ProductionOffice.css`).

- **Must** use tabular figures in any column, total or running timer.
- **Must** use `--k-font-mono` for codes that are read character by character: slate and take numbers, timecodes, scene numbers like `12A`, invite codes.
- **Never** use mono for prices or page counts in running text; they are words in a sentence there.
- **Always** write eighths of a page the way a production does: `1 3/8`, not `1.375`.

## Truncation

Truncate the chrome, never the work.

- A row title, a header title or a breadcrumb item that runs out of room ends in an ellipsis on one line (`overflow: hidden; text-overflow: ellipsis; white-space: nowrap`), and its full text is available as the element's accessible name or a tooltip.
- A card's summary may clamp at two lines (`-webkit-line-clamp: 2`, the app's most common clamp), three at most.
- **Never** truncate the script, a character cue, a figure of money, a date, a call time, or anything a person is asked to confirm. If it does not fit, the layout is wrong.
- **Never** truncate a button's word. `TextButton` never shrinks and never clips (`components/ui/system.css`); on the narrowest phones (below 360px) its padding gives way first.

## The screenplay page

The page in the editor is the page that prints. It was measured against Highland Pro's own printed PDFs line by line in September 2026, and corrected again in Decision 0041 when a container rule moved cues and dialogue by a tenth of an inch.

| | US Letter | A4 |
|---|---|---|
| Paper | 8.5 × 11 in | 8.27 × 11.69 in |
| Margins (top, bottom, left, right) | 1, 0.75, 1.5, 0.9 in | 1, 0.75, 1.5, 0.67 in |
| Lines per page | 55 | 60 |
| Action and scene heading | 6.1 in, 61 characters | 6.1 in, 61 characters |
| Dialogue | 1.0 in from the margin, 3.3 in wide, 33 characters | same |
| Parenthetical | 1.6 in from the margin, 2.8 in wide, 28 characters | same |
| Character cue | 2.2 in from the margin | same |

A4 is a first-class paper, not an afterthought: it takes the narrower width out of the right margin, so the action measure stays 6.1 inches and an A4 script does not run long. The paper a script is set on is chosen once, at export, and the editor, the PDF and the schedule's eighths all count on it (`pagination/constants.ts`).

On screen at 100%: the page is 816px wide (8.5 in at 96 to the inch), the head and foot margins are 96px, and each line is 16px. A typeface choice in the editor (Courier Prime, Courier New, DM Mono, or Noto Sans Mono with Devanagari) changes how the page looks, never how long it is, because all four set 0.6 em.

Scene headings, character cues and transitions are capitalised because the format capitalises them. This is the only all-caps text in Kwark.

```html
<div style="width:100%;max-width:calc(61ch + 2 * var(--k-space-6));margin:0 auto;padding:var(--k-space-6);background:var(--k-page, var(--k-surface));color:var(--k-text);border:1px solid var(--k-line);border-radius:4px;font:400 var(--k-fs-body)/1.15 var(--k-font-screenplay)">
  <div>INT. EDIT SUITE – NIGHT</div>
  <div style="margin-top:1.15em;max-width:61ch">Mira scrubs back through the take. Stops on a frame nobody else noticed: the actor looks at the lens.</div>
  <div style="margin-top:1.15em;padding-left:22ch">MIRA</div>
  <div style="padding-left:16ch;max-width:calc(16ch + 28ch)">(quietly)</div>
  <div style="padding-left:10ch;max-width:calc(10ch + 33ch)">Play it again. Slower. I want to see when he decides.</div>
  <div style="margin-top:1.15em;text-align:right">CUT TO:</div>
</div>
```

The demo sets the real indents in `ch`, which in a monospace face is one character: dialogue starts 10 characters in, the parenthetical 16, the cue 22, exactly as they do in inches at 12pt.

> **For agents:** Never restyle the screenplay page with interface tokens. Its type is `--k-font-screenplay` at 12pt (16px at 100%) on 16px lines; its colours come from the room (`--k-page`, `--k-text`). Never change the indents, widths or lines per page in a component: they live in `pagination/constants.ts` and `pagination/typeface.ts`, and a change there must be re-checked against the Highland reference pages.

## Other scripts in the screenplay

Filmmakers write whole screenplays in Hindi, Tamil, Urdu, Japanese or Spanish, or write action in English while characters speak another language, or switch mid-scene. Decision 0046 (accepted 16 November 2026) sets how the script's type follows the language. The menus and chrome stay in English; the script itself is set in its own script. How languages are chosen and typed is in [Writing systems](https://kwark.space/designSystem/foundations/writing-systems.md); the type is here.

### Script font roles

Every script role starts with the screenplay face and falls back to a Noto family for the script. Latin letters, digits and punctuation inside a Hindi line stay in Courier Prime and keep their 0.6 em measure; only the characters Courier Prime lacks fall through to Noto.

| Token | Falls back to | Set on `lang` |
|---|---|---|
| `--k-font-script-devanagari` | Noto Sans Devanagari | `hi`, `mr`, `ne`, `sa` |
| `--k-font-script-bengali` | Noto Sans Bengali | `bn` |
| `--k-font-script-tamil` | Noto Sans Tamil | `ta` |
| `--k-font-script-telugu` | Noto Sans Telugu | `te` |
| `--k-font-script-kannada` | Noto Sans Kannada | `kn` |
| `--k-font-script-malayalam` | Noto Sans Malayalam | `ml` |
| `--k-font-script-gujarati` | Noto Sans Gujarati | `gu` |
| `--k-font-script-gurmukhi` | Noto Sans Gurmukhi | `pa` |
| `--k-font-script-odia` | Noto Sans Oriya | `or` |
| `--k-font-script-sinhala` | Noto Sans Sinhala | `si` |
| `--k-font-script-urdu` | Noto Nastaliq Urdu, then Noto Sans Arabic | `ur`, with line height 1.9 |
| `--k-font-script-arabic` | Noto Sans Arabic | `ar`, `fa` |
| `--k-font-script-hebrew` | Noto Sans Hebrew | `he` |
| `--k-font-script-jp` | Noto Sans JP | `ja` |
| `--k-font-script-sc` | Noto Sans SC | `zh` |
| `--k-font-script-kr` | Noto Sans KR | `ko` |
| `--k-font-script-thai` | Noto Sans Thai | `th` |

Each value is `var(--k-font-screenplay), '<Noto family>', sans-serif`, defined in the app's `styles/tokens.css`. The editor applies them by the block's `lang` attribute (`EditorModule/styles/scriptLanguage.css`), in the editor and in the print preview alike, so a speech marked Tamil is set in Tamil type wherever it is drawn. The Noto families load from Google Fonts with `unicode-range`, so a script written only in English downloads none of them.

They are part of the app's token file. This site's `kwark.css` does not include them, because it does not load fonts; load the Noto family you need and use the token.

### What the type has to survive

- **Measure.** Indian, Arabic and East Asian scripts have no monospace tradition. Their lines are measured as if they were Latin, so a line of Devanagari or Tamil may run a little long against the printed 33-character dialogue column; the editor says so where a typeface is chosen (`pagination/typeface.ts`).
- **Height.** Vowel signs and conjuncts rise above and fall below the Latin line. Nastaliq is taller still, which is why Urdu gets a line height of 1.9. When a script with Indian-script lines prints, those lines are set at 0.9× so they clear the line above.
- **Direction.** Urdu, Arabic, Persian and Hebrew blocks carry `dir="rtl"` and flow right to left (`unicode-bidi: plaintext`), while English lines beside them stay left to right. A right-to-left cue and parenthetical stay centred; a right-to-left transition sits at the left.
- **Print.** The built-in PDF export (jsPDF) can only set Latin. A script with text it cannot set prints through the browser's Save as PDF from the export preview instead, so the text is shaped correctly; Decision 0046 widens this from the Indian scripts to every script outside the PDF's Latin set. The export dialog says what that copy leaves out (notes, alternates and translation appendices).

### Rules

- **Must** set script text through `lang` on its block and let `--k-font-script-*` follow it. **Never** write a Noto family name in a component.
- **Never** set an Indian, Arabic or East Asian script in Poppins or Raleway at 12px and assume it reads; check it at the size it will be used, on a phone.
- **Never** letter-space, uppercase or synthesise bold on a string that may contain a non-Latin script.
- **Never** let a script font change the page geometry: indents, widths and lines per page stay the format's.

## Type on phones

- **Never** set anything under 12px on a phone, and nothing under 11px anywhere.
- On a phone, controls that are 12px on a desk may step up to 14px (the segmented control does, `components/ui/system.css`), because a thumb needs a larger target and a larger word.
- The phone header's title is one word at 16px Raleway 600. No subtitle under it (Decision 0016).
- `--k-fs-hero` never appears on a phone; the largest type there is `--k-fs-display`, 28px.

**Paper keeps its sizes.** The call sheet, the stripboard's strips, the day timeline's blocks and anything inside print rules are drawn at the size they print, because changing them changes what prints (Decision 0034). The 12px floor is for the interface around them.

**Known debt.** A search of the app's source in November 2026 still finds around 600 lines that set 10px or 11px type, many of them in the screenplay timeline (9px and 10.5px labels). They are being moved to `--k-fs-meta` as each file is touched; do not copy them.

## Print

- The script prints at 12pt Courier Prime on the chosen paper, with `@page` sized to it.
- Interface chrome does not print: the floating dial and the editor's beat labels and ribbons hide under `@media print`.
- Production paperwork prints at the sizes designed for paper; see [Print and export](https://kwark.space/designSystem/patterns/print-and-export.md).

## Writing in type

- Sentence case everywhere: *Save scene*, *Call sheets*, *Prepare to shoot*. Not *Save Scene*.
- No all-caps labels, and no letter-spaced small caps above sections. The app's phone menu still draws its group names in letter-spaced capitals (`.k-menu__group`); that is a known difference from this rule and is not a pattern to copy.
- Italic is for titles of works and for a word the writer stressed. It is never a state.

## AI readiness test

**Task:** Add a "Pages" column to the scene list that shows each scene's length, and a total at the foot.

**Give the agent:** This page, Layout, the scene list's existing row markup.

**Constraint:** No new font sizes or faces. The total must line up with the rows on a phone and a desktop.

**A reliable answer:**
- Lengths written in eighths (1 3/8), not decimals
- font-variant-numeric tabular-nums on the column and the total
- --k-fs-meta in --k-text-2 for row lengths, --k-fs-body 500 for the total
- Nothing under 12px on a phone
- Scene titles truncate with an ellipsis, the page count never does
