Kwark. Design System
Open Kwark
<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.

Do

A private card with no label, so the writer cannot tell who can see it.

Don’t

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

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

Open .mdllms.txt
Loading…