Kwark. Design System
Open Kwark

Banner

A persistent message about the whole page: read-only, offline, out of sync.

ComponentsFeedbackIn the app
This screenplay has not downloaded to this device. Nothing will be saved until it does, so the copy elsewhere stays exactly as it is.
This screenplay was changed in another session. Your edits are kept on this device and have not overwritten it.
Read only. You can read this outline and leave comments. Ask Mira for Write access to change it.
This screenplay has not downloaded to this device. Nothing will be saved until it does, so the copy elsewhere stays exactly as it is.
This screenplay was changed in another session. Your edits are kept on this device and have not overwritten it.
Read only. You can read this outline and leave comments. Ask Mira for Write access to change it.
<div class="kw-banner kw-banner--warn" role="status"><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="m2 2 20 20M5.8 5.8A7 7 0 0 0 9 19h8.5a4.5 4.5 0 0 0 1.3-.2M21.5 15.5A4.5 4.5 0 0 0 17.5 10h-1.8A7 7 0 0 0 9.9 5.1"/></svg><span><strong>This screenplay has not downloaded to this device.</strong> Nothing will be saved until it does, so the copy elsewhere stays exactly as it is.</span><button class="kw-button" type="button">Try again</button></div>
<div class="kw-banner kw-banner--danger" role="status"><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><span><strong>This screenplay was changed in another session.</strong> Your edits are kept on this device and have not overwritten it.</span><button class="kw-button" type="button">Load the newer version</button><button class="kw-button" type="button">Keep mine</button></div>
<div class="kw-banner kw-banner--quiet" role="status"><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="M2 12s3-7 10-7 10 7 10 7-3 7-10 7S2 12 2 12"/><circle cx="12" cy="12" r="3"/></svg><span><strong>Read only.</strong> You can read this outline and leave comments. Ask Mira for Write access to change it.</span></div>

What it is

A full-width bar across the top of a screen for a state the person has to decide about, or must know before they type. The real ones are the screenplay’s sync banners (ScriptSyncStatus): not downloaded, changed in another session, unsaved edits found on this device. Everything calmer is a word at the corner (Sync status).

Variants

Tone When
Warn The copy here is incomplete or not yet in the cloud
Danger Two versions disagree and the person must choose
Info Something to restore (Unsaved edits from 14:05 were found on this device)
Quiet Read-only access (ReadOnlyModule stops typing; the banner says why)

Writing

The first sentence, bold in the tone, says what happened. The second says what is safe (Decision 0013). Buttons name the choices: Load the newer version, Keep mine. Never Error or Failed.

When not to use

For a fact about a page’s data, use a Callout; for a receipt, a Toast.

Anatomy

  1. Bar: full width, sticky to the top of its screen, 10px 16px, 1px bottom border color-mix(tone 35%), ground color-mix(tone 12%, --k-bg).
  2. Glyph: 14px in the tone.
  3. Text: Poppins 500 12px; the lead sentence 600 in the tone.
  4. Actions: 28px buttons with 4px corners, 1px line, 12px 600, at the end.

Tokens

Token Light Dark
--k-warn #8a5a00 #d8a44a
--k-danger #b4382c #e0685c
--k-info #255799 #7db4f0
--k-text-2 #5b6779 #9ca3af
--k-bg #f8fafc #191919
--k-line #e2e8f0 rgba(255, 255, 255, .1)
--k-text #0f172a #e3e3e3
--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-banner kw-banner--warn" role="status"><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="m2 2 20 20M5.8 5.8A7 7 0 0 0 9 19h8.5a4.5 4.5 0 0 0 1.3-.2M21.5 15.5A4.5 4.5 0 0 0 17.5 10h-1.8A7 7 0 0 0 9.9 5.1"/></svg><span><strong>This screenplay has not downloaded to this device.</strong> Nothing will be saved until it does, so the copy elsewhere stays exactly as it is.</span><button class="kw-button" type="button">Try again</button></div>
<div class="kw-banner kw-banner--danger" role="status"><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><span><strong>This screenplay was changed in another session.</strong> Your edits are kept on this device and have not overwritten it.</span><button class="kw-button" type="button">Load the newer version</button><button class="kw-button" type="button">Keep mine</button></div>
<div class="kw-banner kw-banner--quiet" role="status"><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="M2 12s3-7 10-7 10 7 10 7-3 7-10 7S2 12 2 12"/><circle cx="12" cy="12" r="3"/></svg><span><strong>Read only.</strong> You can read this outline and leave comments. Ask Mira for Write access to change it.</span></div>

See the read-only and offline banners in the screenplay editor and project permission wrappers. Choose copy according to effective access.

  • role="status" when it appears after load; static banners need no role.

Rules

  • Must say what the person can still do, not only what is blocked.
  • Never use red or an alarm icon for offline or read-only states.

AI readiness test

Task. Tell a collaborator they have view-only access to the screenplay.

Give the agent. Banner, Sharing and roles, Content and voice.

Constraint. Calm voice.

A reliable answer

  • “View only.” lead-in
  • Says they can read and comment
  • Names who can grant edit access

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

Open .mdllms.txt
Loading…