# Research card

> A piece of research on a writer's board: its kind, title, a few lines, and whether it is private or shared by someone.

Source: https://kwark.space/designSystem/components/research-card

## Usage

### When to use
In Research, which is a personal workspace for everyone with research access. A writer's unshared items are private to them, even from the project owner; sharing a board or notebook puts it under **Shared by team**, tagged *Shared by {name}*, read-only for others.

### When not to
- For the writer's story notes on a character page. Character notes reuse research items but show on the character (Decision 0028).
- For files without context. A research item has a title and a reason.

### Variants
| State | Shows |
|---|---|
| Private | *Private to you* in the meta line |
| Shared by you | *Shared with the team* |
| Shared by someone | *Shared by Arjun*, read-only, on `--k-bg` |
| Pinned | Pin glyph at top right |

### Writing
Privacy is stated plainly on the card, every time. Never imply the owner can see a collaborator's private research: they cannot.

**Do:** *Shared by Arjun · Read only* on a notebook in Shared by team.

**Don't:** A private card with no label, so the writer cannot tell who can see it.

## Style

### Anatomy

Card min-height 168px, 19px padding, 7px corners. Kind: 26px icon tile and the kind in sentence case. Title Raleway 600 17px. Body 12px, three lines. Meta pinned to the foot. (The app uses 8–10px type here; the system raises it to the 12px floor.)

### Tokens

| Token | Light | Dark |
|---|---|---|
| `--k-surface` | #ffffff | #1a1a1a |
| `--k-bg` | #f8fafc | #191919 |
| `--k-line` | #e2e8f0 | rgba(255, 255, 255, .1) |
| `--k-raise` | #f1f5f9 | #252525 |
| `--k-text-2` | #5b6779 | #9ca3af |
| `--k-fs-card-title` | 17px |  |
| `--k-font-display` | 'Raleway', 'Poppins', system-ui, sans-serif |  |

## Code

### React

In the Kwark app: `// pages/Understanding/StoryResearch/index.tsx (.research-card)`.

```tsx
// Private items live in research_private_items; shared ones in story_research_items.
// Sharing a board moves it under "Shared by team" for everyone, read-only.
```

| Prop | Type | Notes |
|---|---|---|
| `visibility` | `'private' \| 'team'` | decides the collection and the label |

### HTML and CSS

Works anywhere with `kwark.css`.

```html
<div class="kw-research-grid">
  <a class="kw-research-card" href="#item-1">
    <span class="kw-research-card__top"><span class="kw-research-card__kind"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><rect x="3" y="3" width="18" height="18" rx="2"/><circle cx="9" cy="9" r="2"/><path d="m21 15-5-5L5 21"/></svg> Image</span><span><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M12 17v5M9 10.8V5h6v5.8l2 3.2H7z"/></svg></span></span>
    <h3>Edit suites in the 1990s</h3>
    <p>Steenbeck tables, trim bins, grease pencil on the film. Arjun's photos from the Mumbai lab.</p>
    <span class="kw-research-card__meta"><span>Private to you</span><span>Updated today</span></span>
  </a>
  <a class="kw-research-card" href="#item-2" data-readonly>
    <span class="kw-research-card__top"><span class="kw-research-card__kind"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M4 19.5A2.5 2.5 0 0 1 6.5 17H20V3H6.5A2.5 2.5 0 0 0 4 5.5z"/></svg> Notebook</span></span>
    <h3>Camera reports, explained</h3>
    <p>What a 2nd AC writes for each roll, and why a missing roll number matters.</p>
    <span class="kw-research-card__meta"><span class="kw-research-card__shared"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M16 21v-2a4 4 0 0 0-4-4H6a4 4 0 0 0-4 4v2"/><circle cx="9" cy="7" r="4"/><path d="M22 21v-2a4 4 0 0 0-3-3.9M16 3.1a4 4 0 0 1 0 7.8"/></svg> Shared by Arjun</span><span>Read only</span></span>
  </a>
</div>
```

## Accessibility

- The whole card is one link; the privacy line is part of its text, so it is announced.
- Read-only cards say so in words.

## For agents

### Rules

- **Must** state privacy on every research card.
- **Never** show a collaborator's private research to anyone else, including the owner.
- **Always** mark shared items with who shared them.

### AI readiness test

**Task:** Show research shared by others beside the writer's own.

**Give the agent:** Research card, Sharing and roles, Collaboration.

**Constraint:** Shared items are read-only for everyone but the sharer.

**A reliable answer:**
- Two groups, "Yours" and "Shared by team"
- Each shared card names the sharer
- Read only stated
- Private cards say Private to you
