Kwark. Design System
Open Kwark

Storyboard frame

A panel on paper with an ink border at the film's aspect ratio, captioned with the shot, its words and its seconds. Board cast figures stand in for people.

ComponentsMediaIn the app

12AMS · 3s

Draw, photograph or stage it in 3D

12BCU · 2s

Mira, Arjun

12AMS · Eye level3 s

Mira, from the doorway

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

Draw, photograph or stage it in 3D

12BCU2 s

Insert: the monitor

<div class="kw-boards">
  <figure class="kw-board-panel" style="margin:0">
    <div class="kw-board-frame" data-aspect="2.39"><svg viewBox="0 0 239 100" aria-hidden="true"><g transform="translate(60,22) scale(1.5)"><circle cx="20" cy="9" r="6" fill="#c58c63"/><path d="M14 8a6 6 0 0 1 12 0c0-4-3-6-6-6s-6 2-6 6z" fill="#2b1d14"/><path d="M11 17h18l-2 16H13z" fill="#5f7393"/><path d="M13 33h6l-1 17h-4zM21 33h6l-1 17h-4z" fill="#2f3640"/></g><g transform="translate(140,30) scale(1.3)"><circle cx="20" cy="9" r="6" fill="#e0b48e"/><path d="M14 8a6 6 0 0 1 12 0c0-4-3-6-6-6s-6 2-6 6z" fill="#7a4a2a"/><path d="M11 17h18l-2 16H13z" fill="#a8734c"/><path d="M13 33h6l-1 17h-4zM21 33h6l-1 17h-4z" fill="#3b3f45"/></g></svg><span class="kw-board-frame__note">Mira, Arjun</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"><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>12B</strong><span>CU</span><span>2 s</span></p><p>Insert: the monitor</p></figcaption>
  </figure>
</div>
<div class="kw-figure-picker" role="group" aria-label="Board figure for Mira">
  <button class="kw-figure" type="button" aria-pressed="true"><svg viewBox="0 0 40 52" aria-hidden="true"><circle cx="20" cy="9" r="6" fill="#c58c63"/><path d="M14 8a6 6 0 0 1 12 0c0-4-3-6-6-6s-6 2-6 6z" fill="#2b1d14"/><path d="M11 17h18l-2 16H13z" fill="#5f7393"/><path d="M13 33h6l-1 17h-4zM21 33h6l-1 17h-4z" fill="#2f3640"/></svg>Figure 1</button>
  <button class="kw-figure" type="button" aria-pressed="false"><svg viewBox="0 0 40 52" aria-hidden="true"><circle cx="20" cy="9" r="6" fill="#e0b48e"/><path d="M14 8a6 6 0 0 1 12 0c0-4-3-6-6-6s-6 2-6 6z" fill="#7a4a2a"/><path d="M11 17h18l-2 16H13z" fill="#a8734c"/><path d="M13 33h6l-1 17h-4zM21 33h6l-1 17h-4z" fill="#3b3f45"/></svg>Figure 2</button>
  <button class="kw-figure" type="button" aria-pressed="false"><svg viewBox="0 0 40 52" aria-hidden="true"><circle cx="20" cy="9" r="6" fill="#8d5a3b"/><path d="M14 8a6 6 0 0 1 12 0c0-4-3-6-6-6s-6 2-6 6z" fill="#151515"/><path d="M11 17h18l-2 16H13z" fill="#627d5c"/><path d="M13 33h6l-1 17h-4zM21 33h6l-1 17h-4z" fill="#2b2f33"/></svg>Figure 3</button>
</div>

When to use

In the Shot module’s Storyboard step: one panel per shot, in shot order, at the film’s aspect ratio. A panel can be drawn, photographed through the viewfinder, or staged in 3D with board cast figures.

When not to

  • For reference images or mood. Use the Media grid in Look book or Research.
  • For AI-generated boards saved silently. Any machine-made frame carries a Revision mark until a person accepts it, and the board says where it came from.

Board cast figures

Twenty coloured figures, ten women and ten men, varying height, build, hair, skin, stoop and clothes. Each character gets one figure for the whole film, chosen once, not per scene (memory: board cast figures). Faces are the same mesh underneath; say so honestly in the picker’s help.

Anatomy in use

  • Frame: paper with a 2px ink border, 2px corners; empty frames show the rule of thirds.
  • Note: who is in it, top left.
  • In the can: green pill when the shot is filmed.
  • Caption: shot name in accent, size and angle, seconds; the subject; the script words in Courier, three lines.

Writing

Seconds are the animatic’s timing: 3 s. The empty frame says what can go in it, not “No image”.

A 2.39 panel with Mira and Arjun as their film-wide figures, captioned 12A · MS · 3 s.

Do

16:9 panels for a scope film, or a different figure for Mira in every scene.

Don’t

Anatomy

