Pink, 2 Nov
I didn’t shoot this.
Working, Yellow next
I didn’t shoot this. Nobody did. Who did?
<aside class="kw-revision" aria-label="Revision">
<header class="kw-revision__head"><div><span>Once it is being made</span><h2>Revision</h2></div><button class="kw-icon-button" type="button" aria-label="Close revision"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M18 6 6 18M6 6l12 12"/></svg></button></header>
<section class="kw-revision__issue" data-revision="pink"><span class="kw-revision__swatch" aria-hidden="true"></span><div><strong>Pink revision</strong><small>Locked 2 Nov · 7 lines changed since Pink</small></div></section>
<div class="kw-revision__acts"><button class="kw-button kw-button--primary" type="button">Issue Yellow</button><button class="kw-button kw-button--quiet" type="button">Unlock</button></div>
<p class="kw-revision__note">Issuing sets the colour of the next pages and starts the asterisks again from here. 1 scene has been added since the lock.</p>
<div class="kw-revision__diff">
<h3>Since Pink <small>3 scenes, 7 lines</small></h3>
<button class="kw-revision__change" type="button" data-kind="rewritten">Scene 12: Mira’s second line is rewritten</button>
<button class="kw-revision__change" type="button" data-kind="added">Scene 12A is new, after Scene 12</button>
<button class="kw-revision__change" type="button" data-kind="omitted">Scene 15 is omitted and keeps its number</button>
</div>
</aside>
<div class="kw-diff-cols">
<div data-revision="pink"><h4>Pink, 2 Nov</h4><p class="kw-diff">I didn’t shoot this.</p></div>
<div data-revision="yellow"><h4>Working, Yellow next</h4><p class="kw-diff">I didn’t shoot this. <ins>Nobody did.</ins> <del>Who did?</del></p></div>
</div>
<div class="kw-revision-papers" aria-label="Revision colours in order"><span data-revision="white">White</span><span data-revision="blue">Blue</span><span data-revision="pink">Pink</span><span data-revision="yellow">Yellow</span><span data-revision="green">Green</span><span data-revision="goldenrod">Goldenrod</span><span data-revision="buff">Buff</span><span data-revision="salmon">Salmon</span><span data-revision="cherry">Cherry</span></div>
When to use
From the day the script goes to a crew. While unlocked, changing page 12 moves everything after it and nobody minds. Once locked, scene numbers are names people are holding, new scenes take letters (12A) rather than renumbering, and cut scenes keep their number as OMITTED.
The colour sequence
The order is not a preference. A crew reads “we’re on pink” as a date, and the sequence is the same on every production:
White, Blue, Pink, Yellow, Green, Goldenrod, Buff, Salmon, Cherry, then Double White, Double Blue and so on through Double Cherry (utils/revision.ts). Each issue prints changed lines with an asterisk in the right margin and the revision colour in the page header.
When not to
- For the writer’s own history while drafting. Use Version history, which has no colours.
- For machine suggestions. Those are Revision marks: green tint and a star, never a production colour.
Anatomy in use
- Issue: a paper swatch, “Pink revision”, the lock date and how many lines changed.
- Issue Yellow: names the next colour. Disabled after Double Cherry, with the reason.
- Since Pink: each change as a sentence with a left edge: accent for rewritten, green for added, grey for omitted. Selecting one goes to the scene.
- Side by side: the issued page on its colour beside the working page;
insanddelcarry the change in words as well as colour.
Writing
Changes are sentences: Scene 12A is new, after Scene 12. Never diff jargon like “+3 −1”.
Issue Yellow, and Scene 15 is omitted and keeps its number.
Renumbering every scene after a cut, or choosing revision colours from a palette.
Anatomy
Panel 280–380px, sticky to the right of the page. Swatch 26 × 34px with a 1px edge. Change buttons 8px × 9px, 2px left edge, 8px corners.
Tokens
| Token | Light | Dark |
|---|---|---|
--k-revision-white |
#ffffff | |
--k-revision-blue |
#d6e4f0 | |
--k-revision-pink |
#f7d9e3 | |
--k-revision-yellow |
#f7f0c0 | |
--k-revision-green |
#d3e8d3 | |
--k-revision-goldenrod |
#f0dfa0 | |
--k-revision-buff |
#eee2c8 | |
--k-revision-salmon |
#f5d6c6 | |
--k-revision-cherry |
#e9bcc4 | |
--k-ok-bg |
#e7f3ec | #17281e |
--k-danger-bg |
#fbe9e7 | #321b19 |
React
In the Kwark app: import { RevisionPanel } from '@/pages/Understanding/EditorModule/components/RevisionPanel'.
<RevisionPanel docJson={doc} revision={project.scriptRevision}
onLock={lock} onUnlock={unlock} onIssue={issueNext}
onToggleOmitted={omit} onGoToScene={goTo} onClose={close} />
| Prop | Type | Notes |
|---|---|---|
revision |
ScriptRevision | null |
null while unlocked |
onIssue |
() => void |
issues the next colour in REVISION_COLOURS |
onToggleOmitted |
(index, omitted) => void |
omitted scenes keep their number |
HTML and CSS
Works anywhere with kwark.css.
<aside class="kw-revision" aria-label="Revision">
<header class="kw-revision__head"><div><span>Once it is being made</span><h2>Revision</h2></div><button class="kw-icon-button" type="button" aria-label="Close revision"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M18 6 6 18M6 6l12 12"/></svg></button></header>
<section class="kw-revision__issue" data-revision="pink"><span class="kw-revision__swatch" aria-hidden="true"></span><div><strong>Pink revision</strong><small>Locked 2 Nov · 7 lines changed since Pink</small></div></section>
<div class="kw-revision__acts"><button class="kw-button kw-button--primary" type="button">Issue Yellow</button><button class="kw-button kw-button--quiet" type="button">Unlock</button></div>
<p class="kw-revision__note">Issuing sets the colour of the next pages and starts the asterisks again from here. 1 scene has been added since the lock.</p>
<div class="kw-revision__diff">
<h3>Since Pink <small>3 scenes, 7 lines</small></h3>
<button class="kw-revision__change" type="button" data-kind="rewritten">Scene 12: Mira’s second line is rewritten</button>
<button class="kw-revision__change" type="button" data-kind="added">Scene 12A is new, after Scene 12</button>
<button class="kw-revision__change" type="button" data-kind="omitted">Scene 15 is omitted and keeps its number</button>
</div>
</aside>
<div class="kw-diff-cols">
<div data-revision="pink"><h4>Pink, 2 Nov</h4><p class="kw-diff">I didn’t shoot this.</p></div>
<div data-revision="yellow"><h4>Working, Yellow next</h4><p class="kw-diff">I didn’t shoot this. <ins>Nobody did.</ins> <del>Who did?</del></p></div>
</div>
<div class="kw-revision-papers" aria-label="Revision colours in order"><span data-revision="white">White</span><span data-revision="blue">Blue</span><span data-revision="pink">Pink</span><span data-revision="yellow">Yellow</span><span data-revision="green">Green</span><span data-revision="goldenrod">Goldenrod</span><span data-revision="buff">Buff</span><span data-revision="salmon">Salmon</span><span data-revision="cherry">Cherry</span></div>
- The panel is an
<aside aria-label="Revision">. - Revision colours always appear with their name; the swatch is
aria-hidden. - Insertions and deletions use
<ins>and<del>, so screen readers announce them. - The disabled Issue button keeps its reason visible on the page, not in a tooltip (0020 review).
Rules
- Must issue revision colours in the industry order and never let people pick one.
- Must keep scene numbers after lock: new scenes take letters, cut scenes become OMITTED.
- Always name a colour in words next to its swatch.
- Never use production revision colours for machine suggestions.
AI readiness test
Task. Print the changed pages of the Yellow revision.
Give the agent. Script revision diff, Screenplay page, Print and export.
Constraint. Only pages with changes since Pink print.
A reliable answer
- Header carries “Yellow” and the date
- Asterisks in the right margin on changed lines
- Scene numbers unchanged
- Omitted scenes print OMITTED