# Shot card

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

Source: https://kwark.space/designSystem/components/shot-card

## Usage

### 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](https://kwark.space/designSystem/components/data-table.md)) or the lined page.
- For a camera position shared by several shots. That is a setup ([Camera setup card](https://kwark.space/designSystem/components/camera-inspector.md)).

### 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*.

**Do:** *12A · Mira, from the doorway · MS · 40mm*.

**Don't:** *Shot 1* with "Medium" and no lens, or a size typed freehand per shot.

## Style

### 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 |

## Code

### React

In the Kwark app: `import { ShotCard } from '@/pages/PreProduction/ShotListModule/ShotCard'`.

```tsx
<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`.

```html
<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>
```

## Accessibility

- 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.

## For agents

### 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