Grid repeat(auto-fill, minmax(220–300px, 1fr)), 18px × 16px gap. Frame aspect from data-aspect. Caption head 12px with the 14px accent name.

Tokens

Token Light Dark
--k-paper #fbfbf8
--k-paper-ink #1e2326
--k-paper-muted #4a5054
--k-paper-line #d5d9d4
--k-accent #98633f #98633f
--k-ok #2c6e49 #6cc08a

React

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

<BoardsView shots={shots} lines={lines} aspect="2.39" canEdit={canEdit}
  projectId={project.id} onChange={update} onAdd={add} />
// Figures: shared/boardFigures.ts, CastPicker.tsx (one figure per character, film-wide)
Prop Type Notes
aspect '1.78' | '1.85' | '2.39' the film’s delivery aspect
frames Record<string, string> image per shot

HTML and CSS

Works anywhere with kwark.css.

<div class="kw-boards">
  <figure class="kw-board-panel" style="margin:0">
    <div class="kw-board-frame" data-aspect="2.39"><svg viewBox="0 0 239 100" aria-hidden="true"><g transform="translate(60,22) scale(1.5)"><circle cx="20" cy="9" r="6" fill="#c58c63"/><path d="M14 8a6 6 0 0 1 12 0c0-4-3-6-6-6s-6 2-6 6z" fill="#2b1d14"/><path d="M11 17h18l-2 16H13z" fill="#5f7393"/><path d="M13 33h6l-1 17h-4zM21 33h6l-1 17h-4z" fill="#2f3640"/></g><g transform="translate(140,30) scale(1.3)"><circle cx="20" cy="9" r="6" fill="#e0b48e"/><path d="M14 8a6 6 0 0 1 12 0c0-4-3-6-6-6s-6 2-6 6z" fill="#7a4a2a"/><path d="M11 17h18l-2 16H13z" fill="#a8734c"/><path d="M13 33h6l-1 17h-4zM21 33h6l-1 17h-4z" fill="#3b3f45"/></g></svg><span class="kw-board-frame__note">Mira, Arjun</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"><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>12B</strong><span>CU</span><span>2 s</span></p><p>Insert: the monitor</p></figcaption>
  </figure>
</div>
<div class="kw-figure-picker" role="group" aria-label="Board figure for Mira">
  <button class="kw-figure" type="button" aria-pressed="true"><svg viewBox="0 0 40 52" aria-hidden="true"><circle cx="20" cy="9" r="6" fill="#c58c63"/><path d="M14 8a6 6 0 0 1 12 0c0-4-3-6-6-6s-6 2-6 6z" fill="#2b1d14"/><path d="M11 17h18l-2 16H13z" fill="#5f7393"/><path d="M13 33h6l-1 17h-4zM21 33h6l-1 17h-4z" fill="#2f3640"/></svg>Figure 1</button>
  <button class="kw-figure" type="button" aria-pressed="false"><svg viewBox="0 0 40 52" aria-hidden="true"><circle cx="20" cy="9" r="6" fill="#e0b48e"/><path d="M14 8a6 6 0 0 1 12 0c0-4-3-6-6-6s-6 2-6 6z" fill="#7a4a2a"/><path d="M11 17h18l-2 16H13z" fill="#a8734c"/><path d="M13 33h6l-1 17h-4zM21 33h6l-1 17h-4z" fill="#3b3f45"/></svg>Figure 2</button>
  <button class="kw-figure" type="button" aria-pressed="false"><svg viewBox="0 0 40 52" aria-hidden="true"><circle cx="20" cy="9" r="6" fill="#8d5a3b"/><path d="M14 8a6 6 0 0 1 12 0c0-4-3-6-6-6s-6 2-6 6z" fill="#151515"/><path d="M11 17h18l-2 16H13z" fill="#627d5c"/><path d="M13 33h6l-1 17h-4zM21 33h6l-1 17h-4z" fill="#2b2f33"/></svg>Figure 3</button>
</div>
  • Each panel is a <figure> with a <figcaption>.
  • A drawn or photographed frame needs alt text written by the person; offer the subject as a default they can edit.
  • The figure picker is a group of toggle buttons named with the figure number.

Rules

  • Must draw panels at the film’s delivery aspect ratio.
  • Must keep one board figure per character for the whole film.
  • Never save machine-made frames without a revision mark and a person accepting them.
  • Always caption with shot name, framing and seconds.

AI readiness test

Task. Build the storyboard for Scene 12’s three shots.

Give the agent. Storyboard frame, Shot card, Playhead and scrubber.

Constraint. The film is 2.39:1 and Mira already has Figure 1.

A reliable answer

  • Three 2.39 panels named 12A–12C
  • Mira uses Figure 1 in all
  • Captions with size and seconds
  • Empty frames show thirds and what can go there

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

Open .mdllms.txt
Loading…