- Tara SenMira · call 06:30Confirmed 06:42
- Devika NairAanya · call 07:15Read 06:58
- Kabir ShahGaffer · call 06:00Sent 06:10
- Riya DasSound mixer · call 07:30Bounced
<div class="kw-receipts__sum">
<span class="kw-sdot kw-sdot--lg" data-tone="ok"><span class="kw-sdot__mark" aria-hidden="true"></span>18 confirmed</span>
<span class="kw-sdot kw-sdot--lg" data-tone="info" data-shape="half"><span class="kw-sdot__mark" aria-hidden="true"></span>3 read</span>
<span class="kw-sdot kw-sdot--lg" data-shape="ring"><span class="kw-sdot__mark" aria-hidden="true"></span>2 sent</span>
<span class="kw-sdot kw-sdot--lg" data-tone="warn" data-shape="diamond"><span class="kw-sdot__mark" aria-hidden="true"></span>1 bounced</span>
</div>
<ul class="kw-receipts" aria-label="Call sheet Rev 2, read receipts">
<li><span class="kw-receipts__who">Tara Sen<small>Mira · call 06:30</small></span><span class="kw-sdot" data-tone="ok"><span class="kw-sdot__mark" aria-hidden="true"></span>Confirmed <small>06:42</small></span></li>
<li><span class="kw-receipts__who">Devika Nair<small>Aanya · call 07:15</small></span><span class="kw-sdot" data-tone="info" data-shape="half"><span class="kw-sdot__mark" aria-hidden="true"></span>Read <small>06:58</small></span></li>
<li><span class="kw-receipts__who">Kabir Shah<small>Gaffer · call 06:00</small></span><span class="kw-sdot" data-shape="ring"><span class="kw-sdot__mark" aria-hidden="true"></span>Sent <small>06:10</small></span></li>
<li><span class="kw-receipts__who">Riya Das<small>Sound mixer · call 07:30</small></span><span class="kw-sdot" data-tone="warn" data-shape="diamond"><span class="kw-sdot__mark" aria-hidden="true"></span>Bounced</span></li>
</ul>
<div style="display:flex;flex-wrap:wrap;gap:20px">
<span class="kw-sdot" data-tone="ok"><span class="kw-sdot__mark" aria-hidden="true"></span>Saved</span>
<span class="kw-sdot" data-tone="accent" data-live><span class="kw-sdot__mark" aria-hidden="true"></span>Saving</span>
<span class="kw-sdot" data-tone="warn" data-shape="half"><span class="kw-sdot__mark" aria-hidden="true"></span>On this device</span>
<span class="kw-sdot" data-shape="ring"><span class="kw-sdot__mark" aria-hidden="true"></span>Offline</span>
<span class="kw-sdot" data-shape="dash"><span class="kw-sdot__mark" aria-hidden="true"></span>Not shared</span>
</div>
What it is
An 8px mark and a word. The word carries the state; the mark lets a column of states be scanned at a glance. It is never shown alone.
The Kwark idea: shapes that survive a photocopy
Status dots in most systems are coloured circles, which mean nothing to someone with colour blindness, on a greyscale printout, or on a phone in sunlight on set. Kwark’s dots change shape as well as colour, in an order that reads as progress, so a call sheet’s receipts can be read from a printout:
| Shape | Means | Call sheet | Saving |
|---|---|---|---|
| Filled | Done | Confirmed | Saved (in the cloud) |
| Half | Part way | Read, not confirmed | On this device, not yet in the cloud |
| Ring | Started, nothing back yet | Sent | Offline |
| Diamond | Needs a person | Bounced: check the email | – |
| Dash | Does not apply | Not on this sheet | Not shared |
When to use
- A column of the same kind of state: crew receipts on an issued call sheet (Decision 0020), who has read Rev 2, a list of exports.
- A save state where space is tight, beside sync status.
When not to use
- For a problem the person must fix: an inline notice or banner.
- For counts: a badge.
- For presence of a person: their avatar with the here mark.
Motion
Only Saving pulses, and only while a save is in flight: motion that answers an action. Nothing else moves.
Anatomy
- Mark: 8px (10px at
--lg),--kw-sdotset bydata-tone; shapes bydata-shape: filled,half(1.5px ring, left half filled),ring(1.5px),diamond(7px turned 45°, 1px corners),dash(9 × 2px). - Gap: 8px.
- Word: Poppins 500 12px in
--k-text, tabular; a time or detail in 400--k-text-2. - Tones: ok, info, warn, danger, accent (for Saving), and the quiet default
--k-text-2. - Receipts list: 44px rows with a 1px line, the person and their role and call time on the left, the state on the right; a summary row of counts above.
Tokens
| Token | Light | Dark |
|---|---|---|
--k-ok |
#2c6e49 | #6cc08a |
--k-info |
#255799 | #7db4f0 |
--k-warn |
#8a5a00 | #d8a44a |
--k-danger |
#b4382c | #e0685c |
--k-accent-soft |
#e8b58b | #e8b58b |
--k-text |
#0f172a | #e3e3e3 |
--k-text-2 |
#5b6779 | #9ca3af |
--k-line |
#e2e8f0 | rgba(255, 255, 255, .1) |
--k-tap |
44px | |
--k-fs-meta |
12px | |
--k-fs-body |
14px | |
--k-ease-in-out |
cubic-bezier(.65, 0, .35, 1) |
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-receipts__sum">
<span class="kw-sdot kw-sdot--lg" data-tone="ok"><span class="kw-sdot__mark" aria-hidden="true"></span>18 confirmed</span>
<span class="kw-sdot kw-sdot--lg" data-tone="info" data-shape="half"><span class="kw-sdot__mark" aria-hidden="true"></span>3 read</span>
<span class="kw-sdot kw-sdot--lg" data-shape="ring"><span class="kw-sdot__mark" aria-hidden="true"></span>2 sent</span>
<span class="kw-sdot kw-sdot--lg" data-tone="warn" data-shape="diamond"><span class="kw-sdot__mark" aria-hidden="true"></span>1 bounced</span>
</div>
<ul class="kw-receipts" aria-label="Call sheet Rev 2, read receipts">
<li><span class="kw-receipts__who">Tara Sen<small>Mira · call 06:30</small></span><span class="kw-sdot" data-tone="ok"><span class="kw-sdot__mark" aria-hidden="true"></span>Confirmed <small>06:42</small></span></li>
<li><span class="kw-receipts__who">Devika Nair<small>Aanya · call 07:15</small></span><span class="kw-sdot" data-tone="info" data-shape="half"><span class="kw-sdot__mark" aria-hidden="true"></span>Read <small>06:58</small></span></li>
<li><span class="kw-receipts__who">Kabir Shah<small>Gaffer · call 06:00</small></span><span class="kw-sdot" data-shape="ring"><span class="kw-sdot__mark" aria-hidden="true"></span>Sent <small>06:10</small></span></li>
<li><span class="kw-receipts__who">Riya Das<small>Sound mixer · call 07:30</small></span><span class="kw-sdot" data-tone="warn" data-shape="diamond"><span class="kw-sdot__mark" aria-hidden="true"></span>Bounced</span></li>
</ul>
<div style="display:flex;flex-wrap:wrap;gap:20px">
<span class="kw-sdot" data-tone="ok"><span class="kw-sdot__mark" aria-hidden="true"></span>Saved</span>
<span class="kw-sdot" data-tone="accent" data-live><span class="kw-sdot__mark" aria-hidden="true"></span>Saving</span>
<span class="kw-sdot" data-tone="warn" data-shape="half"><span class="kw-sdot__mark" aria-hidden="true"></span>On this device</span>
<span class="kw-sdot" data-shape="ring"><span class="kw-sdot__mark" aria-hidden="true"></span>Offline</span>
<span class="kw-sdot" data-shape="dash"><span class="kw-sdot__mark" aria-hidden="true"></span>Not shared</span>
</div>
ARIA
- The mark is
aria-hidden="true"; the word is the state. Screen readers hear Confirmed, 06:42. - When a state changes while the person watches (Saving to Saved), the text sits in a polite live region; a list of receipts does not announce each change, only the summary (19 confirmed).
Contrast
- Marks are at least 3:1 against their ground (WCAG 1.4.11); the shape is the second cue, the word the first.
- The pulse stops under
prefers-reduced-motion.
Rules
- Must pair every dot with a word; never a dot alone.
- Must use the shape order filled, half, ring, diamond, dash so states read without colour.
- Never animate a dot except Saving while a save is in flight.
- Never use a status dot for an error the person must fix; use an inline notice or banner.
- Always give the time or detail of a receipt in the quiet second colour.
AI readiness test
Task. Show who has received the Day 7 call sheet, Rev 2.
Give the agent. This page, Call sheet, Decision 0020.
Constraint. Some crew read it on paper; the sheet may be printed in black and white.
A reliable answer
- A receipts list with Confirmed (filled), Read (half), Sent (ring), Bounced (diamond)
- Each with a word and time
- A summary of counts above
- Readable on a greyscale printout