Kwark. Design System
Open Kwark

Screenplay page

The page a writer writes on: US Letter geometry, 12pt Courier, one 16px grid, and the same line breaks as the printed PDF.

ComponentsCreative toolsIn the app
7.

INT. EDIT SUITE – NIGHT

Reel 3 loops on the monitor. MIRA (30s) leans in until the glow of the screen is the only light on her face.

MIRA

to herself

I didn’t shoot this. Nobody did.

She stops the playhead on a frame nobody remembers filming.

CUT TO:

INT. EDIT SUITE – NIGHT

Reel 3 loops on the monitor. MIRA (30s) leans in until the glow of the screen is the only light on her face.

MIRA

to herself

I didn’t shoot this. Nobody did.

She stops the playhead on a frame nobody remembers filming.

CUT TO:

<article class="kw-script-page kw-script-page--crop" aria-label="Page 7 of Blank Pages">
<p class="kw-sp-scene" data-number="12">INT. EDIT SUITE – NIGHT</p>
<p class="kw-sp-action">Reel 3 loops on the monitor. MIRA (30s) leans in until the glow of the screen is the only light on her face.</p>
<p class="kw-sp-character">MIRA</p>
<p class="kw-sp-paren">to herself</p>
<p class="kw-sp-dialogue">I didn’t shoot this. Nobody did.</p>
<p class="kw-sp-action">She stops the playhead on a frame nobody remembers filming.</p>
<p class="kw-sp-transition">CUT TO:</p>
</article>

When to use

Wherever a person reads or writes screenplay text as a page: the editor, the reader, a table-read view, a printed copy, an embedded excerpt in a pitch. A screenplay is judged on its page, so the screen must agree with the PDF line for line (Decision 0041).

When not to

  • For a list of scenes or a synopsis. Use an Index card or a List row.
  • For breakdown marking. The Breakdown page uses a looser 13.5px reading measure on purpose, because it is marked up, not paginated.
  • Never shrink the type to fit more on a phone. On a narrow screen the indents keep their printed proportions instead (below a 580px column).

Anatomy in use

Part Spec Why
Sheet 85ch wide (8.5in), 1px --k-line border, no shadow Flat desk, flat paper (Decision 0041)
Margins Left 14.17ch, right 9.48ch, top and foot 6 lines The app’s printed proportions, measured from Highland’s PDFs
Grid Every line 1em; scene headings sit two lines below the last line A heading off the grid shows on ruled paper
Scene numbers Both margins, 50% --k-text-2 Locked scripts carry numbers on both sides, as printed
Page number Top right, with a full stop “7.” is how a screenplay numbers its pages
Revision star * in the right margin A changed line in a revised script

Rooms

The page takes --k-page from the writing room (data-room on any ancestor): Studio, Daylight, Paper, Lamplight, Midnight. Rooms change paper and ink only. They never add a light, a glow or a texture over the words.

Writing

  • Sluglines are written by the writer. Kwark offers completions from places already used in the script; it never rewrites a heading.
  • Sample text in specimens is real screenplay text (Scene 12, INT. EDIT SUITE – NIGHT, Mira), never lorem ipsum.

A white page at 12pt Courier whose dialogue wraps at 33 characters, so page 7 on screen is page 7 in the PDF.

Do

A page that reflows to the window width, or a proportional font “for readability”. The page count stops meaning anything.

Don’t

Anatomy

  1. Sheet: .kw-script-page, width min(85ch, 100%), padding 6em 9.48ch 6em 14.17ch, --k-fs-script (16px) Courier Prime, line-height 1.
  2. Elements: see Screenplay elements for every indent.
  3. Thumbnail: .kw-script-page--thumb scales the type to 0.44, for page strips and specimens.
  4. Crop: .kw-script-page--crop shortens the head and foot margins for excerpts.

Tokens

Token Light Dark
--k-fs-script 16px
--k-font-screenplay ‘Courier Prime’, ‘Courier New’, monospace
--k-page
--k-accent #98633f #98633f
--k-text #0f172a #e3e3e3
--k-text-2 #5b6779 #9ca3af
--k-line #e2e8f0 rgba(255, 255, 255, .1)

Measurements

Courier Prime at 16px is 9.6px per character, so 10 characters make one printed inch at 96dpi. Every indent is written in ch: 22ch is the printed 2.2in. Change --k-fs-script and the whole page scales without breaking a line differently.

React

In the Kwark app: import EditorPage from '@/pages/Understanding/EditorModule/components/EditorPage'.

// The page is the editor itself. Its geometry lives in styles/editor.css (.editor-page)
// and in the screenplay nodes (nodes/Scene.ts, Character.ts, Parenthetical.ts, Transition.ts).
<EditorRoute />
Prop Type Notes
room 'studio' | 'daylight' | 'paper' | 'lamplight' | 'midnight' set on the editor root as data-room; the page colour follows it

HTML and CSS

Works anywhere with kwark.css.

<article class="kw-script-page kw-script-page--crop" aria-label="Page 7 of Blank Pages">
<p class="kw-sp-scene" data-number="12">INT. EDIT SUITE – NIGHT</p>
<p class="kw-sp-action">Reel 3 loops on the monitor. MIRA (30s) leans in until the glow of the screen is the only light on her face.</p>
<p class="kw-sp-character">MIRA</p>
<p class="kw-sp-paren">to herself</p>
<p class="kw-sp-dialogue">I didn’t shoot this. Nobody did.</p>
<p class="kw-sp-action">She stops the playhead on a frame nobody remembers filming.</p>
<p class="kw-sp-transition">CUT TO:</p>
</article>
  • Wrap the page in <article> named with the page number and project (“Page 7 of Blank Pages”).
  • Screenplay elements are paragraphs. Expose the element type to assistive technology through the editor’s element menu, not with ARIA roles on each line.
  • Scene numbers and the page number are visual duplicates of data the editor announces; keep them aria-hidden when they are generated content.
  • Every room passes 4.5:1 for ink on page; the scene heading uses --k-accent, which each room sets to its pencil colour.

Rules

  • Must set screenplay text in --k-font-screenplay at --k-fs-script with line-height 1, so every line sits on one grid.
  • Never reflow the page to the window; keep the printed indents in ch and let the narrow-page rule keep proportions below a 580px column.
  • Never add a glow, light layer, texture or shadow to the page or the desk (Decision 0041).
  • Always match the PDF: if the screen and the export wrap a line differently, the screen is wrong.
  • Never change the writer’s words to fit a format; Kwark formats, it does not rewrite (Decision 0002).

AI readiness test

Task. Show a read-only excerpt of Scene 12 inside a pitch document.

Give the agent. Screenplay page, Screenplay elements, Writing rooms.

Constraint. The excerpt must wrap exactly as the printed script does.

A reliable answer

  • Uses .kw-script-page with --crop
  • Indents in ch, not px
  • Courier Prime at --k-fs-script
  • No glow or shadow on the sheet
  • Article named with page and project

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

Open .mdllms.txt
Loading…