# Storyboard and shots

> Build shot planning the way a director and DP think about it: shots named by scene and letter, framing in industry terms, coverage lined on the script, boards at the film's aspect ratio, setups for the crew, and an animatic.

Source: https://kwark.space/designSystem/kits/storyboard-and-shots

## Who it is for

Teams building shot-list, storyboard, previs or animatic tools, and the camera department's prep tools. The people using it are directors working out coverage, DPs and their camera teams preparing setups, storyboard artists, first ADs who need to know how many setups a day holds, and script supervisors who line the script.

This kit is in Kwark. The Shot module has four steps: **1 Shots · 2 Blocking · 3 Storyboard · 4 Animatic**. Camera & Light adds Setups, optics, the sun, and an on-set mode with a camera report. Components: [Shot card](https://kwark.space/designSystem/components/shot-card.md), [Data table](https://kwark.space/designSystem/components/data-table.md) for the shot list, [Storyboard frame](https://kwark.space/designSystem/components/storyboard-frame.md) with board cast figures, [Camera setup card](https://kwark.space/designSystem/components/camera-inspector.md), [Playhead and scrubber](https://kwark.space/designSystem/components/playhead.md) for the animatic, and the [Screenplay page](https://kwark.space/designSystem/components/screenplay-page.md) for the lined page.

## The screens

| Screen | What it does | Components |
|---|---|---|
| Lined page | The scene's text with each shot's coverage drawn beside the lines it covers | [Screenplay page](https://kwark.space/designSystem/components/screenplay-page.md), [Shot card](https://kwark.space/designSystem/components/shot-card.md) |
| Shot list | Every shot in a scene, sortable, selectable | [Data table](https://kwark.space/designSystem/components/data-table.md) |
| Shot card | One shot's framing, intention and production flags | [Shot card](https://kwark.space/designSystem/components/shot-card.md) |
| Blocking | Top-down plan: actors' marks, camera positions, moves | A plan canvas with a [Toolbar](https://kwark.space/designSystem/components/toolbar.md); board cast figures as the people |
| Storyboard | Panels in shot order at the film's aspect | [Storyboard frame](https://kwark.space/designSystem/components/storyboard-frame.md) |
| Animatic | Panels timed on a timeline | [Playhead and scrubber](https://kwark.space/designSystem/components/playhead.md), [Video player](https://kwark.space/designSystem/components/video-player.md) |
| Setups | Camera positions with optics, for the crew packet | [Camera setup card](https://kwark.space/designSystem/components/camera-inspector.md), [Description list](https://kwark.space/designSystem/components/description-list.md) |
| On set | What was actually shot, the camera report | [Camera setup card](https://kwark.space/designSystem/components/camera-inspector.md), [Data table](https://kwark.space/designSystem/components/data-table.md) |

## Live demo

A shot card, two panels at 2.39:1 and the setup's optics.

```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></button><div class="kw-shot-card__body"><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></article>
<div class="kw-boards"><figure class="kw-board-panel" style="margin:0"><div class="kw-board-frame" data-aspect="2.39"><span class="kw-board-frame__empty">Draw, photograph or stage it in 3D</span></div><figcaption class="kw-board-caption"><p class="kw-board-caption__head"><strong>12A</strong><span>MS · Eye level</span><span>3 s</span></p><p>Mira, from the doorway</p><p class="kw-board-caption__words">MIRA: I didn’t shoot this. Nobody did.</p></figcaption></figure><figure class="kw-board-panel" style="margin:0"><div class="kw-board-frame" data-aspect="2.39" data-done><span class="kw-board-frame__empty">Insert</span></div><figcaption class="kw-board-caption"><p class="kw-board-caption__head"><strong>12B</strong><span>CU</span><span>2 s</span></p><p>Insert: the monitor</p></figcaption></figure></div>
<div class="kw-setup"><div class="kw-setup__main"><h3 class="kw-setup__title">Setup 1 · doorway</h3><dl class="kw-dl"><dt>Shots covered</dt><dd>12A, 12C</dd><dt>Lighting</dt><dd>Available light only</dd></dl></div><aside class="kw-setup__side"><h4>Optics</h4><dl><dt>Lens</dt><dd>40mm</dd><dt>T-stop</dt><dd>T2.8</dd><dt>EI</dt><dd>800</dd><dt>WB</dt><dd>3200K</dd></dl></aside></div>
```

## Domain conventions

### Naming shots and setups

- Shots are named by **scene number and letter**: 12A, 12B, 12C. Many productions skip I and O so they are not read as 1 and 0; make it a project setting.
- A **setup** is a camera position (and lighting state). Several shots may share one setup; crews count a day's work in setups, because moving the camera and relighting is what takes time. Kwark's *Same setup as the one before* flag on a shot says so.
- Slates on set carry scene, shot and take: *12B, take 3*. Keep the same names from the shot list through to the editor's bins.

### Framing

Offer sizes by their standard abbreviations with words: **ECU** (extreme close-up), **CU**, **MCU**, **MS**, **MLS**, **LS**, **VLS** (also called extreme long shot), and the kinds **POV** and **OTS** (over the shoulder). Angles: eye level, high, low, bird's eye, worm's eye, Dutch. Movement: static, pan, tilt, dolly or track, crane or jib, handheld, Steadicam or gimbal, zoom. Camera height, tilt and pan are independent; never couple them in a control.

### Aspect ratios

Boards are drawn at the delivery aspect ratio: **1.85:1** (flat), **2.39:1** (scope, often still called 2.35 or 2.40), **1.78:1** (16:9, broadcast and most streaming), **1.33:1** or **1.37:1** (Academy) for a period look, **9:16** for vertical. Store the exact ratio; display the name people use.

### Coverage and the lined script

The script supervisor's lined script draws a vertical line beside the text for each shot, from the first line it covers to the last; a straight line where the character speaking is on camera and a wavy line where they are off camera. Kwark's lined page draws each shot's coverage the same way, so a gap in coverage is visible before the shoot. A shot not yet placed on the page is *unlined*; one whose lines were rewritten is *adrift*.

### The 180-degree rule and screen direction

Keep the camera on one side of the line between two characters so their screen direction stays consistent. Blocking views should show the line when two characters face each other, as a guide the director can cross deliberately, never as an error.

### Lenses and exposure

Focal length in millimetres, cine lenses in **T-stops** (T2.8), stills lenses in f-stops. Exposure index (EI or ISO), shutter as an angle (180°) or a speed, white balance in kelvin (3200K tungsten, 5600K daylight). Angle of view and depth of field depend on sensor size; show the sensor or format the calculation used.

### Animatic timing

Panels have durations in seconds or frames at the project rate. Timing changes on a panel move later panels, like a ripple edit. See [Editing](https://kwark.space/designSystem/kits/editing.md) for timecode.

## Keyboard map

| Key | Does |
|---|---|
| N | New shot after the selected one |
| ⌘ D | Duplicate shot (same setup) |
| ↑ / ↓ | Previous / next shot |
| Enter | Open the shot card |
| Esc | Close the card |
| ⌘ ↑ / ⌘ ↓ | Move shot earlier / later |
| Space | Play the animatic |
| ← / → | One frame in the animatic |
| [ / ] | Shorten / lengthen the panel by one frame (⇧ for one second) |

## Phone and desktop

**Desktop** holds the lined page beside the shot list and the board; the director works with a keyboard, the artist with a pen tablet.

**Phone** is for the recce and the set:

- The viewfinder: frame a shot through the phone camera at the film's aspect ratio, with thirds guides, and save it as the panel.
- Shots as a list of cards; open one to change framing or mark it *Filmed*.
- On set, the camera report: what was actually shot, with differences from the plan.
- One header line, one floating control (Decision 0016).

## AI and authorship

Kwark's plan for AI here is the *AI storyboard pack*: an exported pack a person takes to a tool they choose, not a generator inside the app; its UX is not agreed yet (memory: AI storyboard pack).

- **May** propose coverage gaps ("Lines 4–6 of Scene 12 have no shot") as findings, and suggest a shot size from the script's words as a marked suggestion.
- **May** generate a panel image only if the person asks, and the panel carries a [Revision mark](https://kwark.space/designSystem/components/revision-mark.md) and the source until they accept it.
- **Never** replace a drawn or photographed panel, and never decide the coverage.
- **Never** rate a shot list or a director's choices.

**Do:** *Lines 4–6 have no shot* beside the lined page, with *Add a shot for these lines*.

**Don't:** A generated board for the whole scene saved over the artist's panels.

## Accessibility notes for this craft

- Panels are figures with captions; drawn panels need alt text written by a person (offer the subject as a default).
- Blocking must be operable by keyboard: select a figure, move it with arrows, rotate with a modifier.
- Shot sizes are words as well as abbreviations.

## Starter prompt

> You are building the shot-planning steps of a film app on the Kwark Design System. Read https://kwark.space/designSystem/kits/storyboard-and-shots.md, /components/shot-card.md, /components/storyboard-frame.md, /components/camera-inspector.md and /components/data-table.md. Name shots by scene and letter, offer the standard size list with abbreviations and words, draw boards at the project's aspect ratio, and keep each shot linked to the script lines it covers. Keep height, tilt and pan independent. Use only `--k-*` tokens. Do not generate or replace panels without the person asking, and mark anything generated. Report anything the system does not define.

## AI readiness test

**Task:** Build the storyboard and lined page for Scene 12 with three shots.

**Give the agent:** Storyboard and shots kit, Shot card, Storyboard frame, Screenplay page.

**Constraint:** The film is 2.39:1 and 12B shares a setup with 12A.

**A reliable answer:**
- Shots named 12A, 12B, 12C
- Panels at 2.39:1 with captions
- 12B flagged same setup
- Each shot's coverage drawn beside its lines
- Gaps shown as findings, not errors
- No panel generated without asking
