# Top bar

> The one line at the top of the project library: the Kwark wordmark, whose stories these are, and the two things people do here.

Source: https://kwark.space/designSystem/components/top-bar

## Usage

### What it is
The top of Home, measured from the running app at 1440 × 900: the wordmark (Raleway 34px, 400, -0.055em, with the warm full stop), the workspace switcher pill (*My stories ▾*), and at the far end *Dailies*, the blue **New project ▾** and the 36px account circle. A 1px rule closes the bar. Inside a project there is no top bar: the breadcrumb is the first line (Decision 0044).

### When to use
- Home (the project library) and other top-level screens outside a project: Dailies, Trash.

### When not to use
- Inside a project. The breadcrumb and the page’s own actions take that line.
- On phones. Decision 0021 makes the projects the phone’s home; the bar folds into the one-line header and the floating dial holds Account (Decision 0016).

### Variants
| Variant | Use for |
|---|---|
| Signed out | Account circle shows the person glyph; its name is *Sign in*. |
| Signed in | The circle shows the avatar (UserAvatar, 36px). |
| In a production house | The switcher shows the house’s logo and name instead of *My stories*. |

### The blue button
**New project** and **Sign in** are the only places Kwark uses its home blue (`--home-blue`, #1d6ce0 in HomeWorkspace.css). Everything that acts inside a project uses the project’s accent. Do not carry the blue into a project.

### Writing
- *New project*, not *Create*. *Dailies*, not *Footage*. The switcher names whose shelf you are looking at: *My stories*, or the house’s name.

## Style

### Anatomy

1. **Wordmark**: three dots (the Kwark mark) then *Kwark.*, Raleway 34px/1.15, 400, letter-spacing -0.055em; the full stop is the warm accent.
2. **Workspace switcher**: 32px pill, 1px `--k-line`, `--k-surface`, 14px Poppins 500, glyph in `--k-accent-soft`, chevron 14px (see [Account menu](https://kwark.space/designSystem/components/account-menu.md)).
3. **Quiet action**: *Dailies*, text button with a film glyph, `--k-text-2`.
4. **Primary**: 36px, 0 14px, 6px corners, 12px Poppins 500, white on the home blue; a chevron because it opens a choice (film, series, franchise, import).
5. **Account**: 36px circle, 1px `--k-line`, glyph 16px in `--k-text-2`.
6. **Rule**: 1px `--k-line` under the bar, 26px above the shelf tabs.

### 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-soft` | #e8b58b | #e8b58b |
| `--k-font-display` | 'Raleway', 'Poppins', system-ui, sans-serif |  |
| `--k-fs-meta` | 12px |  |
| `--k-radius-control` | 6px |  |
| `--k-radius-pill` | 999px |  |
| `--k-home-action` | #1d6ce0 |  |
| `--k-on-home-action` | #ffffff |  |

## Code

### React

In the Kwark app: `import { HomeWorkspace } from '@/pages/Project/components/HomeWorkspace'`.

```tsx
// The bar is part of the library screen, not a shared component.
<HomeWorkspace projects={projects} view={view} onView={setView} … />
```

| Prop | Type | Notes |
|---|---|---|
| `projects` | `Project[]` | the shelf the bar sits above |
| `view` | `'GRID' \| 'LIST'` | drawn by the icon toggles below the bar |

### HTML and CSS

Works anywhere with `kwark.css`.

```html
<header class="kw-topbar">
  <span class="kw-topbar__mark"><span class="kw-topbar__dots" aria-hidden="true"><i></i><i></i><i></i></span><span>Kwark<em>.</em></span></span>
  <button class="kw-switcher" type="button" aria-haspopup="menu" aria-expanded="false"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><circle cx="12" cy="8" r="5"/><path d="M20 21a8 8 0 0 0-16 0"/></svg><span>My stories</span><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="m6 9 6 6 6-6"/></svg></button>
  <span class="kw-topbar__end">
    <button class="kw-text-button kw-topbar__quiet" 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"><rect x="2" y="2" width="20" height="20" rx="2.2"/><path d="M7 2v20M17 2v20M2 12h20M2 7h5M2 17h5M17 17h5M17 7h5"/></svg><span>Dailies</span></button>
    <button class="kw-topbar__new" 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="M5 12h14M12 5v14"/></svg><span>New project</span><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="m6 9 6 6 6-6"/></svg></button>
    <button class="kw-topbar__account" type="button" aria-label="Sign in"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><circle cx="12" cy="8" r="5"/><path d="M20 21a8 8 0 0 0-16 0"/></svg></button>
  </span>
</header>
```

## Accessibility

### Keyboard
| Key | Does |
|---|---|
| Tab | Wordmark (it goes Home), switcher, Dailies, New project, account, in reading order. |
| Enter / Space | Opens the switcher menu, the New project menu or the account panel. |
| Escape | Closes whichever menu is open and returns focus to its button. |

### ARIA
- The bar is a `<header>`; the switcher and New project carry `aria-haspopup="menu"` and `aria-expanded`.
- The account circle is named *Sign in* when signed out and *Your account* when signed in (AccountWidget).

## For agents

### Rules

- **Must** keep the bar to the wordmark, the switcher and at most three actions.
- **Never** use the home blue inside a project; there, act with the project accent.
- **Never** show the top bar inside a project; the breadcrumb is that line.
- **Always** name the account circle (*Sign in* or *Your account*); it has no visible word.

### AI readiness test

**Task:** Add a "Trash" entry to the Home top bar.

**Give the agent:** This page, the Account menu page, Decision 0021.

**Constraint:** The bar already holds Dailies, New project and Account.

**A reliable answer:**
- Puts Trash in the switcher or account menu instead of a fourth bar action
- Keeps New project the only blue
- Leaves the phone header unchanged
