Kwark. Design System
Open Kwark

Outline board

The Board view of the Outline: one column per section, cards in order, a story spine above.

ComponentsCreative toolsIn the app

Act 1

6 beats

Blank pages

Act 2

9 beats

The frame nobody shot

Act 1

2 beats
Beat 1

Blank pages

p. 1
Beat 2

The job

p. 6

Act 2

1 beat
Beat 14

The frame nobody shot

p. 41
<div class="kw-board">
  <section class="kw-column" style="--kw-act:var(--k-cal-writing)" aria-label="Act 1, 2 beats">
    <div class="kw-column__head"><h3>Act 1</h3><span class="kw-meta">2 beats</span></div>
    <article class="kw-index-card" aria-label="Beat 1, Blank pages"><div class="kw-index-card__top"><span>Beat 1</span></div><h3 class="kw-index-card__title">Blank pages</h3><div class="kw-index-card__foot"><span class="kw-index-card__landing">p. 1</span></div></article>
    <article class="kw-index-card" aria-label="Beat 2, The job"><div class="kw-index-card__top"><span>Beat 2</span></div><h3 class="kw-index-card__title">The job</h3><div class="kw-index-card__foot"><span class="kw-index-card__landing">p. 6</span></div></article>
    <button class="kw-column__add" type="button">New beat in Act 1</button>
  </section>
  <section class="kw-column" style="--kw-act:var(--k-cal-rehearsal)" aria-label="Act 2, 1 beat">
    <div class="kw-column__head"><h3>Act 2</h3><span class="kw-meta">1 beat</span></div>
    <article class="kw-index-card" data-tint="blue" aria-label="Beat 14, The frame nobody shot"><div class="kw-index-card__top"><span>Beat 14</span></div><h3 class="kw-index-card__title">The frame nobody shot</h3><div class="kw-index-card__foot"><span class="kw-index-card__landing">p. 41</span></div></article>
    <div class="kw-column__drop" aria-hidden="true"></div>
    <button class="kw-column__add" type="button">New beat in Act 2</button>
  </section>
</div>

When to use

When the writer wants to see the order of the whole story and move pieces between sections. It is one of the Outline’s views (Page, Cards, Board), each with its own address (Decision 0029).

When not to

  • For tasks or production status. Kwark is not a task tracker; a Board column of cards about work belongs in the production office, if at all.
  • On a phone held upright. Columns become one section at a time with a section chooser.

Anatomy in use

  • Columns are the writer’s sections, in their order, each topped with a 2px rule in the section’s colour (the same colour as its band in the Story spine).
  • Cards are Index cards.
  • New beat in Act 2 sits at the foot of each column and says where the beat will go.
  • Drop line: a 3px accent line shows where a dragged card will land. No glow.

Writing

Column heads are the section names the writer typed. Counts say “9 beats”, never “9 of 12 beats”, because Kwark does not know how many beats a section should have.

Act 2 with nine cards and New beat in Act 2 at the foot.

Do

A progress bar on each column, or a column named To do / Doing / Done.

Don’t

Anatomy

Board .kw-board (horizontal scroll), columns .kw-column 280px with --kw-act set to the section colour, .kw-column__head, cards, .kw-column__drop, .kw-column__add.

Tokens

Token Light Dark
--k-raise #f1f5f9 #252525
--k-line #e2e8f0 rgba(255, 255, 255, .1)
--k-radius-card 10px
--k-accent #98633f #98633f
--k-card-stock #f3eee3

React

In the Kwark app: import ColumnWritingWorkspace from '@/pages/Understanding/StructureBoardModule/components/ColumnWritingWorkspace'.

<ColumnWritingWorkspace view="board" />
Prop Type Notes
view 'page' | 'cards' | 'board' Outline views stay visible and addressable (Decision 0029)

HTML and CSS

Works anywhere with kwark.css.

<div class="kw-board">
  <section class="kw-column" style="--kw-act:var(--k-cal-writing)" aria-label="Act 1, 2 beats">
    <div class="kw-column__head"><h3>Act 1</h3><span class="kw-meta">2 beats</span></div>
    <article class="kw-index-card" aria-label="Beat 1, Blank pages"><div class="kw-index-card__top"><span>Beat 1</span></div><h3 class="kw-index-card__title">Blank pages</h3><div class="kw-index-card__foot"><span class="kw-index-card__landing">p. 1</span></div></article>
    <article class="kw-index-card" aria-label="Beat 2, The job"><div class="kw-index-card__top"><span>Beat 2</span></div><h3 class="kw-index-card__title">The job</h3><div class="kw-index-card__foot"><span class="kw-index-card__landing">p. 6</span></div></article>
    <button class="kw-column__add" type="button">New beat in Act 1</button>
  </section>
  <section class="kw-column" style="--kw-act:var(--k-cal-rehearsal)" aria-label="Act 2, 1 beat">
    <div class="kw-column__head"><h3>Act 2</h3><span class="kw-meta">1 beat</span></div>
    <article class="kw-index-card" data-tint="blue" aria-label="Beat 14, The frame nobody shot"><div class="kw-index-card__top"><span>Beat 14</span></div><h3 class="kw-index-card__title">The frame nobody shot</h3><div class="kw-index-card__foot"><span class="kw-index-card__landing">p. 41</span></div></article>
    <div class="kw-column__drop" aria-hidden="true"></div>
    <button class="kw-column__add" type="button">New beat in Act 2</button>
  </section>
</div>
  • Each column is a <section> named with its title and count.
  • Keyboard: Tab reaches each card; the card’s ⋯ menu offers Move to Act 2, position 3. Announce the move (“Beat 14 moved to Act 2, position 3”).
  • The board scrolls sideways with the keyboard when focus moves off-screen.

Rules

  • Must use the writer’s sections as columns and never invent stages.
  • Always provide a keyboard move as well as drag.
  • Never show progress or completion against an expected number of beats.

AI readiness test

Task. Show the Outline’s Board view for Blank Pages with three acts.

Give the agent. Outline board, Index card, Story spine, Decision 0029.

Constraint. The view needs its own address so it can be shared.

A reliable answer

  • Columns are the writer’s acts
  • Cards are Index cards
  • Story spine above the board
  • URL includes the view
  • Keyboard Move to…

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

Open .mdllms.txt
Loading…