<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>
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 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”.
One line: ← Characters | portrait Mira Saved … Share ▾ More ▾.
A breadcrumb row, a status strip and three buttons named Edit fields, Edit pages, Add page above the content.
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 |
React
In the Kwark app: import CharacterWorkspace from '@/pages/Understanding/CharacterModule/components/CharacterWorkspace'.
// .character-topbar and .character-sidebar (Decision 0033)
<CharacterWorkspace characterId={id} />
| Prop | Type | Notes |
|---|---|---|
characterId |
string |
HTML and CSS
Works anywhere with kwark.css.
<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>
- 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, witharia-current="page"on the open page.
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