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, Data table for the shot list, Storyboard frame with board cast figures, Camera setup card, Playhead and scrubber for the animatic, and the Screenplay page 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, Shot card |
| Shot list | Every shot in a scene, sortable, selectable | Data table |
| Shot card | One shot’s framing, intention and production flags | Shot card |
| Blocking | Top-down plan: actors’ marks, camera positions, moves | A plan canvas with a Toolbar; board cast figures as the people |
| Storyboard | Panels in shot order at the film’s aspect | Storyboard frame |
| Animatic | Panels timed on a timeline | Playhead and scrubber, Video player |
| Setups | Camera positions with optics, for the crew packet | Camera setup card, Description list |
| On set | What was actually shot, the camera report | Camera setup card, Data table |
Live demo
A shot card, two panels at 2.39:1 and the setup’s optics.
12AMS · Eye level3 s
Mira, from the doorway
MIRA: I didn’t shoot this. Nobody did.
12BCU2 s
Insert: the monitor
Setup 1 · doorway
- Shots covered
- 12A, 12C
- Lighting
- Available light only
<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 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 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.
Lines 4–6 have no shot beside the lined page, with Add a shot for these lines.
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