Kwark. Design System
Open Kwark

Menus and shortcuts

The screenplay has five desktop-grade menus (File, Edit, Format, View, Help) with one home for every command, real shortcuts shown beside them, switches for what stays on, and the same list as a drill-down sheet on a phone.

Patterns

The problem

A screenwriter who has used professional screenwriting software for ten years reaches for the menu bar without looking. In October 2026 Kwark’s editor had seven menus, a stopwatch in the header, a Tools menu that repeated the side rail, a Production menu with greyed items and code names, and four different words for saving a moment in time. On a phone, the same commands were a sheet of 62 rows that silently dropped every submenu. Earlier, the founder had rejected menus built as piles of checkboxes under quirky headings (“How the page reads”) as “a lazy way to hand out options” and asked where the settings were.

Menus are where a professional judges whether a tool is serious. They are also the one place every command must be findable by someone who does not know Kwark’s internal names.

Kwark’s answer

Five menus, one list for every screen (Decision 0015)

File · Edit · Format · View · Help. Each command has one home. Panels live in View › Panels (and on the rail). Removed: Tools, Production, the header stopwatch, the automatic tour offer and the Writing insights switch in the menu. Names were made plain: Restore points (not snapshots), Prepare to shoot (Decision 0009), Room.

Menu What lives there
File Drafts…, New draft from this one, Import as a new draft…, Title page, Keep a restore point, Restore points…, Revisions and locking…, Export…, Delivery…, Reports…, Settings…
Edit Undo, Redo, Cut and keep, Select all, Find and replace, Go to scene…, Comments, Quick note, Rename a character…, Change case (UPPERCASE, lowercase, Title Case), Move line up, Move line down
Format This line is (Scene heading, Action, Character, Dialogue, Parenthetical, Transition, Music, Shot, Lyrics), Dual dialogue, Page break, On screen, Align action, Structure (Act, End of act, Sequence, Montage, Series of shots, End of group)
View Read mode, Focus (Off, Distraction-free, Dialogue focus), Around the page (Scenes, Timeline, Ruler), Zoom (Zoom in, Zoom out, Actual size, Fit width, Fit page), On the page (Scene numbers, Character colours, Translations), Room…, Panels, Prepare to shoot beside the page (Breakdown, Shot list, Schedule)
Help Keyboard shortcuts, What each panel does, Take the tour

Desktop-grade items

Built from the components/menu/Menu.tsx primitives:

  • A shortcut on the right, from utils/editorShortcuts.ts, the one file that defines what the menus show, what the shortcuts sheet lists and what the keys do.
  • A switch for anything that stays on (Scenes, Timeline, Ruler).
  • Radio items for one of several (Focus: Off, Distraction-free, Dialogue focus).
  • A tick on the right marks the chosen option. A chevron means it opens a page or a flyout. An ellipsis in the label means it opens a dialog that asks for more.
  • Anything chosen once and kept goes to the Settings window, not the menu. See Settings.

The shortcuts

Real, from editorShortcuts.ts. Shown as ⌘ on a Mac and Ctrl elsewhere (⌥ is Alt, ⇧ is Shift). Keys a browser keeps for itself (new tab, close, reload) are left alone.

Command Mac Windows and Linux
Settings… ⌘, Ctrl+,
Keyboard shortcuts ⌘/ Ctrl+/
Save (says “Saved. Your script saves as you write.”) ⌘S Ctrl+S
Keep a restore point ⇧⌘S Ctrl+Shift+S
Export… ⇧⌘E Ctrl+Shift+E
Find and replace ⌘F Ctrl+F
Go to scene… ⌘G Ctrl+G
Scenes (the scene navigator) ⌘\ Ctrl+\
Read mode ⌥⌘R Ctrl+Alt+R
Distraction-free ⇧⌘F Ctrl+Shift+F
Undo ⌘Z Ctrl+Z
Redo ⇧⌘Z Ctrl+Shift+Z
Dual dialogue ⇧⌘D Ctrl+Shift+D
Cut and keep ⌥⌘X Ctrl+Alt+X
Select all ⌘A Ctrl+A
Quick note ⌥N Alt+N
Move line up, down ⌥↑, ⌥↓ Alt+↑, Alt+↓

Elements answer to Shift+Cmd and a digit (Ctrl+Shift elsewhere): 1 Scene heading, 2 Action, 3 Character, 4 Dialogue, 5 Parenthetical, 6 Transition, 7 Music, 8 Shot, 9 Lyrics. A writer can give a digit to another element in Settings › Keyboard; the new meaning works at once, and a digit given to two elements belongs to the later choice.

Cmd+S is a promise kept, not a command (Decision 0014): writers press it out of habit, so it reassures and changes nothing. A restore point is a deliberate act with its own keys.

On a phone

The same five menus, as a Menu sheet. It opens on Showing (Script, Title page, the Prepare to shoot views), then Find, Read, Export, Quick note, Comments, then File, Edit, Format, View and Help, each drilling to its own page with a labelled back row. Shortcuts are not shown on a phone; a one-line hint is, where the name alone is not enough.

Context menus and row menus

Right-click (or long-press, or the row’s ⋯) opens a menu of actions on that thing: Scene 12, a character, a story on Home. It follows the same item rules and puts the destructive action last, after a separator, in danger text.

Anatomy

Part Means
Label A verb and object, or the thing it shows: “Keep a restore point”, “Timeline”
Shortcut Right-aligned, quiet text, platform keys
Tick The chosen option among several
Switch A view that stays on until switched off
Chevron Opens a page or a flyout
Ellipsis in the label Opens a dialog that needs more input
Separator A new group of related commands
Dot on Menu (phone) Comments for you
Dot on View A focus mode is on
Greyed row Only while the page is read-only; the reason is written at the top of Edit and Format (“Read-only while a pre-production view is open”)

