Kwark. Design System
Open Kwark

Status dot

A small shape and a word for a state: saved, on this device, offline. Its film use is the call sheet’s read receipts, where each crew member is confirmed, read or not yet reached.

ComponentsFeedbackReady for Kwark
ConfirmedRead, not confirmedSent 06:10Bounced: check the email
18 confirmed 3 read 2 sent 1 bounced
  • 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
Saved Saving On this device Offline Not shared
<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

Motion

Only Saving pulses, and only while a save is in flight: motion that answers an action. Nothing else moves.

Anatomy

  1. Mark: 8px (10px at --lg), --kw-sdot set by data-tone; shapes by data-shape: filled, half (1.5px ring, left half filled), ring (1.5px), diamond (7px turned 45°, 1px corners), dash (9 × 2px).
  2. Gap: 8px.
  3. Word: Poppins 500 12px in --k-text, tabular; a time or detail in 400 --k-text-2.
  4. Tones: ok, info, warn, danger, accent (for Saving), and the quiet default --k-text-2.
  5. 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

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

Open .mdllms.txt
Loading…