Skip to content

Field Notebook redesign - #227

Merged
acrosman merged 95 commits into
mainfrom
design/field-notebook
Oct 3, 2026
Merged

acrosman merged 95 commits into
mainfrom
design/field-notebook

Conversation

@acrosman

@acrosman acrosman commented Oct 3, 2026 •

Copy link
Copy Markdown
Owner

The Field Notebook redesign: the whole app restyled as a naturalist's notebook, in ten reviewed phases. Every phase was merged into design/field-notebook by the maintainer; this PR brings that branch to main.

Two PRs still land on this branch first: #226 (phase 10 wrap-up fixes) and #207 (README screenshots). This PR updates automatically as they merge, and CI reruns.

The motif

  • Palette: warm paper backgrounds, ink-green text, and a clay accent for eyebrow labels and list markers, with hairline rules and soft warm shadows.
  • Type: Fraunces sets names and numbers: the wordmark, game titles, "Session Ended", tutorial titles, stats, and results. Atkinson Hyperlegible Next sets everything meant for reading. Both are bundled under OFL, because the CSP blocks font CDNs.
  • Pen blue is kept for focus rings, selections, and the tutorial marker; forest is for primary actions.
  • Stimuli are untouched. Everything a player sees during a trial uses frozen --stim-* tokens or game-local literals, so difficulty and saved thresholds stay comparable. A style probe of 28 stimulus surfaces across 8 games matches the pre-redesign baseline exactly.

Before and after

Screenshots are in the local workspace, not uploaded: docs/plans/field-notebook/shots/baseline/ (before) and docs/plans/field-notebook/shots/10/ (after). Each folder has the menu, History, and a contact sheet per game (welcome, play, end, tutorial, coach). After #207 merges, the README shows four real screenshots.

  • Menu
    • Before: a dark header bar, white cards on light grey with stats as one pipe-separated line ("Top Score: 10 | Max Level: 3 | …"), and blue "Play " buttons.
    • After: a paper masthead ("Brain Speed" in Fraunces with an "Exercises" eyebrow), "Choose an exercise", and specimen-plate cards: framed artwork, a Fraunces title, a stats ledger, and a full-width forest "Play →".
  • Today strip and History
    • Before: a light bar with a dark History button, and a plain white modal with a blue line chart.
    • After: a sunken ledger strip, and a paper History modal with a warm scrim, a hairline table, and a 10-color chart palette that all clears 5.4:1. The old total-bar grey was below 3:1.
  • Game chrome
    • Before: each game styled its own stats, panels, and buttons, and "End Game"/"Return to Menu" were red.
    • After, in all ten games:
      • the shared stats strip (eyebrow label over a Fraunces value);
      • paper welcome cards with clay step markers and key-cap kbd;
      • a results ledger with dotted leaders;
      • forest primary and outlined-ink secondary buttons (nothing non-destructive is red now);
      • a sunken trend panel;
      • notebook-key response controls with a 2px bottom edge, and flat, readable disabled keys.
  • Tutorials: a paper overlay with a clay step eyebrow and Fraunces titles. All ten tutorial screenshots were retaken to one standard: a 1280×880 window, clipped to the game area, with the stimulus visible. Callouts use five shared hues with a white halo, and captions list every stat they frame.
  • Accessibility

Phase PRs

