Kwark. Design System
Open Kwark

Stat

The call sheet's top band as figures: Day 7 of 24, crew call, sunrise, wrap +1, pages in eighths. Big tabular numbers, a label above, one quiet line of context.

ComponentsData displayReady for Kwark
Shoot day
7of 24
Mon 25 Nov
Crew call
16:30
Shooting 17:30
Sunset
17:44
Sunrise 06:31
Wrap, about
03:30+1, the next day
Night exterior
Pages
46/8
5 scenes
Pages
104
Draft 5
Scenes
58
2 omitted
Speaking parts
11
Shoot days
12
Not scheduled yet: 3 scenes
Shoot day
7of 24
Mon 25 Nov
Crew call
16:30
Shooting 17:30
Sunset
17:44
Sunrise 06:31
Wrap, about
03:30+1, the next day
Night exterior
Pages
46/8
5 scenes
Pages
104
Draft 5
Scenes
58
2 omitted
Speaking parts
11
Shoot days
12
Not scheduled yet: 3 scenes
<dl class="kw-statband" aria-label="Day 7 at a glance">
  <div class="kw-statband__cell kw-statband__cell--lead"><dt>Shoot day</dt><dd>7<small>of 24</small></dd><span>Mon 25 Nov</span></div>
  <div class="kw-statband__cell"><dt>Crew call</dt><dd>16:30</dd><span>Shooting 17:30</span></div>
  <div class="kw-statband__cell"><dt>Sunset</dt><dd>17:44</dd><span>Sunrise 06:31</span></div>
  <div class="kw-statband__cell"><dt>Wrap, about</dt><dd>03:30<sup class="kw-plus1">+1<span class="kw-visually-hidden">, the next day</span></sup></dd><span>Night exterior</span></div>
  <div class="kw-statband__cell"><dt>Pages</dt><dd>4<small class="kw-eighths">6/8</small></dd><span>5 scenes</span></div>
</dl>
<dl class="kw-statband kw-statband--compact" aria-label="Blank Pages in numbers">
  <div class="kw-statband__cell"><dt>Pages</dt><dd>104</dd><span>Draft 5</span></div>
  <div class="kw-statband__cell"><dt>Scenes</dt><dd>58</dd><span>2 omitted</span></div>
  <div class="kw-statband__cell"><dt>Speaking parts</dt><dd>11</dd></div>
  <div class="kw-statband__cell"><dt>Shoot days</dt><dd>12</dd><span>Not scheduled yet: 3 scenes</span></div>
</dl>

What it is

A stat is a figure big enough to read across a room, with its label and one line of context. Kwark’s model is the top band of a call sheet: the shoot day, crew call, sun times, the wrap and the pages, which the crew reads before anything else. Figures are facts. A stat never carries a target, a trend arrow or praise.

When to use

  • Two to five facts about the whole: the day on a call sheet, the script on project home, the schedule above the stripboard.
  • When the number is the point and the reader needs it in a second.

When not to

  • For progress against a goal Kwark invented. Kwark measures; it does not judge (Decision 0002).
  • For one figure. Put it in a sentence: The script runs about 1 h 44 min.
  • Never with arrows, red or green, or +12% this week about a person’s work (Decision 0036).

Film conventions it keeps

  • Times in 24-hour form with a colon, tabular, as call sheets print them.
  • Overnight: a wrap after midnight carries a small +1 (the next day), as night-shoot call sheets mark it. Never 3:30 AM alone, which reads as the morning before.
  • Pages in eighths: 4 6/8, the eighths set smaller after the whole pages.
  • Day n of N: the lead cell says where the shoot is.

Variants

Variant Use
Band (default) The call sheet and the schedule: 28px figures, the lead cell on a raised ground
Compact (--compact) Project home and panels: 20px figures

Writing

Labels are nouns in sentence case (Crew call, Wrap, about). Estimates say about. Context lines are facts (2 omitted, Night exterior), never praise or blame.

Wrap, about 03:30 +1 · Night exterior.

Do

Wrap 3:30 with no sign it is the next morning, or 58 scenes in green with an up arrow and Great progress.

Don’t

