Kwark. Design System
Open Kwark

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.

Creative app kits
12A · Mira, from the doorway

12AMS · 3 s

12B · the monitor

12BCU · 2 s

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.

Draw, photograph or stage it in 3D

12AMS · Eye level3 s

Mira, from the doorway

MIRA: I didn’t shoot this. Nobody did.

Insert

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.

Do

A generated board for the whole scene saved over the artist’s panels.

Don’t

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

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

Open .mdllms.txt
Loading…