# Banner

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

Source: https://kwark.space/designSystem/components/banner

## Usage

### 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](https://kwark.space/designSystem/components/sync-status.md)).

### 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](https://kwark.space/designSystem/components/callout.md); for a receipt, a [Toast](https://kwark.space/designSystem/components/toast.md).

## Style

### 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 |  |

## Code

### 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`.

```html
<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.

## Accessibility

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

## For agents

### 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
