Kwark. Design System
Open Kwark

Shot card

One shot: its name (1A), what is in the frame, framing in industry terms, and the lines of script it covers.

ComponentsCreative toolsIn the app
<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.

Do

Shot 1 with “Medium” and no lens, or a size typed freehand per shot.

Don’t

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

Give this Markdown to your coding agent or share its URL.

Open .mdllms.txt
Loading…