# Character page header

> One line across the character page: back, portrait, name, the save word, Share and More. Pages in one list beside it.

Source: https://kwark.space/designSystem/components/character-header

## Usage

### When to use
At the top of every character page (Decision 0033). It replaced a breadcrumb, a status strip and loose buttons, which the founder called "so bad".

### When not to
- On other modules' pages. They use the [Page header](https://kwark.space/designSystem/components/page-header.md) and the unified breadcrumb (Decision 0044).

### Desktop and phone
| | Desktop | Phone |
|---|---|---|
| Line | ← Characters, portrait, name, save word, **Share ▾**, **More ▾** | ←, portrait, name, **More ▾** |
| Share ▾ | Actor PDF, Copy for AI | inside More |
| More ▾ | History, Change portrait | Share's items, History, portrait |
| Pages | Sidebar list, groups "About {first name}" and "In the story" | "{page} ▾" chooser with the page icon; its sheet has 44px rows |

### The page list
- The open page is a filled pill (22% accent) with a 2px edge bar. No dot.
- **Manage pages** is one row at the end of the list, opening one sheet with Add, Arrange and Fields.

### Writing
The save word follows the calm voice (0013): *Saved*, *Saving…*, *Saved on this device*. Never "All changes saved successfully".

**Do:** One line: ← Characters | portrait Mira Saved … Share ▾ More ▾.

**Don't:** A breadcrumb row, a status strip and three buttons named *Edit fields*, *Edit pages*, *Add page* above the content.

## Style

### Anatomy

Header min-height 56px, 8px × 24px padding, `--k-bg`, 1px bottom line, sticky. Portrait 36px disc. Name Raleway 600 16px. Page list rows 40px (44px on coarse pointers), 6px corners.

### Tokens

| Token | Light | Dark |
|---|---|---|
| `--k-bg` | #f8fafc | #191919 |
| `--k-line` | #e2e8f0 | rgba(255, 255, 255, .1) |
| `--k-text` | #0f172a | #e3e3e3 |
| `--k-text-2` | #5b6779 | #9ca3af |
| `--k-accent` | #98633f | #98633f |
| `--k-accent-soft` | #e8b58b | #e8b58b |
| `--k-fs-title` | 16px |  |
| `--k-font-display` | 'Raleway', 'Poppins', system-ui, sans-serif |  |

## Code

### React

In the Kwark app: `import CharacterWorkspace from '@/pages/Understanding/CharacterModule/components/CharacterWorkspace'`.

```tsx
// .character-topbar and .character-sidebar (Decision 0033)
<CharacterWorkspace characterId={id} />
```

| Prop | Type | Notes |
|---|---|---|
| `characterId` | `string` |  |

### HTML and CSS

Works anywhere with `kwark.css`.

```html
<header class="kw-character-header">
  <a class="kw-text-button" href="#characters"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="m15 18-6-6 6-6"/></svg> Characters</a>
  <span class="kw-character-header__divider" aria-hidden="true"></span>
  <div class="kw-character-header__who">
    <button class="kw-character-header__portrait" type="button" aria-label="Mira’s portrait">M</button>
    <h1>Mira</h1>
    <span class="kw-character-header__saved" role="status">Saved</span>
  </div>
  <div class="kw-character-header__actions">
    <button class="kw-text-button" type="button" aria-haspopup="menu"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M4 12v7a1 1 0 0 0 1 1h14a1 1 0 0 0 1-1v-7M16 6l-4-4-4 4M12 2v13"/></svg> Share <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true" class="kw-caret"><path d="m6 9 6 6 6-6"/></svg></button>
    <button class="kw-text-button" type="button" aria-haspopup="menu">More <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true" class="kw-caret"><path d="m6 9 6 6 6-6"/></svg></button>
  </div>
</header>
<nav class="kw-page-list" aria-label="Mira’s pages">
  <span class="kw-page-list__group">About Mira</span>
  <a href="#basics" aria-current="page">Basics</a>
  <a href="#want">What she wants</a>
  <span class="kw-page-list__group">In the story</span>
  <a href="#scenes">Scenes</a>
  <a href="#arc">Arc</a>
</nav>
```

## Accessibility

- The name is the page's `<h1>`.
- The save word is a polite `role="status"`.
- Share and More are menu buttons with `aria-haspopup="menu"` and become sheets on phones.
- The page list is a `<nav>` named for the character, with `aria-current="page"` on the open page.

## For agents

### Rules

- **Must** keep the character header to one line with no breadcrumb above it (Decision 0033).
- **Must** keep the name visible at 375px by moving Share into More on phones.
- **Always** mark the open page with the filled pill and edge bar, never a dot.

### AI readiness test

**Task:** Add a "Compare with another character" action to the character page.

**Give the agent:** Character page header, Menu, Decision 0033.

**Constraint:** No new buttons on the header line.

**A reliable answer:**
- Action added to More ▾
- On phones it is in the same More sheet
- Header stays one line
- Name not truncated at 375px
