<article class="kw-shot-card" data-open>
<button class="kw-shot-card__head" type="button" aria-expanded="true"><span class="kw-shot-card__name">12A</span><span class="kw-shot-card__what"><strong>Mira, from the doorway</strong><small>MS (Medium Shot) · Eye level · Static · 40mm</small></span><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true" class="kw-caret"><path d="m6 9 6 6 6-6"/></svg></button>
<div class="kw-shot-card__body">
<div class="kw-shot-card__grid">
<label class="kw-field"><span class="kw-label">Size</span><select class="kw-select"><option>MS (Medium Shot)</option><option>CU (Close Up)</option><option>ECU (Extreme Close Up)</option></select></label>
<label class="kw-field"><span class="kw-label">Lens</span><input class="kw-input" value="40mm"></label>
</div>
<label class="kw-field"><span class="kw-label">Direction / intention</span><textarea class="kw-textarea" rows="2">Hold on the empty doorway after she leaves.</textarea></label>
<div class="kw-shot-card__foot"><label class="kw-check"><input type="checkbox"><span class="kw-box"></span>Same setup as the one before</label><label class="kw-check"><input type="checkbox"><span class="kw-box"></span>Filmed</label></div>
</div>
</article>
<article class="kw-shot-card" data-unlined><button class="kw-shot-card__head" type="button" aria-expanded="false"><span class="kw-shot-card__name">12B</span><span class="kw-shot-card__what"><strong>Insert: the monitor</strong><small>Not on the page yet</small></span><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true" class="kw-caret"><path d="m6 9 6 6 6-6"/></svg></button></article>
When to use
In the Shot module’s first step (1 Shots · 2 Blocking · 3 Storyboard · 4 Animatic). Each shot is lined on the script: the lines it covers are drawn on the lined page, so coverage is visible.
When not to
- For a whole scene’s coverage at a glance. Use the shot list table (Data table) or the lined page.
- For a camera position shared by several shots. That is a setup (Camera setup card).
Naming and framing
- Shots are named by scene and letter: 12A, 12B, 12C. Letters skip I and O in many productions to avoid confusion with 1 and 0; Kwark follows the project’s setting.
- Sizes use the industry abbreviations with their words: ECU, CU, MCU, MS, MLS, LS, VLS, POV, OTS, plus High Angle, Low Angle, Bird’s Eye, Worm’s Eye.
- Height, tilt and pan are never coupled (memory: shot module steps).
Variants
- Closed: name, subject, framing summary.
- Open: fields in two columns, then Direction, then Camera & production.
- Unlined (dashed): not on the page yet, with Put it on the page.
- Adrift (amber edge): the lines it covered were rewritten.
- Filmed: faded to 72%.
Writing
The subject is who or what is in the frame, in the director’s words: Mira, from the doorway.
12A · Mira, from the doorway · MS · 40mm.
Shot 1 with “Medium” and no lens, or a size typed freehand per shot.
Anatomy
Card 9px corners on --k-raise. Head 9px × 11px: name 12px accent tabular, subject 13px 500, summary 12px. Open card: accent border and 1px ring.
Tokens
| Token | Light | Dark |
|---|---|---|
--k-raise |
#f1f5f9 | #252525 |
--k-line |
#e2e8f0 | rgba(255, 255, 255, .1) |
--k-accent |
#98633f | #98633f |
--k-text-2 |
#5b6779 | #9ca3af |
--k-warn |
#8a5a00 | #d8a44a |
React
In the Kwark app: import { ShotCard } from '@/pages/PreProduction/ShotListModule/ShotCard'.
<ShotCard shot={shot} covers={lines} canEdit={canEdit} open={openId === shot.id}
others={shots} onOpen={() => setOpen(shot.id)} onChange={update}
onRemove={remove} onReline={reline} onMerge={merge} />
| Prop | Type | Notes |
|---|---|---|
shot |
Shot |
name, subject, size, angle, move, lens, note |
covers |
ScriptLine[] |
the lines it covers on the lined page |
onReline |
() => void |
“Put it on the page” for unlined shots |
HTML and CSS
Works anywhere with kwark.css.
<article class="kw-shot-card" data-open>
<button class="kw-shot-card__head" type="button" aria-expanded="true"><span class="kw-shot-card__name">12A</span><span class="kw-shot-card__what"><strong>Mira, from the doorway</strong><small>MS (Medium Shot) · Eye level · Static · 40mm</small></span><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true" class="kw-caret"><path d="m6 9 6 6 6-6"/></svg></button>
<div class="kw-shot-card__body">
<div class="kw-shot-card__grid">
<label class="kw-field"><span class="kw-label">Size</span><select class="kw-select"><option>MS (Medium Shot)</option><option>CU (Close Up)</option><option>ECU (Extreme Close Up)</option></select></label>
<label class="kw-field"><span class="kw-label">Lens</span><input class="kw-input" value="40mm"></label>
</div>
<label class="kw-field"><span class="kw-label">Direction / intention</span><textarea class="kw-textarea" rows="2">Hold on the empty doorway after she leaves.</textarea></label>
<div class="kw-shot-card__foot"><label class="kw-check"><input type="checkbox"><span class="kw-box"></span>Same setup as the one before</label><label class="kw-check"><input type="checkbox"><span class="kw-box"></span>Filmed</label></div>
</div>
</article>
<article class="kw-shot-card" data-unlined><button class="kw-shot-card__head" type="button" aria-expanded="false"><span class="kw-shot-card__name">12B</span><span class="kw-shot-card__what"><strong>Insert: the monitor</strong><small>Not on the page yet</small></span><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true" class="kw-caret"><path d="m6 9 6 6 6-6"/></svg></button></article>
- The head is a disclosure button with
aria-expanded. - Unlined and adrift states say so in words in the summary line.
- Field labels are visible, never placeholders.
Rules
- Must name shots by scene and letter.
- Must offer the industry size list with abbreviations and words.
- Never couple camera height, tilt and pan.
- Always show when a shot is unlined or adrift, in words.
AI readiness test
Task. Add an insert shot of the monitor to Scene 12.
Give the agent. Shot card, Storyboard frame, Breakdown page.
Constraint. It covers one action line.
A reliable answer
- Named 12C after 12B
- Size ECU or CU from the list
- Lined on the action line
- Adds a Prop element if the monitor is not on the sheet