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 arerole="menu"withmenuitem,menuitemcheckbox(switches) andmenuitemradio(radio items), andaria-checkedon 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.”
⌘S makes a “snapshot”, the File menu says “Save version”, and Edit has “Checkpoint”.
View › Focus with three radio items: Off, Distraction-free, Dialogue focus.
A “How the page reads” heading with six checkboxes under it.
Demo
<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>
Related
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