# Page header

> One line on a phone: back, a one-word title, and the labelled Menu.

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

## Usage

Every phone screen opens with the same 44px line: a back chevron, a one-word title, at most two labelled actions, and **Menu ▾** for the rest. No subtitle, no breadcrumb, no explanatory sentence.

Why: on a phone the work is the point. Content must begin by about y = 200, so chrome gets one line and the floating dial holds comments, quick notes and account.

## Style

### Anatomy

**Phone (`.k-header`, Decision 0016)**
1. One sticky 44px line, 4px side padding plus the safe area, 1px `--k-line` under it, `--k-bg`.
2. Back: a 44px icon button with a 20px chevron, named for where it goes.
3. Title: one word, Raleway 600 16px, truncated; tappable with a 14px chevron when it opens the Places sheet.
4. Actions: at most two text buttons, normally **Menu ▾**. Comments, Quick note and Account are in the [floating dial](https://kwark.space/designSystem/components/floating-dial.md).

**Desktop module head** (under the breadcrumb, e.g. Breakdown)
1. Raleway 400 at `--k-fs-display`; one 12px `--k-text-2` sentence at line height 1.8, at most 680px wide.
2. Actions to the right as bordered text buttons (*Just the work*, *Open beside the script*).
3. 1px `--k-line` under the head.

### Tokens

| Token | Light | Dark |
|---|---|---|
| `--k-tap` | 44px |  |
| `--k-fs-head` | 20px |  |
| `--k-font-display` | 'Raleway', 'Poppins', system-ui, sans-serif |  |

## Code

### React

In the Kwark app: `import { PageHeader } from '@/components/ui/PageHeader'`.

```tsx
<PageHeader title="Characters" onBack={backToProject} backLabel="Back to Blank Pages"
  actions={<TextButton label="Menu" opens onClick={openMenu} />} />
```

| Prop | Type | Notes |
|---|---|---|
| `title` | `string` | Screen name. |
| `onBack` | `() => void` | Optional return action. |
| `backLabel` | `string` | Names the destination. |
| `actions` | `ReactNode` | At most two relevant controls. |
| `dial` | `boolean` | Defaults to true. Set false for a specimen. |

### HTML and CSS

Works anywhere with `kwark.css`.

```html
<div style="width:100%;max-width:375px;border:1px solid var(--k-line);border-radius:var(--k-radius-card);overflow:hidden">
<header class="kw-page-header"><button class="kw-icon-button" type="button" aria-label="Back to Blank Pages" title="Back to Blank Pages"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" aria-hidden="true"><path d="m15 18-6-6 6-6"/></svg></button><h1 class="kw-page-header__title"><span>Characters</span></h1><span class="kw-page-header__actions"><button class="kw-text-button" type="button" aria-haspopup="menu"><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="M4 6h16M4 12h16M4 18h16"/></svg><span>Menu</span><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" aria-hidden="true"><path d="m6 9 6 6 6-6"/></svg></button></span></header>
<div style="padding:16px;color:var(--k-text-2);font-size:var(--k-fs-meta)">Mira · Aanya · Nana</div></div>
<div class="kw-module-head" style="width:100%"><div><h1>Breakdown</h1><p>Mark the script the way it is marked on paper, and the sheet writes itself.</p></div><button class="kw-text-button kw-text-button--bordered" type="button"><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="M7 7h10v10M7 17 17 7"/></svg><span>Just the work</span></button></div>
```

## Accessibility

- The title is the page `<h1>`.
- Back has a name that says where it goes: *Back to project*.

## For agents

### Rules

- **Must** keep the phone header to one 44px line.
- **Never** add a subtitle or breadcrumb to a phone header.
- **Must** put overflow actions under a labelled "Menu ▾".

### AI readiness test

**Task:** Make the phone header for the Budget screen, which has export, share, currency and five filters.

**Give the agent:** Page header, Phones pattern, Sheet.

**Constraint:** Content by y≈200.

**A reliable answer:**
- Back + "Budget" + Menu ▾
- Filters in a Sheet
- At most two labelled actions
