Skip to content

Docs: hi-res images across pages + content refinements - #28

Merged
anahernandez-dev merged 1 commit into
mainfrom
docs/hires-images-and-content-updates
Aug 4, 2026
Merged

Docs: hi-res images across pages + content refinements#28
anahernandez-dev merged 1 commit into
mainfrom
docs/hires-images-and-content-updates

Conversation

@anahernandez-dev

Copy link
Copy Markdown
Collaborator

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.

  • Text field — hero + all 7 state visuals
  • Date filter — hero + variants, placement, interaction, copy
  • Active filters — hero + states, placement, copy
  • Checkbox group — placement (do/don't) + interaction + copy
  • Clear filters — states + placement
  • Khanductor — placement + appearance/scale visuals
  • Progress stepper — variants + copy
  • Toggle — placement/interaction/copy + new Preferences visuals
  • Filter and sort — hero + all 10 logic-framework diagrams

Content & structure

  • Toggle — restructured into Filtering and Preferences contexts; Copy split per context; do/don't 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; "Interaction" → "Instant save".
  • 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 explicitly.
  • Active filters — corrected the "what generates an active filter" rule to be about who owns the control's starting value (not legibility); added 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 (explanationcaption prop the Figure component actually reads).
  • 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.jsonautoPort: true so the Storybook dev server can pick a free port when 56789 is taken.

Notes for reviewers

  • Every page was verified rendering in the Storybook preview after each change (no MDX compile errors).
  • toggle/interaction-2.png was deleted and replaced by interaction-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's states-default.png and placement.png are intentionally the same mockup (they already were before this PR).
  • Khanmigo is intentionally not included for hi-res: its whole-page Figma node crashes the metadata API, and its white-on-white visuals (one is a tall composite with baked-in "Don't" bars) don't crop cleanly — best done separately from the individual section nodes.

🤖 Generated with Claude Code

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>
@github-actions

github-actions Bot commented Aug 4, 2026

Copy link
Copy Markdown

A new build was pushed to Chromatic! 🚀

https://6a5008743971119020a6233b-amhzqzwpxn.chromatic.com/

@anahernandez-dev
anahernandez-dev merged commit df55acb into main Aug 4, 2026
5 checks passed
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.

2 participants