Kwark. Design System
Open Kwark

Settings

Anything chosen once and kept lives in one Settings window, grouped by what it changes, each row saying what it does and whether it is for this project or all your scripts; optional features start off, and every change applies at once.

Patterns
Suggest names All your scripts
Characters offered as a cue is typed, from the cast and the script.
Timeline This project
The film's running time above the page, scene by scene.

The problem

A writer switching to Kwark from a decade in professional screenwriting software looks for the settings first: page size, what Return does after a character cue, whether names are suggested. In September 2026 she would not have found them. Choices were scattered as checkboxes inside menus under headings like “How the page reads”. The founder called that “a lazy way to hand out options” and asked where the settings were.

There is a second problem. A writer who is nervous should not open a new project to find it already counting, timing and outlining her. A setting’s default is a claim about the person (the audit’s lesson: “Defaults are claims”). A rhythm ring on Home, a stopwatch on the project page, a story stamped “Research” on creation: each told the writer something about herself she had not chosen.

Kwark’s answer

One Settings window

The screenplay’s Settings… (⌘, in File) opens one window (components/modals/SettingsModal.tsx) with six sections:

Section Holds
Appearance Room, character colours, writing insights, timeline
Page Paper, and what the page shows
Format & elements For each element: after it, what Return makes; on it, what Tab turns it into
Writing Suggest names, Suggest extensions, Finish transitions, Enter on an empty line changes it, Check spelling, writing mode and languages
Structure & production Map the outline onto the script, What the page shows (the outline level), Pre-production on the page, Coverage help in the shot list
Keyboard The element digits, which the writer can reassign

Help › Keyboard shortcuts (⌘/) opens the same window at Keyboard.

Every row says what it does and where it applies

Each row is a title, one line of detail, the control, and a scope tag:

  • All your scripts: kept on this device for every script (“Suggest names”, “Paper”).
  • This project: kept with the project, so collaborators see the same (“Character colours”, “Timeline”, “Map the outline onto the script”).