Anatomy

  1. Band: <dl class="kw-statband">, cells at least 120px wide that wrap and grow to fill each row, 1px --k-line hairlines between cells on a 10px-cornered frame, like a contact sheet.
  2. Label (dt): 12px 500 --k-text-2, above the figure.
  3. Figure (dd): Poppins 600 at --k-fs-display (28px), tabular, line height 1.1; compact 20px.
  4. Suffix (small): of 24, eighths; 12px 500 --k-text-2 on the baseline.
  5. +1: a 10px-high pill, 600, --k-chart-aqua at 22% on the surface, raised to the cap height; the words the next day for screen readers.
  6. Context: 12px --k-text-2, one line.
  7. Lead cell: --k-raise ground.

Tokens

Token Light Dark
--k-surface #ffffff #1a1a1a
--k-line #e2e8f0 rgba(255, 255, 255, .1)
--k-text #0f172a #e3e3e3
--k-text-2 #5b6779 #9ca3af
--k-raise #f1f5f9 #252525
--k-chart-aqua #509ca0 var(–k-brand-aqua)
--k-fs-display 28px
--k-fs-head 20px
--k-fs-meta 12px
--k-radius-card 10px

States

State Look
Value not known The label stays; the figure reads Not set in 14px --k-text-2
Estimate about in the label, never a tilde
Phone Two columns; the lead cell spans both

React

Use the HTML below with kwark.css. The example shows the markup and styling. Supply any application behavior described on this page.

HTML and CSS

Works anywhere with kwark.css.

<dl class="kw-statband" aria-label="Day 7 at a glance">
  <div class="kw-statband__cell kw-statband__cell--lead"><dt>Shoot day</dt><dd>7<small>of 24</small></dd><span>Mon 25 Nov</span></div>
  <div class="kw-statband__cell"><dt>Crew call</dt><dd>16:30</dd><span>Shooting 17:30</span></div>
  <div class="kw-statband__cell"><dt>Sunset</dt><dd>17:44</dd><span>Sunrise 06:31</span></div>
  <div class="kw-statband__cell"><dt>Wrap, about</dt><dd>03:30<sup class="kw-plus1">+1<span class="kw-visually-hidden">, the next day</span></sup></dd><span>Night exterior</span></div>
  <div class="kw-statband__cell"><dt>Pages</dt><dd>4<small class="kw-eighths">6/8</small></dd><span>5 scenes</span></div>
</dl>
<dl class="kw-statband kw-statband--compact" aria-label="Blank Pages in numbers">
  <div class="kw-statband__cell"><dt>Pages</dt><dd>104</dd><span>Draft 5</span></div>
  <div class="kw-statband__cell"><dt>Scenes</dt><dd>58</dd><span>2 omitted</span></div>
  <div class="kw-statband__cell"><dt>Speaking parts</dt><dd>11</dd></div>
  <div class="kw-statband__cell"><dt>Shoot days</dt><dd>12</dd><span>Not scheduled yet: 3 scenes</span></div>
</dl>

Markup

Keep the DOM order label, figure, context so screen readers say Crew call, 16:30. The band is a <dl>; each cell a <div> holding dt, dd and a context span.

Screen readers

  • Each cell is a term and its definition.
  • The +1 includes visually hidden words: 03:30, the next day.
  • Eighths read as written (4 6/8); add a title only if a page reads them as a date.

Motion

Never count numbers up on arrival.

Rules

  • Never show targets, trends or praise in a stat about someone’s work.
  • Must mark a time after midnight with +1 and say “the next day” to screen readers.
  • Must write page counts in eighths and times in 24-hour form.
  • Must use two to five stats in a band.
  • Never animate numbers.

AI readiness test

Task. Put the day’s essentials at the top of the Day 9 call sheet, a split day ending in a night exterior.

Give the agent. Stat, Call sheet, Production calendar.

Constraint. Wrap is after midnight; sunrise and sunset come from the location.

A reliable answer

  • Day 9 of 24 as the lead cell
  • Crew call and shooting call in 24-hour form
  • Sunset with sunrise as context
  • Wrap with +1 and hidden words
  • Pages in eighths

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

Open .mdllms.txt
Loading…