- Act 111 scenes · 24 pp
- Hidden
- Act 214 scenes · 38 pp
- The splice4 scenes
- 11Int. Rao house – day1 2/8
- 12Int. Edit suite – night2 4/8
- 12AExt. Rooftop – continuous6/8
- 14Omitted–
- Nana’s tapes5 scenes
- Hidden
<ul class="kw-tree" role="tree" aria-label="Blank Pages structure">
<li role="treeitem" aria-expanded="false" aria-level="1" tabindex="-1"><div class="kw-tree__row"><span class="kw-tree__twist"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="m9 18 6-6-6-6"/></svg></span><span class="kw-tree__label kw-tree__label--act"><span>Act 1</span></span><span class="kw-tree__trail">11 scenes · 24 pp</span></div>
<ul role="group"><li role="treeitem" aria-level="2"><div class="kw-tree__row"><span class="kw-tree__twist"></span><span class="kw-tree__label"><span>Hidden</span></span></div></li></ul></li>
<li role="treeitem" aria-expanded="true" aria-level="1" tabindex="-1"><div class="kw-tree__row"><span class="kw-tree__twist"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="m9 18 6-6-6-6"/></svg></span><span class="kw-tree__label kw-tree__label--act"><span>Act 2</span></span><span class="kw-tree__trail">14 scenes · 38 pp</span></div>
<ul role="group">
<li role="treeitem" aria-expanded="true" aria-level="2" tabindex="-1"><div class="kw-tree__row"><span class="kw-tree__twist"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="m9 18 6-6-6-6"/></svg></span><span class="kw-tree__label"><span>The splice</span></span><span class="kw-tree__trail">4 scenes</span></div>
<ul role="group">
<li role="treeitem" aria-level="3" aria-selected="false" tabindex="-1"><div class="kw-tree__row"><span class="kw-tree__twist"></span><span class="kw-tree__label"><i class="kw-tree__strip" style="--kw-strip:var(--k-strip-int-day)"></i><span class="kw-tree__num">11</span><span class="kw-tree__slug">Int. Rao house – day</span></span><span class="kw-tree__trail">1 2/8</span></div></li>
<li role="treeitem" aria-level="3" aria-selected="true" tabindex="0"><div class="kw-tree__row"><span class="kw-tree__twist"></span><span class="kw-tree__label"><i class="kw-tree__strip" style="--kw-strip:var(--k-strip-int-night)"></i><span class="kw-tree__num">12</span><span class="kw-tree__slug">Int. Edit suite – night</span></span><span class="kw-tree__trail">2 4/8</span></div></li>
<li role="treeitem" aria-level="3" aria-selected="false" tabindex="-1"><div class="kw-tree__row"><span class="kw-tree__twist"></span><span class="kw-tree__label"><i class="kw-tree__strip" style="--kw-strip:var(--k-strip-ext-night)"></i><span class="kw-tree__num">12A</span><span class="kw-tree__slug">Ext. Rooftop – continuous</span></span><span class="kw-tree__trail">6/8</span></div></li>
<li role="treeitem" aria-level="3" aria-selected="false" tabindex="-1" class="is-omitted"><div class="kw-tree__row"><span class="kw-tree__twist"></span><span class="kw-tree__label"><i class="kw-tree__strip"></i><span class="kw-tree__num">14</span><span class="kw-tree__slug">Omitted</span></span><span class="kw-tree__trail">–</span></div></li>
</ul>
</li>
<li role="treeitem" aria-expanded="false" aria-level="2" tabindex="-1"><div class="kw-tree__row"><span class="kw-tree__twist"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="m9 18 6-6-6-6"/></svg></span><span class="kw-tree__label"><span>Nana’s tapes</span></span><span class="kw-tree__trail">5 scenes</span></div>
<ul role="group"><li role="treeitem" aria-level="3"><div class="kw-tree__row"><span class="kw-tree__twist"></span><span class="kw-tree__label"><span>Hidden</span></span></div></li></ul></li>
</ul>
</li>
</ul>
What it is
A nested list where each level opens and closes on its own: the outline’s acts, their sequences, and the scenes inside. It is how a writer keeps the shape of a 96-scene film in one column beside the page.
The Kwark idea: every scene row is a strip
Each scene row is a tiny stripboard strip. A 4 × 16px bar in the strip’s colour says INT or EXT, day or night, using the colours the first AD already uses (white interior day, yellow exterior day, blue interior night, green exterior night). Then the scene number in Courier Prime 700, as in the margin, then the heading, then the length in eighths of a page (2 4/8), which is how a schedule measures a scene. Act and sequence rows total their scenes and pages. An omitted scene keeps its row and number on a locked script.
Structure is optional
Acts and sequences exist only if the writer made them (Decision 0003). A script with no acts shows a flat list of scenes, with no empty Act 1 folder invented for it. A tree never adds a level the writer did not ask for, and never labels a level with theory (Inciting incident) (Decision 0004).
When to use
- The scene navigator beside the screenplay, the outline’s structure column, the breakdown’s scene list.
When not to use
- For one level: a list row list.
- For the story’s shape on a board: the outline board and story spine.
- For files and folders of research: the research library has its own grid.
Behaviour
- Pressing the row of a scene opens it beside the page; pressing the chevron or the row of an act or sequence opens and closes it.
- The open and closed state is remembered per person, per project.
- Reordering by drag shows a 2px
--k-accent-softdrop line; on a locked script reordering is off and the tree says so in its menu.
Anatomy
- Tree: up to 400px, 4px padding,
--k-surface, 1px--k-line, 10px corners. - Row: 32px (44px under a thumb), grid of 18px twist, label, trail; 6px corners; hover
--k-raise. - Twist: a 14px SVG chevron that turns 90° when open, over
--k-dur-2. - Nesting: each level indents 17px and draws a 1px
--k-lineguide down its left. - Act / sequence label: Poppins 600 / 500, 12px; trail totals in 12px tabular
--k-text-2. - Scene label: the strip bar (4 × 16px, 2px corners, 1px inset edge at 18%
--k-strip-ink), number (Courier Prime 700, right-aligned in 26px), heading (Courier Prime 400, capitals). - Length: eighths of a page, tabular, at the row’s end.
- Selected: 20%
--k-accent-softwash and a 2px inset line of it on the left. - Omitted: number and Omitted in
--k-text-2, an empty strip outline, a dash for length.
Tokens
| Token | Light | Dark |
|---|---|---|
--k-surface |
#ffffff | #1a1a1a |
--k-raise |
#f1f5f9 | #252525 |
--k-line |
#e2e8f0 | rgba(255, 255, 255, .1) |
--k-text |
#0f172a | #e3e3e3 |
--k-text-2 |
#5b6779 | #9ca3af |
--k-accent-soft |
#e8b58b | #e8b58b |
--k-focus |
#0f172a | #f4f4f5 |
--k-strip-int-day |
#f5f4ee | |
--k-strip-ext-day |
#f1d563 | |
--k-strip-int-night |
#8fb4d6 | |
--k-strip-ext-night |
#93c197 | |
--k-strip-ink |
#1f2427 | |
--k-font-screenplay |
‘Courier Prime’, ‘Courier New’, monospace | |
--k-radius-card |
10px | |
--k-radius-control |
6px | |
--k-control-sm |
32px | |
--k-tap |
44px | |
--k-fs-meta |
12px |
React
Use the HTML below with kwark.css. The example shows the markup and styling. Supply any application behavior described on this page.
HTML and CSS
Works anywhere with kwark.css.
<ul class="kw-tree" role="tree" aria-label="Blank Pages structure">
<li role="treeitem" aria-expanded="false" aria-level="1" tabindex="-1"><div class="kw-tree__row"><span class="kw-tree__twist"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="m9 18 6-6-6-6"/></svg></span><span class="kw-tree__label kw-tree__label--act"><span>Act 1</span></span><span class="kw-tree__trail">11 scenes · 24 pp</span></div>
<ul role="group"><li role="treeitem" aria-level="2"><div class="kw-tree__row"><span class="kw-tree__twist"></span><span class="kw-tree__label"><span>Hidden</span></span></div></li></ul></li>
<li role="treeitem" aria-expanded="true" aria-level="1" tabindex="-1"><div class="kw-tree__row"><span class="kw-tree__twist"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="m9 18 6-6-6-6"/></svg></span><span class="kw-tree__label kw-tree__label--act"><span>Act 2</span></span><span class="kw-tree__trail">14 scenes · 38 pp</span></div>
<ul role="group">
<li role="treeitem" aria-expanded="true" aria-level="2" tabindex="-1"><div class="kw-tree__row"><span class="kw-tree__twist"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="m9 18 6-6-6-6"/></svg></span><span class="kw-tree__label"><span>The splice</span></span><span class="kw-tree__trail">4 scenes</span></div>
<ul role="group">
<li role="treeitem" aria-level="3" aria-selected="false" tabindex="-1"><div class="kw-tree__row"><span class="kw-tree__twist"></span><span class="kw-tree__label"><i class="kw-tree__strip" style="--kw-strip:var(--k-strip-int-day)"></i><span class="kw-tree__num">11</span><span class="kw-tree__slug">Int. Rao house – day</span></span><span class="kw-tree__trail">1 2/8</span></div></li>
<li role="treeitem" aria-level="3" aria-selected="true" tabindex="0"><div class="kw-tree__row"><span class="kw-tree__twist"></span><span class="kw-tree__label"><i class="kw-tree__strip" style="--kw-strip:var(--k-strip-int-night)"></i><span class="kw-tree__num">12</span><span class="kw-tree__slug">Int. Edit suite – night</span></span><span class="kw-tree__trail">2 4/8</span></div></li>
<li role="treeitem" aria-level="3" aria-selected="false" tabindex="-1"><div class="kw-tree__row"><span class="kw-tree__twist"></span><span class="kw-tree__label"><i class="kw-tree__strip" style="--kw-strip:var(--k-strip-ext-night)"></i><span class="kw-tree__num">12A</span><span class="kw-tree__slug">Ext. Rooftop – continuous</span></span><span class="kw-tree__trail">6/8</span></div></li>
<li role="treeitem" aria-level="3" aria-selected="false" tabindex="-1" class="is-omitted"><div class="kw-tree__row"><span class="kw-tree__twist"></span><span class="kw-tree__label"><i class="kw-tree__strip"></i><span class="kw-tree__num">14</span><span class="kw-tree__slug">Omitted</span></span><span class="kw-tree__trail">–</span></div></li>
</ul>
</li>
<li role="treeitem" aria-expanded="false" aria-level="2" tabindex="-1"><div class="kw-tree__row"><span class="kw-tree__twist"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="m9 18 6-6-6-6"/></svg></span><span class="kw-tree__label"><span>Nana’s tapes</span></span><span class="kw-tree__trail">5 scenes</span></div>
<ul role="group"><li role="treeitem" aria-level="3"><div class="kw-tree__row"><span class="kw-tree__twist"></span><span class="kw-tree__label"><span>Hidden</span></span></div></li></ul></li>
</ul>
</li>
</ul>
Keyboard (the ARIA tree pattern)
| Key | Does |
|---|---|
| Tab | Enters on the selected scene; one tab stop for the whole tree. |
| ↑ ↓ | Previous and next visible row. |
| → | Opens a closed act or sequence; on an open one, moves to its first child. |
| ← | Closes an open one; on a scene, moves to its sequence. |
| Home / End | First and last visible row. |
| Enter | Opens the scene beside the page. |
| * | Opens every sibling at that level. |
| Typing | Jumps to the next row starting with that text, including a scene number (1, 2). |
ARIA
role="tree"with a name; rows aretreeitemwitharia-level,aria-expandedon parents,aria-selectedon scenes; children inrole="group".- Roving
tabindex: only the active row is 0. - A scene’s accessible name says all of it: Scene 12, INT. EDIT SUITE – NIGHT, interior night, 2 4/8 pages. The strip colour is never the only carrier.
Rules
- Must show only the levels the writer made; never invent an Act or a theory label (Decisions 0003 and 0004).
- Must give each scene row its number, its INT/EXT day/night strip colour and its length in eighths, and say the strip in words in its name.
- Must implement the full ARIA tree keyboard model with roving tabindex, or use a plain nested list instead.
- Always keep omitted scenes in place with their numbers on a locked script.
- Never put buttons inside a tree row; actions live in the row’s context menu.
AI readiness test
Task. Build the scene navigator for the screenplay’s left rail.
Give the agent. This page, Stripboard strip, Decision 0003.
Constraint. The writer has acts but no sequences; the script is locked.
A reliable answer
- Two levels only (Act › Scene), no invented sequences
- Scene rows show strip colour, Courier number and heading, eighths
- Omitted scenes stay with their numbers
- Arrow keys open, close and move
- Names say “interior night” in words