Rules

  • Must give every command exactly one home among the five menus; the rail may repeat panels only.
  • Must take shortcut labels from utils/editorShortcuts.ts; never type a shortcut into a label by hand.
  • Must show platform keys: ⌘ on a Mac, Ctrl elsewhere.
  • Must use a switch for persistent views, radio items for one-of-several, and a tick for the chosen one.
  • Never add a menu for one feature. A new command goes into File, Edit, Format, View or Help.
  • Never show greyed items that will never work here. Hide them, or show the reason.
  • Never take a key the browser uses for itself (Cmd+T, Cmd+W, Cmd+R).
  • Never build a menu as a pile of checkboxes under a heading. Choices that are kept go to Settings.
  • Always keep the same order and names on phone and desktop.
  • Always put a destructive item last, after a separator, and confirm or offer Undo as Destructive actions says.

Edge cases

  • Read-only. Edit and Format show the reason at the top and grey only what cannot work; View and Help stay live.
  • Export not allowed. The item stays, disabled, with the hint “Export disabled by project owner”.
  • Non-Latin keyboards. Shortcuts match the key’s place on the keyboard when the character differs (⌥R types ®; ⇧/ types ?), so they work in Hindi or Tamil layouts.
  • A series. Episode navigation (Previous episode, Next episode, All episodes) joins the existing menus; no new menu is added.
  • The writer reassigns a digit that another element used: that element loses it, and the shortcuts sheet shows the new map.

Writing

  • Plain names a writer would say: “Keep a restore point”, not “Snapshot”; “Go to scene…”, not “Jump”; “Room…”, not “Theme”.
  • Ellipsis only when a dialog follows.
  • Sentence case, except Change case items, which show their own effect: UPPERCASE, lowercase, Title Case.

Accessibility

  • The menu bar is role="menubar"; menus are role="menu" with menuitem, menuitemcheckbox (switches) and menuitemradio (radio items), and aria-checked on both.
  • Arrow keys move within and between menus; Escape closes and returns focus to the trigger.
  • The shortcut is part of the accessible description, not the name.
  • Every shortcut has a menu path; no command is keyboard-only or mouse-only.

Keep a restore point, ⇧⌘S, in File; ⌘S says “Saved. Your script saves as you write.”

Do

⌘S makes a “snapshot”, the File menu says “Save version”, and Edit has “Checkpoint”.

Don’t

View › Focus with three radio items: Off, Distraction-free, Dialogue focus.

Do

A “How the page reads” heading with six checkboxes under it.

Don’t

Demo

⇧⌘4 Dialogue ⌘G Go to scene… ⌥N Quick note
<div class="kw-menu" role="menu" aria-label="View" style="width:300px">
<button class="kw-menu-item" role="menuitem" type="button">Read mode <kbd>⌥⌘R</kbd></button>
<div class="kw-menu-sep" role="separator"></div>
<span class="kw-meta" style="padding:4px 8px">Focus</span>
<button class="kw-menu-item" role="menuitemradio" aria-checked="true" type="button">Off <kbd>✓</kbd></button>
<button class="kw-menu-item" role="menuitemradio" aria-checked="false" type="button">Distraction-free <kbd>⇧⌘F</kbd></button>
<button class="kw-menu-item" role="menuitemradio" aria-checked="false" type="button">Dialogue focus</button>
<div class="kw-menu-sep" role="separator"></div>
<span class="kw-meta" style="padding:4px 8px">Around the page</span>
<label class="kw-menu-item kw-switch" role="menuitemcheckbox" aria-checked="true"><input type="checkbox" role="switch" checked><span class="kw-track"></span>Scenes <kbd>⌘\</kbd></label>
<label class="kw-menu-item kw-switch" role="menuitemcheckbox" aria-checked="false"><input type="checkbox" role="switch"><span class="kw-track"></span>Timeline</label>
<div class="kw-menu-sep" role="separator"></div>
<button class="kw-menu-item" role="menuitem" type="button">Room… </button>
<button class="kw-menu-item" role="menuitem" type="button">Panels <kbd>›</kbd></button>
</div>
<div style="display:grid;gap:8px;align-content:start">
<span style="display:flex;gap:6px;align-items:center"><span class="kw-kbd">⇧</span><span class="kw-kbd">⌘</span><span class="kw-kbd">4</span> Dialogue</span>
<span style="display:flex;gap:6px;align-items:center"><span class="kw-kbd">⌘</span><span class="kw-kbd">G</span> Go to scene…</span>
<span style="display:flex;gap:6px;align-items:center"><span class="kw-kbd">⌥</span><span class="kw-kbd">N</span> Quick note</span>
</div>

Menu, Keyboard key, Command palette, Sheet, Settings, Phones, Saving and sync.

AI readiness test

Task. Add a “Number the dialogue for dubbing” command to the screenplay.

Give the agent. This page, Decision 0015, utils/editorShortcuts.ts, Settings.

Constraint. No new menu; no browser-reserved keys.

A reliable answer

  • Puts the one-off action in File › Export options or the persistent display as a switch in View › On the page, with a reason
  • Adds any shortcut in editorShortcuts.ts so menu, sheet and key agree
  • Shows ⌘ on Mac and Ctrl elsewhere
  • The phone sheet gets the same item with a one-line hint and no shortcut

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

Open .mdllms.txt
Loading…