Attention budgets

docs/DESIGN.md holds the five rules of attention. This is how they are measured.

bun test test/attention.test.ts renders each main page (signed in, on a small seeded forge) and counts what a reader sees on first view at 390 px and 1280 px: words, text blocks and distinct colours (src/measure/attention.ts). It prints each page's numbers against its budget in docs/design/attention-budget.json, and fails when any number is over.

rewrites the file from today's numbers. Lowering is free.

and the classes the stylesheet hides at that width (.hide-sm, .hide-lg, .keyhint, .crumbs) are not seen. Layout is not simulated, so the whole visible <main> counts as first view, and today the two widths agree. A colour is a tone (data-variant, data-tone, data-state, data-status) other than the neutral ones, or a colour written in a style.

Baseline (words / blocks / colours)

Page390 px1280 px
home95 / 20 / 295 / 20 / 2
repository116 / 18 / 2116 / 18 / 2
app116 / 18 / 2116 / 18 / 2
pull141 / 24 / 4141 / 24 / 4
issue72 / 19 / 272 / 19 / 2
issues list30 / 7 / 230 / 7 / 2
pulls list24 / 6 / 124 / 6 / 1
runs38 / 8 / 138 / 8 / 1
run34 / 11 / 334 / 11 / 3
settings140 / 32 / 1140 / 32 / 1
search42 / 3 / 142 / 3 / 1
search results (/search?q=forge)58 / 5 / 158 / 5 / 1
map68 / 6 / 668 / 6 / 6
flow102 / 9 / 1102 / 9 / 1
system212 / 65 / 0212 / 65 / 0

/flow and /system are sampled pages; their entries are the empty state the test forge has (nothing seeded, nothing waited for), and say so in the entry's note. /system draws the host it runs on, so the test hands it an empty machine reading (useLive) and fixed cap sentences; a live /system is larger.

App page, calmed (#10299)

A new app that has not run, and has shipped nothing, shows only its progress: the state line (docs/features/onboarding-line.md), the box to tell the crew, and Now (src/web/studio/fresh.ts judges it). Past that, the empty This week and Crew cards are gone, and the page's second link row (Map, Issues, Pull requests) is gone because the head's tabs already hold them. Before, on the seeded new app: 197 words / 29 blocks (over its 189 / 28 budget on main); after: 116 / 18.

↑↓ navigate ↵ open ⌘↵ its app esc close

Keyboard shortcuts

Docs