Kwark. Design System
Open Kwark

Project cover

The poster a project wears at 2:3, with its one ⋯ cover menu inside the poster, and a designed placeholder when there is no cover.

ComponentsMediaIn the app
Blank PagesFeature film · Draft 3
<div class="kw-cover-tile">
  <div class="kw-cover kw-cover--empty">
    <a class="kw-cover__art" href="#blank-pages" aria-label="Open Blank Pages"><span class="kw-cover__edition">Feature film</span><i class="kw-cover__sun" aria-hidden="true"></i><i class="kw-cover__hill" aria-hidden="true"></i><span class="kw-cover__title">Blank Pages</span><span class="kw-cover__caption">A screenplay by Mira Rao</span></a>
    <button class="kw-cover__menu" type="button" aria-haspopup="menu" aria-label="Cover actions for Blank Pages"><span><svg viewBox="0 0 24 24" fill="currentColor" aria-hidden="true"><circle cx="5" cy="12" r="1.8"/><circle cx="12" cy="12" r="1.8"/><circle cx="19" cy="12" r="1.8"/></svg></span></button>
  </div>
  <strong>Blank Pages</strong><small>Feature film · Draft 3</small>
</div>
<div class="kw-menu" role="menu" aria-label="Cover actions"><button class="kw-menu-item" type="button" role="menuitem">Change cover…</button><button class="kw-menu-item" type="button" role="menuitem">Remove cover</button></div>

When to use

In the project library and on the project overview. The poster is the project’s face; changing it should feel like touching the poster, not finding a link (Decision 0017).

Cover actions

One three-dots button at the poster’s top right, the same on mouse, keyboard and touch: a 44px target around a 28px disc. Its menu: Add cover or Change cover…, and Remove cover only when a custom cover exists. Remove has no dialog; the toast says Cover removed with Undo. Nothing sits under the poster.

Placeholder

A story with no cover shows the designed placeholder with the project’s name, never a blank or black rectangle. Twenty illustrations are available (Golden hour, Eclipse, Archways, Orbit, Night windows…); by default the art follows the format. The system’s specimen draws the placeholder flat; the app’s illustrations are content and may carry their own light.

When not to

  • A “Cover ▾” pill on the poster (rejected as unprofessional).
  • A scrim of buttons on hover (replaced in 0017).

Writing

The edition line is sentence case on the system: Feature film. (The app sets it in spaced capitals; the system’s writing rule forbids all-caps labels.)

A ⋯ at the poster’s corner, Remove cover with Undo.

Do

An Add cover link under the poster breaking the grid.

Don’t

Anatomy

Poster 2:3, 12px corners (10px placeholder), 1px line. Placeholder: 11% padding, a hairline inner frame at 5%, edition with an 18px rule, title in Georgia at 13cqw, caption over a hairline. Menu 44px target, 28px disc at 80% page colour.

Tokens

Token Light Dark
--k-cover-bg #22211f
--k-cover-ink #eee7db
--k-cover-muted #c3b8a5
--k-cover-rule #c4ad83
--k-cover-frame rgba(216, 199, 167, .1)
--k-tap 44px
--k-bg #f8fafc #191919

React

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

<div className="project-overview__poster">
  {project.cover ? <img src={project.cover} alt="" /> : <ProjectCoverPlaceholder project={project} />}
  <button className="project-overview__cover-menu" aria-label={`Cover actions for ${project.name}`}>…</button>
</div>
Prop Type Notes
project { name, type?, format?, coverArt? } the art follows the format unless chosen
decorative boolean hides it from assistive tech when the title is beside it
hero boolean hides title and caption for the hero

HTML and CSS

Works anywhere with kwark.css.

<div class="kw-cover-tile">
  <div class="kw-cover kw-cover--empty">
    <a class="kw-cover__art" href="#blank-pages" aria-label="Open Blank Pages"><span class="kw-cover__edition">Feature film</span><i class="kw-cover__sun" aria-hidden="true"></i><i class="kw-cover__hill" aria-hidden="true"></i><span class="kw-cover__title">Blank Pages</span><span class="kw-cover__caption">A screenplay by Mira Rao</span></a>
    <button class="kw-cover__menu" type="button" aria-haspopup="menu" aria-label="Cover actions for Blank Pages"><span><svg viewBox="0 0 24 24" fill="currentColor" aria-hidden="true"><circle cx="5" cy="12" r="1.8"/><circle cx="12" cy="12" r="1.8"/><circle cx="19" cy="12" r="1.8"/></svg></span></button>
  </div>
  <strong>Blank Pages</strong><small>Feature film · Draft 3</small>
</div>
<div class="kw-menu" role="menu" aria-label="Cover actions"><button class="kw-menu-item" type="button" role="menuitem">Change cover…</button><button class="kw-menu-item" type="button" role="menuitem">Remove cover</button></div>
  • The poster link and the menu button are siblings.
  • The button is named “Cover actions for {project}”.
  • With the title shown beside the poster, mark the placeholder decorative.

Rules

  • Must put cover actions in one ⋯ button inside the poster (Decision 0017).
  • Never show a blank or black rectangle; use the placeholder with the name.
  • Must remove covers with Undo, not a confirmation dialog.

AI readiness test

Task. Show projects in the phone library.

Give the agent. Project cover, Decision 0017, Decision 0021.

Constraint. Some projects have no cover.

A reliable answer

  • Placeholder with the project name
  • ⋯ in the poster corner, 44px target
  • Remove with Undo
  • Title shown beside or under the poster

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

Open .mdllms.txt
Loading…