Skip to content

fix(dashboard): bump doc-chrome typography; widen sidebar column#500

Merged
esengine merged 1 commit into
mainfrom
fix/461-dashboard-typography
May 9, 2026
Merged

fix(dashboard): bump doc-chrome typography; widen sidebar column#500
esengine merged 1 commit into
mainfrom
fix/461-dashboard-typography

Conversation

@esengine

@esengine esengine commented May 9, 2026

Copy link
Copy Markdown
Owner

Summary

The design-doc page chrome (.toc / .section / .subsec) was tuned on a larger display and reads as too tight on a 13" laptop at 100% zoom. Sidebar section headers at 10px / 0.14em tracking are the worst offender, and 240px isn't wide enough for 2–3 word section labels (e.g. "§13 Hooks & Settings", "§14 Open questions"), which wrap mid-word.

This PR bumps the doc-chrome scale and widens the sidebar:

  • Sidebar column 240 → 260px; padding 28/18 → 28/16.
  • .toc h1 14 → 15px; .toc .sub 11 → 12px; .toc-section 10 → 12px with tracking lowered 0.14 → 0.08em so the size bump doesn't fight the letter-spacing.
  • .toc li a 12.5 → 14px with line-height: 1.4 and overflow-wrap: anywhere for graceful wraps when a label still doesn't fit.
  • Body copy: .section > .lede 13 → 15px; .subsec > p 12.5 → 15px; .subsec > h3 .desc 12 → 13px.
  • Code-style labels: .swatch .hex 10.5 → 11.5px; .scale-row .lbl 10.5 → 11.5px (and width 70 → 76px to keep the new digits aligned).

Mirrored verbatim into docs/design/agent-dashboard.html per the "keep CSS in lockstep with the mockup" comment at the top of app.css.

Closes #461

Test plan

  • npm run verify (full suite, 2324 tests).
  • Visual check on a 13" laptop at 100% zoom — sidebar labels no longer wrap mid-word; doc body reads at standard product-UI scale.

The design-doc page chrome (`.toc` / `.section` / `.subsec`) was tuned
on a larger display and reads as too tight on a 13" laptop at 100%
zoom. Sidebar section headers at 10px with 0.14em tracking are the
worst offender — section labels also wrap mid-word in the 240px column.

- `.page` sidebar column: 240px → 260px so 2–3 word section labels fit.
- `.toc h1` 14 → 15px; `.toc .sub` 11 → 12px.
- `.toc-section` 10 → 12px and tracking 0.14em → 0.08em (lower so the
  size bump doesn't fight the letter-spacing).
- `.toc li a` 12.5 → 14px with `line-height: 1.4` and
  `overflow-wrap: anywhere` for graceful wraps on longer labels.
- `.section > .lede` 13 → 15px; `.subsec > p` 12.5 → 15px (line-height
  1.6 already applied).
- `.subsec > h3 .desc` 12 → 13px.
- `.swatch .hex` 10.5 → 11.5px; `.scale-row .lbl` 10.5 → 11.5px (and
  width 70 → 76px to keep the new monospace digits aligned).

Mirrored verbatim into `docs/design/agent-dashboard.html` per the
"keep CSS in lockstep with the mockup" comment at the top of app.css.

Closes #461
@esengine esengine merged commit 874f0d1 into main May 9, 2026
3 checks passed
@esengine esengine deleted the fix/461-dashboard-typography branch May 9, 2026 05:17
@esengine esengine mentioned this pull request May 9, 2026
2 tasks
ChasLui pushed a commit to ChasLui/DeepSeek-Reasonix that referenced this pull request May 23, 2026
…ngine#500)

The design-doc page chrome (`.toc` / `.section` / `.subsec`) was tuned
on a larger display and reads as too tight on a 13" laptop at 100%
zoom. Sidebar section headers at 10px with 0.14em tracking are the
worst offender — section labels also wrap mid-word in the 240px column.

- `.page` sidebar column: 240px → 260px so 2–3 word section labels fit.
- `.toc h1` 14 → 15px; `.toc .sub` 11 → 12px.
- `.toc-section` 10 → 12px and tracking 0.14em → 0.08em (lower so the
  size bump doesn't fight the letter-spacing).
- `.toc li a` 12.5 → 14px with `line-height: 1.4` and
  `overflow-wrap: anywhere` for graceful wraps on longer labels.
- `.section > .lede` 13 → 15px; `.subsec > p` 12.5 → 15px (line-height
  1.6 already applied).
- `.subsec > h3 .desc` 12 → 13px.
- `.swatch .hex` 10.5 → 11.5px; `.scale-row .lbl` 10.5 → 11.5px (and
  width 70 → 76px to keep the new monospace digits aligned).

Mirrored verbatim into `docs/design/agent-dashboard.html` per the
"keep CSS in lockstep with the mockup" comment at the top of app.css.

Closes esengine#461
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.

dashboard: sidebar / body type too small, sidebar column too narrow

1 participant