Kwark. Design System
Open Kwark

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.

Basics
Blank Pages
Draft 3 · 94 pages · saved a moment ago
INT. EDIT SUITE – NIGHT
Mira scrubs back. Stops.
MIRA
Play it again.
Day 0406:30 call1 3/8 pp

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)

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.

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

--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.

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.

Do

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.

Don’t

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.

INT. EDIT SUITE – NIGHT
Mira scrubs back through the take. Stops on a frame nobody else noticed: the actor looks at the lens.
MIRA
(quietly)
Play it again. Slower. I want to see when he decides.
CUT TO:
<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.

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; 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.

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

Give this Markdown to your coding agent or share its URL.

Open .mdllms.txt
Loading…