Kwark. Design System
Open Kwark

Screenwriting

Build a writing surface whose page on screen is the printed page, with the elements, revisions, outline and timeline a working screenwriter expects, and nothing that judges the work.

Creative app kits
7.

INT. EDIT SUITE – NIGHT

Reel 3 loops on the monitor. MIRA (30s) leans in.

MIRA

to herself

I didn’t shoot this. Nobody did.

CUT TO:

Who it is for

Teams building a screenplay editor, a writers’ room tool, a script reader for producers, or a notes app for development executives. The people using it are writers, often with a day job, writing in the evening for months on one script; co-writers; script editors; and later the director, producer and crew, who read the same pages as a production document.

Screenwriting is the heart of Kwark. Everything in this kit is in the app: the Screenplay page, its Screenplay elements, the Outline’s Index cards and Outline board, the Story spine, the Script timeline, Script revision diff, Version history and Quick note.

The screens

Screen What it does Kwark components
Project library Every script as a poster; open goes to the project home Project cover
The page Write, with the elements, in a room of the writer’s choosing Screenplay page, Screenplay elements, Writing rooms
Scene navigator Jump by scene heading; reorder scenes List row, Tree view
Timeline Runtime estimate and where each scene sits Script timeline
Outline Page, Cards and Board views of beats; each view addressable (Decision 0029) Index card, Outline board, Story spine
Characters A page per character, arranged by the writer Character card, Character page header
Research Private boards, shared on purpose Research card
Revisions Lock, issue colours, see what changed Script revision diff
History Named versions, compare, restore Version history
Comments Notes from readers in the margin Comment pin, Drawer
Export PDF, plain text formats Print and export

Live demo

The page, a card from the outline and the phone timeline strip, built from the components on this site.

INT. EDIT SUITE – NIGHT

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

MIRA

to herself

I didn’t shoot this. Nobody did.

CUT TO:

Act 2 · Beat 14

The frame nobody shot

Mira finds a frame that was never on the camera report.

p. 41Scene 12
<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 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 kw-sp-revised">I didn’t shoot this. Nobody did.</p>
<p class="kw-sp-transition">CUT TO:</p>
</article>
<article class="kw-index-card" aria-label="Beat 14, The frame nobody shot"><div class="kw-index-card__top"><span>Act 2 · Beat 14</span></div><h3 class="kw-index-card__title">The frame nobody shot</h3><p class="kw-index-card__body">Mira finds a frame that was never on the camera report.</p><div class="kw-index-card__foot"><span class="kw-index-card__landing">p. 41</span><span>Scene 12</span></div></article>

Domain conventions

These are the conventions working writers, readers and crews expect. Where they vary, the kit says so.

The page

  • Courier, 12 point, ten characters to the inch. Page count is only meaningful in a fixed-pitch face. Kwark uses Courier Prime.
  • Paper. US Letter (8.5 × 11 in) is the convention in the US industry and the one Kwark draws on screen. A4 is used in many other territories; if you support it, keep the indents in characters and let the line count per page change, and say which paper a page count refers to.
  • Margins. About 1.5 in on the left (room for binding brads), about 1 in on the right, top and foot. Kwark’s measured proportions are on the Screenplay page.
  • One page is roughly one minute of screen time. This is a rule of thumb, not a standard; dialogue runs faster than action. Kwark’s Script timeline estimates from content and lets the writer set their film’s pace.
  • Page numbers sit top right with a full stop (“7.”). The first page is conventionally unnumbered.

The elements

Scene heading, action, character, parenthetical, dialogue, transition. Indents and widths are on Screenplay elements. In short: character cues at 2.2 in from the action margin, dialogue at 1.0 in and 3.3 in wide, parentheticals at 1.6 in and 2.8 in wide, transitions right-aligned.

Scene headings (sluglines)

  • INT. or EXT. (or INT./EXT., also written I/E), then the place, then a dash and the time: INT. EDIT SUITE – NIGHT.
  • Time of day is usually DAY or NIGHT; writers also use MORNING, EVENING, DAWN, DUSK, CONTINUOUS, LATER, MOMENTS LATER. Production reads only day or night from it for the Stripboard strip, so offer the writer’s own word and map it, never rewrite it.
  • Keep the same spelling of a place every time. Kwark offers places already used in the script as completions, so EDIT SUITE does not become EDITING SUITE in Scene 40 and turn into a second location in the schedule.

Dialogue across a page break

When a speech breaks across pages, the page ends with (MORE) under the dialogue, and the next page repeats the cue with (CONT’D). A character who speaks again after an action line in the same scene may also carry (CONT’D); many writers switch that off. Make it a project setting.

Shooting scripts

