Kwark. Design System
Open Kwark

Callout

A bordered note at the top of a working page: what someone should know before they trust what is below it.

ComponentsFeedbackIn the app
Two scenes have no day yet. The call sheet lists only scheduled scenes; Scene 12 and Scene 14 are waiting on the stripboard.
Read from the screenplay. Edit a scene’s heading in the script and it changes here.
Two scenes have no day yet. The call sheet lists only scheduled scenes; Scene 12 and Scene 14 are waiting on the stripboard.
Read from the screenplay. Edit a scene’s heading in the script and it changes here.
<div class="kw-callout" data-tone="warn"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="m21.7 18-8-14a2 2 0 0 0-3.5 0l-8 14A2 2 0 0 0 4 21h16a2 2 0 0 0 1.7-3M12 9v4M12 17h.01"/></svg><div><strong>Two scenes have no day yet.</strong> The call sheet lists only scheduled scenes; Scene 12 and Scene 14 are waiting on the stripboard.</div><button class="kw-button kw-button--sm" type="button">Open stripboard</button></div>
<div class="kw-callout" data-tone="info"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><circle cx="12" cy="12" r="10"/><path d="M12 16v-4M12 8h.01"/></svg><div><strong>Read from the screenplay.</strong> Edit a scene’s heading in the script and it changes here.</div></div>

What it is

The production office’s notice (.po-notice): what production should know before trusting the page. It sits at the top of a module, in the flow of the page, with an optional action at its end.

When to use

  • A fact about this page’s data that changes how someone reads it: unscheduled scenes, a call sheet issued against an older draft, a budget line still estimated.

When not to use

  • For the state of saving: Sync status.
  • For something that happened just now: Toast.
  • For a whole-screen condition (not downloaded, changed elsewhere): a banner across the editor.
  • For tips or coaching. Kwark does not teach (Decision 0004).

Variants

Variant Use for
Warn Something on this page is incomplete or out of date
Info Where the data comes from, once, when it is not obvious

Writing

Lead with a bold sentence that states the fact; follow with what it means. One action at most, named for where it goes.

Anatomy

  1. Box: 12px 14px, 10px corners, 1px border color-mix(tone 45%, --k-line), background color-mix(tone 9%, transparent), 18px below it.
  2. Glyph: 16px in the tone, 2px down to sit on the first line.
  3. Text: 14px (the app uses 13.5px), line height 1.55; the lead in 600.
  4. Action: a small secondary button, pushed to the end.

Tokens

Token Light Dark
--k-warn #8a5a00 #d8a44a
--k-info #255799 #7db4f0
--k-line #e2e8f0 rgba(255, 255, 255, .1)
--k-text #0f172a #e3e3e3
--k-radius-card 10px
--k-fs-body 14px

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-callout" data-tone="warn"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="m21.7 18-8-14a2 2 0 0 0-3.5 0l-8 14A2 2 0 0 0 4 21h16a2 2 0 0 0 1.7-3M12 9v4M12 17h.01"/></svg><div><strong>Two scenes have no day yet.</strong> The call sheet lists only scheduled scenes; Scene 12 and Scene 14 are waiting on the stripboard.</div><button class="kw-button kw-button--sm" type="button">Open stripboard</button></div>
<div class="kw-callout" data-tone="info"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><circle cx="12" cy="12" r="10"/><path d="M12 16v-4M12 8h.01"/></svg><div><strong>Read from the screenplay.</strong> Edit a scene’s heading in the script and it changes here.</div></div>

Keyboard

Key Does
Tab Reaches the action, if any.

ARIA

  • Static callouts are plain content; give them role="note" when they explain the region below. Do not use role="alert" for something that was there when the page loaded.

Rules

  • Must open with the fact in bold, then what it means.
  • Never use a callout for tips, coaching or praise (Decision 0004).
  • Always keep at most one action, named for its destination.
  • Never stack more than two callouts; merge them.

AI readiness test

Task. Warn on the call sheet that it was issued from draft 3 and the script is now on draft 4.

Give the agent. This page, Decision 0020.

Constraint. Re-issuing creates Rev 2.

A reliable answer

  • Uses a warn callout at the top of the call sheet
  • Leads with "Issued from draft 3
  • the script is now draft 4."
  • Offers one action “Issue Rev 2”
  • Does not use a toast

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

Open .mdllms.txt
Loading…