Real rows:

  • Paper: “The page count, where pages break, the schedule’s eighths and the PDF all follow it. A4 holds 60 lines, US Letter 55.”
  • Character colours (This project): “Each voice in its colour — the one it has in the cast list, the breakdown and the shot list.”
  • Writing insights (This project): “The character’s card beside a cue, and the markers on a speech that open what it is doing.”
  • Timeline (This project): “The film’s running time above the page, scene by scene.”
  • Suggest names: “Characters offered as a cue is typed, from the cast and the script.”
  • Suggest extensions: “After “(”: the ones this script uses first, then V.O., O.S., CONT’D and the rest.”
  • Finish transitions: “The rest of a transition shown faint as it is typed; Tab takes it.”
  • Enter on an empty line changes it: “An empty speech becomes action; an empty parenthetical, dialogue — instead of leaving a blank line.”
  • Check spelling: “The browser’s own spelling check, underlined on the page.”
  • Pre-production on the page (This project): “Breakdown, shot list and schedule as tabs beside Screenplay, worked on the script itself.”

Changes apply at once

There is no Save or Apply. A switch takes effect on the page behind the window as it is changed, and is kept. A digit reassigned in Keyboard works the moment it is chosen.

Optional things start off

  • Writing rhythm is off by default for everyone, out of Home, kept in Settings as a private, quiet option: no flame, no streak, no resets (Decision 0008).
  • Structure features default to off for a script with no linked outline; when the beat map is off, only its switch shows (Decision 0003).
  • Writing insights are off by default and say so.
  • New projects start empty: no stamped status, no pre-filled outline.

Outside the screenplay

Project-wide choices live in Project settings, from the project’s menu. The model row: When I open a project, with Project home (default) and Where I left off, each with a one-line meaning (Decision 0018). It is kept per person on this device today. Account choices (display name, picture, sign out, work offline) live in the account panel.

Anatomy

Part Rule
Section list Left on desktop, a first page on a phone; plain nouns
Row title The feature’s name, as in the menus
Detail line What it does or changes, in one sentence; may say “Off by default.”
Scope tag “This project” or “All your scripts”
Control Switch for on or off; segmented or select for one of several; a table for per-element maps
Disabled row Dimmed with its reason in the detail line (for example, “What the page shows” needs the outline mapped first)

Rules

  • Must put every kept choice in Settings, not in a menu as a checkbox.
  • Must give every row one line that says what it changes, and its scope.
  • Must apply changes at once; no Save or Apply buttons.
  • Must default optional, structure-aware and self-measuring features to off.
  • Must make every switch turn its feature fully off; a switch that leaves part of it behind is a bug (Decision 0003).
  • Never add a setting that does not change something a person can see.
  • Never use a setting to hide a design decision Kwark should make. If nearly everyone picks one option, make it the only behaviour (Decision 0018’s removal test).
  • Never default to anything that counts, times or grades the writer.
  • Always use the same name in Settings as in the menu that shows the feature.
  • Always show a disabled row’s reason in words.

Edge cases

  • A collaborator changes a This-project setting. It changes for everyone; the row’s scope tag says so before they change it.
  • Read-only person. Project rows show their state, disabled, with “Only people who can edit this project can change this.”
  • Two digits for one element. The later choice wins and the earlier element loses that digit; the Keyboard table shows the result at once.
  • A setting not saved to the account yet. Say where it is kept (“on this device”) rather than implying it follows the person.
  • Country-specific choices (tax, paperwork) are settings with the country named, never a fixed assumption.

Phone and desktop

On desktop Settings is a dialog with the section list on the left and rows on the right, closed with Escape or Close settings. On a phone it is a full-screen sheet: the first page lists the sections, each opens its own page with a labelled back row, and rows are 44px with the control on the right.

Writing

  • Titles are the feature: “Suggest names”, not “Enable name suggestions”.
  • Detail lines describe the effect, never the benefit: “The film’s running time above the page, scene by scene.”
  • Scope: exactly “This project” or “All your scripts”.

Accessibility

  • The window is a dialog labelled “Settings”; the section list is a navigation landmark labelled “Settings sections”.
  • Each switch’s accessible name is the row title; the detail line is its description.
  • Per-element selects carry full names: “After Character, Return makes”.
  • Changing a setting never moves focus.

Timeline (This project): “The film’s running time above the page, scene by scene.” Off until turned on.

Do

A “How the page reads” heading in the View menu with six unexplained checkboxes.

Don’t

Writing rhythm off by default, in Settings, with no flame and no streak.

Do

A rhythm ring on Home for every new account, counting days since the last session.

Don’t

Demo

Structure & production
Map the outline onto the script This project
The outline's acts and beats, landed on the scenes they belong to.
What the page shows This project
Map the outline onto the script first.
Pre-production on the page This project
Breakdown, shot list and schedule as tabs beside Screenplay, worked on the script itself.
Paper The page count, where pages break, the schedule's eighths and the PDF all follow it. A4 holds 60 lines, US Letter 55.
<div class="kw-card" style="width:100%;max-width:520px;display:grid;gap:14px">
<strong style="font:600 var(--k-fs-head)/1.25 var(--k-font-display)">Structure &amp; production</strong>
<div style="display:flex;justify-content:space-between;gap:12px"><span><strong>Map the outline onto the script</strong> <span class="kw-badge kw-badge--info">This project</span><br><span class="kw-row__meta">The outline's acts and beats, landed on the scenes they belong to.</span></span><label class="kw-switch"><input type="checkbox" role="switch"><span class="kw-track"></span><span class="kw-visually-hidden">Map the outline onto the script</span></label></div>
<div style="display:flex;justify-content:space-between;gap:12px;opacity:.6"><span><strong>What the page shows</strong> <span class="kw-badge kw-badge--info">This project</span><br><span class="kw-row__meta">Map the outline onto the script first.</span></span><select class="kw-select" disabled style="width:auto" aria-label="Level of the outline the page shows"><option>Acts</option></select></div>
<div style="display:flex;justify-content:space-between;gap:12px"><span><strong>Pre-production on the page</strong> <span class="kw-badge kw-badge--info">This project</span><br><span class="kw-row__meta">Breakdown, shot list and schedule as tabs beside Screenplay, worked on the script itself.</span></span><label class="kw-switch"><input type="checkbox" role="switch"><span class="kw-track"></span><span class="kw-visually-hidden">Pre-production on the page</span></label></div>
</div>
<div class="kw-card" style="width:100%;max-width:520px;display:grid;gap:10px"><strong>Paper</strong> <span class="kw-row__meta">The page count, where pages break, the schedule's eighths and the PDF all follow it. A4 holds 60 lines, US Letter 55.</span><div class="kw-segment" role="group" aria-label="Paper"><button type="button" aria-pressed="true">A4</button><button type="button" aria-pressed="false">US Letter</button></div></div>

Switch, Segmented control, Select, Dialog, Menus and shortcuts, Structure, not teaching.

AI readiness test

Task. Add a setting for showing scene runtimes in the scene list.

Give the agent. This page, Decision 0003, Decision 0008, Menus and shortcuts.

Constraint. Only if it changes something visible.

A reliable answer

  • Puts it in Settings › Appearance (or View if it is a live toggle), not as a menu checkbox
  • Row has a title, a one-line detail of the effect and a scope tag (This project)
  • Applies at once with no Save
  • Defaults off unless the founder decides otherwise, and turns fully off

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

Open .mdllms.txt
Loading…