Skip to content

Redesign Ledger's reader and visual identity - #39

Merged
kylebegeman merged 8 commits into
masterfrom
reader-redesign
Sep 28, 2026
Merged

kylebegeman merged 8 commits into
masterfrom
reader-redesign

Conversation

@kylebegeman

@kylebegeman kylebegeman commented Sep 28, 2026 •

Copy link
Copy Markdown
Owner

The reader now opens as a compact working archive. Recent changes lead the overview, linked counts replace large stat tiles, and releases, backlog, and health sit in an unboxed context column. Records and Timeline have denser rows, clearer navigation, and document-style details with a collapsed relationship map below the named references.

Browsing controls use rounded pills and a shared custom dropdown with keyboard navigation, typeahead, selected values, and viewport-aware placement. The desktop rail contains record types and complete Area, Release, and Tag menus; those same controls move into the toolbar on smaller screens. Quality filters show an active count, and Timeline omits repeated years beneath month headings while retaining full accessible dates. Search, URL history, filters, sorting, pagination, and keyboard shortcuts remain synchronized.

The visual system uses near-white light surfaces, charcoal/slate dark surfaces, and restrained blue accents. The Light/Dark switch follows the operating system until an explicit preference is saved. A new punched-receipt icon and outlined lowercase wordmark replace the previous identity in the reader, favicon, and README. All logo assets are self-contained and reproducible without new dependencies.

The README is rebuilt around the new identity, a 24-second recording of real reader interactions, an earlier quick start, and direct links into each example view. The tour is available as a compact GIF and a full-quality MP4, with still images and reduced-motion alternatives. Seven browser captures and the generated terminal artwork share the final palette. A reproducible Playwright/FFmpeg script captures the tour without adding dependencies. The existing Pages workflow publishes both reader profiles from master after merge; the URLs currently return 404 pending that first deployment. Receipts 0196 through 0202 and D009 record the implementation and design rules.

Record hover/open/selection highlights now have rounded corners and tighter padding. Final visual review also found and fixed empty overview area bars: their fill spans now honor proportional widths.

Validation:

  • npm run ci: exit 0; 530 tests across 63 files, typecheck, build, Ledger checks, and package dry run.
  • New coverage checks dropdown events, labels, keyboard/typeahead, disabled options, Escape/Ctrl+K, history/reset synchronization, and responsive movement of canonical controls. Existing theme, record navigation, map disclosure, mobile focus, and clipboard regressions pass.
  • Real-browser checks cover 320, 390, 768, 1000, and 1440px, both themes, menu bounds, filtering, URL state, quality badges, shortcuts, and accessible dates. No horizontal overflow or page errors.
  • All seven captures and representative video/GIF frames were visually inspected, including independent review. README images, heading links, themed logos, and reduced-motion fallbacks were checked at desktop and phone widths. Generated artwork, logo geometry, and SVG regeneration were checked. npm run readme:check passes.
  • Tested reading/control text pairs meet at least 4.51:1 contrast in both themes; semantic text passes against its paired backgrounds. Both reader profiles fit their render budgets, approximately 4.0 MB internal and 370 KB public.
  • Impeccable guided the refinement; its source detector reports no findings. Ledger readiness, docs impact, coverage, and diff checks pass.
  • Pages artifact staging and absolute feed URLs were verified in the preceding milestone; the workflow is unchanged in this revision.

One existing stale signal remains: closed session S0007 has expired. The package manifest and lockfile are unchanged. No npm version bump, merge, or publication is included.

@kylebegeman kylebegeman changed the title Redesign the reader and publish a live example Elevate the reader, refresh the README, and publish a live example Sep 28, 2026
@kylebegeman kylebegeman changed the title Elevate the reader, refresh the README, and publish a live example Redesign the reader as a compact archive and refresh the live example Sep 28, 2026
@kylebegeman kylebegeman changed the title Redesign the reader as a compact archive and refresh the live example Redesign the reader and Ledger identity Sep 28, 2026
@kylebegeman kylebegeman changed the title Redesign the reader and Ledger identity Redesign Ledger's reader and visual identity Sep 28, 2026
@kylebegeman
kylebegeman merged commit 6e75323 into master Sep 28, 2026
7 checks passed
@kylebegeman kylebegeman mentioned this pull request Sep 28, 2026
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