Phase PR
01b README previews #207 (open; real screenshots added in phase 10)
02 Foundation: stimulus freeze, fonts, tokens, masthead #208
03 Shell: cards, ledger strip, History #209
04 Shared game UI #210
05 Fast Piggie, Card Rat #212
05b Tutorial overlay fit (#211) #213
06 Otter Stop, High Speed Memory #214
07 Orbit Sprite Memory, Object Track #215
08 Fine Tuning, Sound Sweep #216
09 Directional Processing, Field of View #218
10 Wrap-up fixes #226 (open)

Follow-up issues

Closes #211.

Verification (local, on design/fn-10-wrap-up, which is this branch plus #226)

  • Lint: pass
  • Tests: Test Suites: 54 passed, 54 total / Tests: 2115 passed, 2115 total
  • Coverage: All files 99.27 stmts / 86.24 branches / 100 funcs / 99.73 lines (thresholds met)
  • Probe diff against the pre-redesign baseline: No stimulus changes.
  • Contrast --strict: 67 pass, 0 fail, 0 skip
  • Packaged build (npm run package): both fonts load, with no CSP violations or console errors
  • Keyboard walk: every focus stop shows a visible outline
  • npm audit: 4 high in the Electron Forge DMG chain. These are unchanged from main; package.json and the lockfile are not modified.

CI runs on this PR; see its checks.

Signed: Claude Code for Aaron Crosman

🤖 Generated with Claude Code

acrosman and others added 30 commits October 1, 2026 21:24
Several games styled their stimulus surfaces (Field of View cells and
mask, Otter Stop's stimulus panel, the Orbit board, revealed High Speed
Memory cards, the Fast Piggie wheel and its flash keyframes, the Object
Track arena frame, the Directional Processing canvas) with general
theme tokens. Retuning the theme would then silently change what
players see during a trial, which changes difficulty and makes saved
thresholds incomparable with earlier sessions.

Add a "Stimulus surfaces (never themed)" group of --stim-* tokens,
holding today's exact values (including corner radii), and point those
rules at them. Rendered output is unchanged.

Signed: Claude Code for Aaron Crosman

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The Field Notebook design pairs Fraunces (display: titles and large
numbers) with Atkinson Hyperlegible Next (all reading text), which the
Braille Institute designed for low-vision readers.

The CSP (default-src 'self') blocks font CDNs, so ship the variable
woff2 files in app/fonts/, split into latin and latin-ext with
unicode-range so only the needed subset loads (340 KB in total, mostly
the latin-ext files that most pages never fetch). Both fonts are SIL OFL
1.1; their licenses are included. Files come from the
@fontsource-variable 5.3.0 packages; no npm dependency is added.

fonts.css is imported first. Nothing uses the families yet; the
following commits switch the UI over.

Signed: Claude Code for Aaron Crosman

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Replace the stock grey-and-blue palette with the Field Notebook one:
paper backgrounds, forest-ink text, a clay accent, a pen-blue focus
ring, forest primary actions, and a danger red kept for destructive
actions only. Existing token names keep their roles, so every
stylesheet picks up the new palette without edits.

Add the tokens the coming shell and game changes need: --accent,
--bg-sunken, --btn-secondary-*, --font-display, --font-body,
--radius-xl, --shadow-1/2, and a --space-1..6 scale. Radii grow to
6/10/14px. Group the colour tokens so a dark theme can override only
that block later.

Every text pairing meets WCAG AA and every control boundary meets 3:1;
ratios are in the comments. This also fixes four pairings that failed
before (hint text on the body, control borders, and the chart's total
bar). Stimulus surfaces are unaffected: they use the --stim-* tokens
from the previous commit.

Signed: Claude Code for Aaron Crosman

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- Body text uses Atkinson Hyperlegible Next at 17px on the paper
  background.
- The dark header bar becomes a paper masthead: a Fraunces "Brain
  Speed" wordmark with an "Exercises" eyebrow over a hairline rule. The
  h1's accessible name is still "Brain Speed Exercises".
- The empty game-selection nav stays in the DOM but no longer draws a
  dark strip.
- main is centered with a 1200px maximum width.
- New global .eyebrow utility and key-cap kbd style.
- Hover and press transitions are switched off under
  prefers-reduced-motion.

Signed: Claude Code for Aaron Crosman

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Add fonts.css to the import order and styles table, describe the new
token groups, and record the rule that --stim-* tokens are frozen and
stimulus surfaces never use theme tokens.

Signed: Claude Code for Aaron Crosman

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The card's stats were one "Top Score: 16 | Max Level: 5 | ..." string
whose aria-label repeated the same text. Render them instead as a
<dl class="game-high-score game-card__stats"> with one term/value pair
per stat (Top score, Max level, Fastest, Today), so the design can show
an eyebrow label over a large value and screen readers announce each
label with its value. The list itself is labelled "Stats for <game>".

Wrap the thumbnail in a .game-card__frame (it clips the hover zoom and
draws the hairline frame), and render the Play button as "Play →" with
the arrow aria-hidden; its accessible name stays "Play <game>".

Signed: Claude Code for Aaron Crosman

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- Cards become specimen plates: an inset, hairline-framed thumbnail, a
  Fraunces title, the stats list as eyebrow labels over tabular
  values, and a full-width forest Play button. Hover lifts the card and
  zooms the image slightly (off under prefers-reduced-motion); keyboard
  focus still rings the whole card.
- A "Choose an exercise" eyebrow sits above the grid, drawn with CSS
  and hidden from screen readers (the section is already labelled).
- The play-time bar becomes a sunken ledger strip: a "Today's total"
  eyebrow, the time in Fraunces, and an outlined View History button.

Signed: Claude Code for Aaron Crosman

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Warm ink scrim (new --scrim token), a 20px-radius panel, a Fraunces
title, an outlined danger Clear History button and a 44px close
button, a filled danger confirm on the warning strip, each day's bar
chart on its own paper card with a Fraunces date, and a table with a
sunken header row and tabular numbers. Chart and table structure are
unchanged.

Table headers stay in sentence case so long game names wrap instead of
widening the table past the panel.

Signed: Claude Code for Aaron Crosman

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Describe the card's frame, stats list, and Play button in
app/components/CLAUDE.md, and the plate, ledger strip, and modal
backdrop in the app/CLAUDE.md styles table.

Signed: Claude Code for Aaron Crosman

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Field Notebook 03: shell (cards, ledger strip, History)
Phases 5-9 move each game's hard-coded answer feedback, selected-state,
and tutorial callout colours onto shared tokens, and the trend chart
line needs its own colour now that the chart sits on card paper. Adding
the tokens first lets every pair be contrast-checked before any game
uses them. Callouts keep their old hue families because tutorial
captions name them, and the white halo keeps them visible on dark
boards.

Signed: Claude Code for Aaron Crosman

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Game titles are the plate names of the notebook, so they share the
display face with the menu cards and the History title. One rule on
#game-container > section > h2 covers all ten games, since each root
section holds its title as a direct child. It sets no colour, so games
keep their own title colours until their chrome passes.

Signed: Claude Code for Aaron Crosman

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The global kbd style in base.css already draws the notebook key cap, so
the older monospace .game-welcome kbd override only hid it. The tutorial
overlay backdrop now uses the same warm --scrim as the History modal
instead of plain black.

Signed: Claude Code for Aaron Crosman

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The How to Play panel is the first thing a player reads in every game.
It now sits on card paper with the soft warm shadow, and its "How to
Play" heading becomes a clay eyebrow label with matching clay list
markers, the same treatment as labels in the shell. The h3 stays, so
the heading outline is unchanged.

Signed: Claude Code for Aaron Crosman

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The secondary game button was a red fill, which read as destructive on
End Game, Return to Menu, and Replay Tutorial in every game, though
none of them is. It is now the outlined ink button the shell uses, and
hovering also darkens its outline so the change shows on card panels.
The primary button keeps its forest fill and gains a 2px press on
:active. Tutorial overlay and coach buttons mirror both variants.

All of these now set the body font, since buttons do not inherit it,
and their transitions join the reduced-motion list.

Signed: Claude Code for Aaron Crosman

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The end panel is where players read their numbers, so it now matches
the notebook's ledger look. "Session Ended" is set in Fraunces, each
result label is a clay eyebrow, a dotted leader runs to the value, and
the values use Fraunces with tabular figures so they line up. The
results token aliases now point at the accent and the control-boundary
colour for the leader.

Signed: Claude Code for Aaron Crosman

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The in-game trend chart used a cool blue-grey gradient left over from
the old theme. It now sits on card paper with hairline rules inside the
sunken trend panel. The line colour moves to the new --trend-line token
through the chart's color property; every game's polyline already uses
stroke="currentColor", so no markup changes.

Signed: Claude Code for Aaron Crosman

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Tutorial panels now match the History modal: card paper, the large
corner radius, and the warm deep shadow. The step counter and the
coach's round label become clay eyebrows, and step titles use Fraunces.
The coach's left rule turns clay, so pen blue is kept for the practice
marker alone, which keeps its white halo.

Signed: Claude Code for Aaron Crosman

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Every game builds the same stats row (live stats plus a session timer)
and styles it separately. .game-hud, .game-hud__live, and
.game-hud__stat give them one notebook strip: sunken, hairline
dividers, an eyebrow label over a Fraunces tabular value, and the timer
pushed right. It works with the existing "Label: <strong>value</strong>
unit" markup, so games opt in by adding classes only, which keeps their
IDs, aria-live wrappers, and tests intact. It wraps cleanly on narrow
widths.

.tutorial-callout adds the white halo the callout tokens assume, so
games can opt their screenshot callouts in during their chrome passes.

Signed: Claude Code for Aaron Crosman

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
New games start from _template, so it should show the shared pieces
rather than the per-game copies they replace. Its stats row now carries
the .game-hud classes alongside its own, and its stylesheet drops the
stats layout and the title size, weight, and font-family that the
shared rules now set.

Signed: Claude Code for Aaron Crosman

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Records what this phase changed so games written later follow it. The
games guide gains the stimulus rule (stimulus surfaces use --stim-*
tokens or local literals, never theme tokens, and each game lists its
own), the HUD markup, the outlined non-destructive secondary button,
and the feedback, selection, and callout tokens with the callout halo.
The app guide gains the design motif and the token groups, and the
components guide gains the tutorial screenshot standard.

Signed: Claude Code for Aaron Crosman

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The hairline rules behind the trend line were a step too far for the
design and competed with the line itself. The chart area is now plain
card paper inside the sunken trend panel.

Signed: Claude Code for Aaron Crosman

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Field Notebook 02: foundation (stimulus freeze, fonts, tokens, masthead)
Adds the .game-hud classes next to Fast Piggie's own stats classes, so
the round, score, display time, and session timer read as a notebook
strip like the rest of the app. The old classes, IDs, and aria-live
wrapper stay for index.js and the tests; only the duplicate stats
layout CSS is removed, plus a margin so the strip does not touch the
wheel.

Signed: Claude Code for Aaron Crosman

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The shared #game-container > section > h2 rule now sets every game
title's typeface, size, and weight, and the base reset already zeroes
its margin, so Fast Piggie's .fast-piggie h2 rule was dead code.

Signed: Claude Code for Aaron Crosman

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The screenshot slide's three callouts move from hard-coded blue, green,
and orange to --callout-1, -2, and -3, which keep the same hues the
caption names. Each callout gains the shared .tutorial-callout halo.
The alt text and caption now describe the screen as it is: the stats
strip includes the session time, and the trend chart sits between the
wheel and the End Game button.

Signed: Claude Code for Aaron Crosman

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The old screenshot showed the previous design and an arbitrary crop.
The new one follows the shared standard: a 1280x880 window, clipped to
#fp-game-area, taken while the guinea pigs are on the wheel, as the
caption describes. The callout boxes are remeasured as percentages of
that clip.

The game area is tall and narrow, so the slide ran past the bottom of
an 880px window and pushed its title off the top. The image is now
capped to the space the slide's text leaves, and its wrapper shrinks
to the image so the callouts stay aligned.

Signed: Claude Code for Aaron Crosman

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
app/games/CLAUDE.md now asks each game to list its stimulus surfaces.
Fast Piggie's are the canvas and everything drawn on it, including the
wedge highlights and answer fills, plus the flash overlay. Those stay
game-local literals even though some carry correct/wrong meaning,
because they are drawn on the stimulus. The tutorial notes record the
callout tokens, when the screenshot is taken, and the image height cap.

Signed: Claude Code for Aaron Crosman

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Adds the .game-hud classes to Card Rat's stats row, so its seven live
stats and the session timer read as the shared notebook strip. The
.card-rat__stats classes, IDs, and aria-live wrapper stay; only the
duplicate stats layout CSS is removed. The game area's existing gap
already spaces the strip from the cards.

Signed: Claude Code for Aaron Crosman

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
acrosman and others added 23 commits October 2, 2026 22:26
Sound Sweep drew its stats as a plain flex row. The shared .game-hud strip
gives every game the same sunken stats bar with eyebrow labels over
Fraunces values. The game's own classes, IDs, and aria-live wrapper stay,
since index.js and the tests use them; only the duplicate layout CSS goes.

Signed: Claude Code for Aaron Crosman

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This mirrors Fine Tuning. The game area becomes the same card as the
welcome panel, and the end panel is left bare so its results ledger is the
only card. The four sequence buttons and Replay become notebook keys: card
paper, a control-boundary edge, and a 2px bottom edge that flattens when
pressed. A disabled key lies flat on sunken paper with readable text
instead of fading to 45% opacity while the sweeps play. The sequence keys
keep their 2px border and padding, so the timed hit area does not shrink,
and their number labels use the global key cap at 13px. Replay is a quiet
outlined icon button.

.ss-btn--primary keeps its forest tokens and gains the forest hover and
press states, so the key's hover fill never lands under its light text.
.ss-btn--secondary points at the outlined ink tokens. Neither class has a
user yet; both stay as separate classes. The small-screen block only
tightens the sequence keys and still fits.

Signed: Claude Code for Aaron Crosman

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The screenshot slide's four highlight boxes used Material colors. They now
use --callout-1 to --callout-4 in the same hues the caption names (blue,
green, orange, purple), and the shared .tutorial-callout class adds the
white halo. The alt text calls the stats a strip, as it now is.

Signed: Claude Code for Aaron Crosman

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The old screenshot showed the pre-notebook game area at a 1512px window.
The new one follows the screenshot standard (1280x880 window, clipped to
#ss-game-area) after five rounds, with the next sweeps played and the
sequence keys enabled, so the trend chart has a line. The four highlight
boxes are remeasured from the elements the caption names.

Signed: Claude Code for Aaron Crosman

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Sound Sweep's CLAUDE.md gains the "Screen and stimulus surfaces" section
that every game needs: the shared HUD, which panel draws which card, the
notebook keys and their disabled state, the unused primary and secondary
button classes, and the note that an auditory game has no visual stimulus
surfaces. The tutorial notes name each callout's color token and the new
screenshot frame.

Signed: Claude Code for Aaron Crosman

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Field Notebook 08: Games, part 4 (fine-tuning, sound-sweep)
Directional Processing drew its stats as a plain flex row. The shared
.game-hud strip gives every game the same sunken stats bar with eyebrow
labels over Fraunces values. The game's own classes, IDs, and aria-live
wrapper stay, since index.js and the tests use them; only the duplicate
layout CSS goes.

Signed: Claude Code for Aaron Crosman

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
After a miss, the correct direction button turned a bright mint green from
its own literals. It now uses the shared --feedback-correct-* tokens, as the
other games' answer feedback does. The --selected state uses --selected-bg
with a --focus-ring border, the shared look for a chosen answer.

Signed: Claude Code for Aaron Crosman

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The game area becomes the same card as the welcome panel, and the end panel
is left bare so its results ledger is the only card.

The direction pad becomes notebook keys, the same keys Fine Tuning and Sound
Sweep use: card paper, a control-boundary edge, and a 2px bottom edge that
flattens when pressed. They keep their fixed 100x56 size, the timed hit area.
A disabled key now lies flat on sunken paper with --text-subtle labels
(4.8:1) instead of fading to 45% opacity, which left the labels near 2.6:1.
The correct-answer hint outranks the disabled look, since the pad is
disabled when it shows, so the hint is now at full strength.

The unused .dp-btn classes follow Sound Sweep's: a notebook key, a forest
primary with its own hover and press, and an outlined ink secondary.

Signed: Claude Code for Aaron Crosman

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The screenshot slide's highlight boxes set Material border colors and
matching tints by hand. They now set only `color` from --callout-1 to
--callout-3 (blue, green, orange, the hues the caption names) and derive
the border and tint from it, as the other games do. The shared
.tutorial-callout class adds the white halo.

The blue box covers the whole stats strip, so the caption now lists every
stat in it, including round and session time, and uses the "outlined in"
wording of the other games' captions. The alt text calls the stats a strip.

Signed: Claude Code for Aaron Crosman

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The old screenshot showed the pre-notebook game area. The new one follows
the screenshot standard (1280x880 window, clipped to #dp-game-area) and
catches the moving pattern during its 500 ms level 1 display, with the
direction pad disabled as it is while the pattern shows. The three
highlight boxes are remeasured from the stats strip, the stage, and the
direction pad. The slide fits an 880px window without an image cap.

Signed: Claude Code for Aaron Crosman

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Directional Processing's CLAUDE.md gains the "Screen and stimulus surfaces"
section that every game needs: the shared HUD, which panel draws which
card, the notebook keys with their disabled, correct, and selected states,
and the frozen stimulus surfaces (the grey canvas, the Gabor patch and mask,
and the flash overlays). The tutorial notes name each callout's color token
and the new screenshot frame.

Signed: Claude Code for Aaron Crosman

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Field of View drew its stats as a plain flex row. The shared .game-hud
strip gives every game the same sunken stats bar with eyebrow labels over
Fraunces values, with each "ms" unit on the value line. The game's own
classes, IDs, and aria-live wrapper stay, since index.js and the tests use
them; only the duplicate layout CSS goes.

The help line under the strip now sets the gap on both sides and reads in
--text-muted, as a hint under the stats.

Signed: Claude Code for Aaron Crosman

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The chosen location square and the chosen board cell used a hand-picked
light blue (#cfe8ff) with a forest border. They now use --selected-bg with
a --focus-ring border, the shared look for a chosen answer.

The pressed kitten button had a forest border and a glow from a raw blue
(rgba(15, 74, 163, ...)); both now come from --focus-ring, so the ring and
glow match. A board cell chosen over the mask gets a pen-blue wash at the
old 35% alpha, ringed in --selected-bg, which stays legible on the busy
field image. The translucent white response cells over the mask are
unchanged.

Signed: Claude Code for Aaron Crosman

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The game area becomes the same card as the welcome panel, and the end panel
is left bare so its results ledger is the only card.

The kitten buttons and the toy-location squares become notebook keys, the
same keys the other games use: card paper, a control-boundary edge, and a
2px bottom edge that flattens when pressed. The kitten buttons keep their
fixed 120x120 size, the timed hit area. The location squares sit in a
sunken tray; it used the board's grey (#aeb4bb), but the tray is chrome, so
it takes the theme. The center square, which cannot be chosen, lies flat
in the tray. The board, its cells, and the mask are unchanged.

The unused .fov-btn classes follow the other games: a notebook key, a
forest primary with its own hover and press, and an outlined ink secondary.

Signed: Claude Code for Aaron Crosman

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The screenshot slide's three highlight boxes used Material colors. They now
use --callout-1 to --callout-3 in the same hues the caption names (blue,
green, orange), and the shared .tutorial-callout class adds the white halo.

The blue box covers the whole stats strip, so the caption now lists every
stat in it, including the session time. The alt text calls the stats a
strip.

Signed: Claude Code for Aaron Crosman

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The old screenshot was an 887x617 capture of the pre-notebook game area.
The new one follows the screenshot standard (1280x880 window, clipped to
#fov-game-area). It catches the second trial's stimulus, so the kitten and
toy show on the board beside the answer controls, whose location grid is
drawn at the first response phase. The three highlight boxes are
remeasured with extra padding, since the image shows at about 37% scale and
a tight border would cover the location grid's edge. The slide fits an
880px window without an image cap.

Signed: Claude Code for Aaron Crosman

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Field of View's CLAUDE.md gains the "Screen and stimulus surfaces" section
that every game needs: the shared HUD, which panel draws which card, the
notebook keys with their pressed, center, and chosen states, and the frozen
stimulus surfaces (the board, its cells, the mask, the translucent response
cells, and the flash overlays). It also notes that the chosen-board-cell
style is response feedback, not stimulus. The tutorial notes name each
callout's color token and the new screenshot frame.

Signed: Claude Code for Aaron Crosman

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Field Notebook 09: Games, part 5 (directional-processing, field-of-view)
Five games center their whole section, so their titles sat centered over
the panels. The other five (Orbit Sprite Memory, Fine Tuning, Sound Sweep,
Directional Processing, Field of View) left the title at the section's left
edge, even above a centered welcome panel. The shared title rule now
centers the title too. That has no effect on the games that already center
it, and changes no game's layout below the title.

The rule's comment now uses US spelling, per the project standard.

Signed: Claude Code for Aaron Crosman

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Nothing in app/ references --bg-muted, --bg-nav, --border-subtle,
--btn-danger-border, --color-danger-muted-hover, or --color-success any
more. The per-game passes moved every game onto --bg-sunken,
--feedback-*, and the button tokens. Dropping them keeps the theme group
small for a future dark theme. No --stim-* token is touched.

Signed: Claude Code for Aaron Crosman

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The reduced-motion block in base.css never applied. base.css is imported
before game-card.css, history.css, and game-shared.css, so their
transitions, at the same specificity, won the cascade. Under
prefers-reduced-motion: reduce, the menu cards still lifted, the History
bars still grew, and every game button still slid (checked with
getComputedStyle: 0.15s to 0.2s).

Each stylesheet now turns off its own transitions at its end, the pattern
game-shared.css already used for the tutorial marker. base.css keeps only
the skip link. app/CLAUDE.md records the rule, and that stimulus
animations are never turned off.

Signed: Claude Code for Aaron Crosman

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The notebook keys in Fine Tuning, Sound Sweep, Directional Processing, and
Field of View slide 2px down over 0.1s when pressed. With
prefers-reduced-motion: reduce they now drop without the slide, as the
shared buttons do. Each game's block sits at the end of its stylesheet, so
it overrides the key rules above it. Stimulus transitions in other games
are untouched.

Signed: Claude Code for Aaron Crosman

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@acrosman
acrosman added this pull request to stack #228 October 3, 2026 03:23
@acrosman
acrosman merged commit 3dc3454 into main Oct 3, 2026
7 checks passed
@acrosman
acrosman deleted the design/field-notebook branch October 3, 2026 03:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Tutorial overlay: tall slides overflow the window and hide their top

1 participant