One list for every document

What it is

The left pane is headed “DOCUMENTS”. Next to the heading sit three controls: “+” (a two-entry menu: “Process flow — Steps, decisions, sub-processes” and “Sequence diagram — Actors exchanging messages”; Enter or Space opens it, arrows move, Enter picks, Esc closes), “✨” (“Create with AI — describe it, Runic writes the first draft”, signed in only) and “Hide sidebar”. New documents are named “Untitled N” or “Diagram N” with the first free number; a new diagram starts with a seven-line starter you can overwrite. A document created inside a team from the Teams dialog is named “<Team> process N” or “<Team> diagram N”.

Each row shows a kind glyph (its tooltip reads “Process flow” or “Sequence diagram”), a team initial badge when the document lives in a team (“Team: X”), the name, an amber dot when the document has broken references, a violet pill with its incoming reference count, and the number of non-empty lines (“–” for an empty document). Enter or Space on a focused row opens it. Renaming happens in the top bar, not here.

Nesting and collapse

A document nests under its caller when exactly one other document references it with .go or .do, up to three levels deep (each level indents 14 pixels). The footer says it: “Documents referenced with .do nest under their caller.” A parent’s kind glyph turns into a chevron on hover, or permanently while collapsed, with the labels “Collapse subprocesses” and “Expand subprocesses”. Collapsed parents are remembered across reloads once you have allowed Preferences in the cookie dialog. Opening a hidden child — from a reference jump, a card, or Create as process — expands its ancestors automatically.

Drag and drop

Rows are draggable. Where you release decides what happens: the top 30% of a row drops the dragged document before it, the bottom 30% after it, and the middle 40% drops it “onto” the row, shown by a violet ring. A before/after drop reorders the list, one list for both kinds, and the order is saved on the server; a team document’s position is shared by its members, and a viewer’s reorder of one does not stick. An onto drop does the honest thing: the target document gains a .do <dragged name> line at its end, so the dropped document nests under it the moment the index re-renders. Nothing happens when the target already references it or when the target is a team document you can only view. The open document follows its row.

Width, rail and the panes around it

Drag the sidebar’s right edge (“Drag to resize”) between 150 and 420 pixels; the default is 192 and the choice is remembered with Preferences consent. “Hide sidebar” folds it to a 48-pixel rail: “Show documents” at the top, then one 30-pixel tile per document with its initial and a tiny kind glyph, and a compact “+”. The rail is not remembered: the sidebar reopens on every reload.

The same rules apply to the other panes. The text editor is 408 pixels wide by default and resizes from 260 to 720 (the handle is between the editor and the diagram); “Collapse the text editor” folds it to a 40-pixel rail reading “EDITOR”, and “Open the text editor” brings it back. The AI chat is 300 pixels by default and resizes from 240 to 520; its rail shows ✨ with a dot when the conversation has messages. Unlike the sidebar, whether the editor and chat rails are open is remembered. Every width is also capped so the diagram keeps its room on a narrow window, and the app itself has a minimum width of 1100 pixels. Fullscreen hides the sidebar, editor and chat at once; Esc brings them back.

Deleting a document

The trash icon beside the document name in the top bar (“Delete this document”) opens a confirmation: “Delete “Name”?” — “The process, its version history and any share or embed links stop working immediately. This can’t be undone.” (“The diagram…” for a sequence diagram), with Cancel and Delete; Esc cancels. Viewers of a team document do not see the icon. Deleting the last document leaves you with a fresh, empty process named “Untitled 1”. Any icon overrides for the document are dropped with it.

How to use it

1. 1
   Create a document

   Click + next to DOCUMENTS and choose Process flow or Sequence diagram. It opens at once as “Untitled N” or “Diagram N”; click the name in the top bar to rename it.
2. 2
   Reorder

   Drag a row and release it over the top or bottom third of another row. A violet line shows where it will land; the order is saved.
3. 3
   Nest by dropping onto

   Drag a row onto the middle of another row (violet ring). The target gets a .do line calling the dropped document, which then nests under it.
4. 4
   Collapse a parent

   Hover the parent’s glyph; it becomes a chevron. Click to hide its subprocesses. The state survives a reload with Preferences consent.
5. 5
   Resize or hide

   Drag the right edge between 150 and 420 px, or click “Hide sidebar” for the rail. The rail’s tiles open documents; “Show documents” restores the list.
6. 6
   Delete

   Open the document, click the trash icon beside its name, read the warning, click Delete.

Commands & shortcuts

Tips

• The amber dot and the violet pill are the fastest health check: a dot means a call goes nowhere, a pill means others depend on this document.
• Dropping onto a row is a real edit in the target document; ⌘Z in that document removes the .do line again.
• Documents that call each other never both disappear into nesting; one of the pair stays at the top level.
• Team documents show the team’s initial; hover it for the team name. Viewers cannot reorder or nest into them.

Questions