Kwark. Design System
Open Kwark

Meter

A measured amount against a known limit, like a shoot day’s pages against its target. A fact, never a judgement of the work.

ComponentsData displayIn the app
Day 3 · 4 3/8 of 5 pages
Day 4 · 6 1/8 of 5 pagesOver by 1 1/8
Day 3 · 4 3/8 of 5 pages
Day 4 · 6 1/8 of 5 pagesOver by 1 1/8
<div class="kw-meter-demo">
  <div class="kw-meter-label"><span>Day 3 · 4 3/8 of 5 pages</span></div>
  <div class="kw-meter" role="meter" aria-valuemin="0" aria-valuemax="40" aria-valuenow="35" aria-valuetext="4 3/8 of 5 pages"><b style="width:87.5%"></b></div>
  <div class="kw-meter-label"><span>Day 4 · 6 1/8 of 5 pages</span><span class="kw-meter-over">Over by 1 1/8</span></div>
  <div class="kw-meter" data-over role="meter" aria-valuemin="0" aria-valuemax="40" aria-valuenow="40" aria-valuetext="6 1/8 of 5 pages, over by 1 1/8"><b style="width:100%"></b></div>
</div>

What it is

On the stripboard each shoot day carries a 3px bar under its heading: how many pages (in eighths, as a 1st AD counts them) are on the day, against the day’s target. Over the target it turns amber; the title says 6 1/8 of 5 pages. That is the meter: a quantity inside a known range.

When to use

  • Pages on a shoot day, hours on a call sheet day, storage used for offline copies, minutes of runtime against the length the writer set.

When not to use

  • For anything that grades the story. No “script health”, no “pacing score”, no completeness bar on a draft (Decision 0002, no AI judgement).
  • For progress of a task that ends: that is Progress.

Variants

Variant Use for
Within --k-ok fill
Over --k-warn fill and the overage in words; never red, over is a planning fact, not a fault

Writing

Always pair the bar with the numbers in words: 4 3/8 of 5 pages.

Anatomy

  1. Track: 3px tall, 3px corners, --k-line, inset 12px inside its card.
  2. Fill: --k-ok, or --k-warn with data-over.
  3. Label: 12px Poppins, --k-text-2, above or beside the bar; the overage in --k-warn.

Tokens

Token Light Dark
--k-line #e2e8f0 rgba(255, 255, 255, .1)
--k-ok #2c6e49 #6cc08a
--k-warn #8a5a00 #d8a44a
--k-text-2 #5b6779 #9ca3af
--k-fs-meta 12px

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.

<div class="kw-meter-demo">
  <div class="kw-meter-label"><span>Day 3 · 4 3/8 of 5 pages</span></div>
  <div class="kw-meter" role="meter" aria-valuemin="0" aria-valuemax="40" aria-valuenow="35" aria-valuetext="4 3/8 of 5 pages"><b style="width:87.5%"></b></div>
  <div class="kw-meter-label"><span>Day 4 · 6 1/8 of 5 pages</span><span class="kw-meter-over">Over by 1 1/8</span></div>
  <div class="kw-meter" data-over role="meter" aria-valuemin="0" aria-valuemax="40" aria-valuenow="40" aria-valuetext="6 1/8 of 5 pages, over by 1 1/8"><b style="width:100%"></b></div>
</div>

Keyboard

Not interactive.

ARIA

  • role="meter" with aria-valuemin, aria-valuemax, aria-valuenow and an aria-valuetext in the same words as the label. The app uses title today; the visible label is required for touch screens.

Rules

  • Never use a meter to rate, score or judge writing (Decision 0002).
  • Must show the numbers in words beside the bar.
  • Never use red for over-target; use --k-warn.
  • Always set role=“meter” with aria-valuetext.

AI readiness test

Task. Show how much of the 90-minute runtime the current draft covers.

Give the agent. This page, Decision 0002.

Constraint. The page count is 98; one page is roughly one minute.

A reliable answer

  • Shows “about 98 of 90 min” as a fact with the over state in warn
  • Does not call the draft too long or score it
  • Labels the estimate as an estimate

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

Open .mdllms.txt
Loading…