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

Source: https://kwark.space/designSystem/components/project-cover

## Usage

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

**Do:** A ⋯ at the poster's corner, *Remove cover* with Undo.

**Don't:** An *Add cover* link under the poster breaking the grid.

## Style

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

## Code

### React

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

```tsx
<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`.

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

## Accessibility

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

## For agents

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