# Outline board

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

Source: https://kwark.space/designSystem/components/outline-board

## Usage

### 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](https://kwark.space/designSystem/components/board-column.md) 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](https://kwark.space/designSystem/components/story-spine.md)).
- **Cards** are [Index cards](https://kwark.space/designSystem/components/index-card.md).
- **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.

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

**Don't:** A progress bar on each column, or a column named *To do / Doing / Done*.

## Style

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

## Code

### React

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

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

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

## Accessibility

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

## For agents

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