Kwark. Design System
Open Kwark

Character page header

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

ComponentsCreative toolsIn the app
Characters
Mira
Saved
Characters
Mira
Saved
<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 ▾.

Do

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

Don’t

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, with aria-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

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

Open .mdllms.txt
Loading…