<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>
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.
Shared by Arjun · Read only on a notebook in Shared by team.
A private card with no label, so the writer cannot tell who can see it.
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 |
React
In the Kwark app: // pages/Understanding/StoryResearch/index.tsx (.research-card).
// 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.
<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>
- 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.
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