Kwark. Design System
Open Kwark

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.

ComponentsNavigationIn the app
Kwark.
Kwark.
<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>

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.

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).
  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

React

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

// 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.

<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>

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).

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

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

Open .mdllms.txt
Loading…