Docs: hi-res images across pages + content refinements - #28
Merged
Conversation
Refresh visuals and copy across the design guidelines docs. Images — re-exported from Figma at higher resolution (mostly 4x / scale-4, ~2-4x the previous size) to fix pixelation on retina: - Text field (hero + all 7 state visuals) - Date filter (hero + variants, placement, interaction, copy) - Active filters (hero + states, placement, copy) - Checkbox group (placement do/dont + interaction + copy) - Clear filters (states + placement) - Khanductor (placement + appearance/scale visuals) - Khanmigo — content page fix in this session touched the intro copy spacing only; its visuals still need hi-res (whole-page Figma node breaks the metadata API — to be done from section nodes) - Progress stepper (variants + copy) - Toggle (placement/interaction/copy, plus new Preferences visuals) - Filter and sort (hero + all 10 logic-framework diagrams) Content / structure: - Toggle: restructured into Filtering and Preferences contexts; split Copy per context; do/dont examples now render via the Figure component instead of bars baked into the images; added Preferences examples to the when-to-use / when-not-to-use tables. - Filter and sort: reordered so each section's text sits above the image it describes (was off by one); removed the Figma source link. - Date filter: state each variant's active-filter-chip behavior. - Active filters: correct the "what generates an active filter" rule to be about who owns the control's starting value (ownership), not legibility; add the Date inline filter button row. - Text field: badge on its own line; tightened Placeholder and Helper text copy; removed the Figma source link. - Checkbox group: fixed do-bar captions (explanation -> caption prop). - Clear filter / Toggle / Text field / Filter and sort: removed Figma source links. - Khanductor: badge on its own line above the description. - Introduction: refined the opening paragraph. Tooling: - .claude/launch.json: autoPort true so the Storybook dev server can pick a free port when 56789 is taken. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
A new build was pushed to Chromatic! 🚀 |
caitlynmayers
approved these changes
Aug 4, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Overview
A sweep across the design guidelines docs to replace pixelated visuals with hi-res exports and land a batch of content/structure refinements gathered over one working session. Docs-only — no library/runtime code.
Images (hi-res)
Re-exported from Figma at higher resolution (mostly scale-4, ~2–4× the previous pixels) to fix fuzziness on retina. Where the Figma metadata API worked, each visual frame was exported individually; for the two whole-page nodes it rejects (Filter and sort), the visuals were cropped from a full-page 4× export.
Content & structure
Figurecomponent instead of bars baked into the images; added Preferences examples to the when-to-use / when-not-to-use tables; "Interaction" → "Instant save".explanation→captionprop theFigurecomponent actually reads).Tooling
.claude/launch.json—autoPort: trueso the Storybook dev server can pick a free port when 56789 is taken.Notes for reviewers
toggle/interaction-2.pngwas deleted and replaced byinteraction-2-do.png/interaction-2-dont.png(the Filter modal example was split so the do/don't bars render from the component).clear-filter'sstates-default.pngandplacement.pngare intentionally the same mockup (they already were before this PR).🤖 Generated with Claude Code