Once a script goes to a crew it is locked. From then on:

  • Scene numbers appear in both margins and never change. A new scene between 12 and 13 is 12A; a cut scene stays as 12 OMITTED.
  • Changed lines carry an asterisk in the right margin.
  • Each issue of changed pages is printed on the next colour in the industry sequence: White, Blue, Pink, Yellow, Green, Goldenrod, Buff, Salmon, Cherry, then Double White and on. Pages added between pages are A pages (12A). See Script revision diff.

File formats

The floor for a screenwriting app is PDF out, plus at least one plain format in and out: Fountain (plain-text screenplay markup) and Final Draft’s FDX (XML) are what writers move scripts between apps with. Do not lose formatting, scene numbers or revision marks on the way through. Kwark’s PDF export is Latin-only through jsPDF; scripts in Indian scripts print through the browser’s Save as PDF. Read Writing systems.

Keyboard map

The element flow follows the convention writers learned in Final Draft and other editors.

Key Does
Enter Ends the element and starts the expected next one: heading → action, character → dialogue, dialogue → action
Tab On an empty line, cycles the element type; after a character cue, starts a parenthetical
Shift + Tab Cycles backwards
⌘ 1 – ⌘ 6 Scene heading, action, character, parenthetical, dialogue, transition
⌘ S Says Saved; Kwark saves continuously (Decision 0014)
⌘ F Find in the script
⌘ Z / ⇧ ⌘ Z Undo, redo
⌘ K Command palette (Command palette)

Menus are desktop-grade: File · Edit · Format · View · Help (Decision 0015), with shortcuts shown in each item and panels under View > Panels. Read Menus and shortcuts.

Phone and desktop

Desktop is where scripts are written: the page at its printed width, the scene navigator on the left, panels on the right (comments, revision, characters), the timeline under the menu. The page never shrinks its type to make room; when a panel squeezes it, the margins give way first, then indents keep their printed proportions below a 580px column.

Phone is where scripts are read, revised in small ways and noted. The rules:

  • One header line: back, Scenes, and Menu ▾ (Decision 0015, 0016). No breadcrumb, no subtitle.
  • The timeline is a 22px strip under the menu; slide to find a scene, tap to open; sideways it becomes a full-screen bay (Decision 0007).
  • One floating control: the Quick note pen (Decision 0011). Comments live in the menu, not a second button.
  • Typing on a phone keeps the element flow: a small element strip above the keyboard switches element types with labelled buttons.

AI and authorship

Kwark never judges the script (Decision 0002). For a screenwriting app built on this system:

  • Never score, grade, give coverage, rate dialogue, flag “weak” scenes, predict box office, or compare the writer to others. Competitors’ AI coverage is not a gap Kwark fills.
  • Never rewrite the writer’s words, autocorrect a slugline into a different place, or fill an empty scene.
  • May measure (runtime, talk and action, pages per act), find (places already used, a character’s scenes), carry (scenes into the breakdown) and convert (phonetic typing into an Indian script).
  • If a team adds generative suggestions, each proposed word carries the Revision mark: tint, dotted rule, margin star, and a label saying where it came from. Nothing is saved into the script until the writer accepts or edits it; edited words are theirs. Read AI assistance.
  • The script is private by default. Never send it to a model provider without the writer turning that on, knowing what is sent and where.

Runs about 1 h 44 min · 6 min over the 98 min you set, in grey.

Do

This scene drags. Consider cutting Mira’s second line.

Don’t

Accessibility notes for this craft

  • Announce the element type when it changes, politely.
  • The page’s colours come from the room; every room passes 4.5:1 for ink on page.
  • Never put meaning in a character colour alone; the cue says who speaks.
  • Support system text zoom by scaling --k-fs-script, not by reflowing the page.

Starter prompt

You are building the writing surface of a screenwriting app on the Kwark Design System. Read https://kwark.space/designSystem/kits/screenwriting.md, /components/screenplay-page.md, /components/screenplay-elements.md, /components/script-timeline.md and /foundations/ai-and-authorship.md first. Build a page component that uses .kw-script-page and the six element classes with indents in ch at --k-fs-script, an element flow on Enter and Tab as in the keyboard map, and a phone layout with one header line and the 22px timeline strip. Use only --k-* tokens. Do not add any feature that scores, rates or rewrites the writer’s text. List anything you need that the system does not define, instead of inventing it.

AI readiness test

Task. Build the screenplay page with element switching and a locked-script mode.

Give the agent. Screenwriting kit, Screenplay page, Screenplay elements, Script revision diff.

Constraint. After lock, a new scene inserted between 12 and 13 must not renumber anything.

A reliable answer

  • Indents in ch at --k-fs-script with line-height 1
  • Enter and Tab follow the keyboard map
  • New scene becomes 12A after lock
  • Changed lines get a right-margin asterisk
  • Revision colours follow White, Blue, Pink, Yellow, Green, Goldenrod
  • No scoring or rewriting of text

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

Open .mdllms.txt
Loading…