Skip to content

examples: make every gallery graph legible on load#355

Merged
mikkel merged 1 commit into
mainfrom
examples-legibility
Jul 20, 2026
Merged

examples: make every gallery graph legible on load#355
mikkel merged 1 commit into
mainfrom
examples-legibility

Conversation

@mikkel

@mikkel mikkel commented Jul 20, 2026

Copy link
Copy Markdown
Member

What

Loading a gallery example dropped users into an illegible canvas — the exact moment we're trying to land the first "wow":

  • Intent comments clipped mid-sentence on 9 of 12 examples, and overlapped the first node on 5 of them.
  • Model arena stacked its four Contender nodes into one pile — three of four were buried.
  • Lyrics → song had an LLM sitting on the comment and a second LLM burying the first's system prompt.
  • Style switchboard hid 3 of its 5 art styles — the whole point of the example.
  • Talking avatar buried the portrait-upload node; photo → video rendered two cards flush edge-to-edge.

How

Rendered all 12 examples in a real headless browser (per the repo verify skill — zero API spend), critiqued each screenshot, measured actual node bounding boxes over CDP, and re-laid out every graph:

  • comments rewritten to one short breath, sized (w + sizes.text) so they never truncate, always clear of the first node
  • model arena → 2×2 contender grid, all four visible
  • lyrics → song re-laid as a clean left-to-right fan with zero overlaps
  • style switchboard Choice node widened + sizes.options so all five styles read one per line
  • 40px+ clearance between all cards everywhere

Verified by re-rendering all 12 after the change — every comment complete, every node fully visible. Full scripts/check-*.mjs suite green.

🤖 Generated with Claude Code

Loading an example dropped users into a wall of overlap: intent comments
clipped mid-sentence and sat on top of the first node, model arena stacked
four contenders into one illegible pile, lyrics→song buried both LLMs, and
style switchboard hid 3 of its 5 art styles. Rendered all 12 in a real
headless browser, critiqued each shot, and re-laid them out:

- intent comments: shorter one-breath wording, wide enough to never
  truncate, clear of the first node in every example
- model arena: 2×2 contender grid — all four fully visible
- lyrics→song: clean left-to-right fan (text → lyrics LLM → style LLM →
  music) with zero overlaps
- style switchboard: Choice node widened + sized so all five style
  options read on one line each
- talking avatar / photo→video: un-buried the upload node, added
  breathing room between flush cards

Co-Authored-By: Claude Fable 5 <[email protected]>
@mikkel
mikkel merged commit 46d948a into main Jul 20, 2026
3 checks passed
@mikkel
mikkel deleted the examples-legibility branch July 20, 2026 01:23
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.

1 participant