<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.
An Add cover link under the poster breaking the grid.
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