Skip to content

feat(website): premium-polish pass on the docs chrome - #872

Merged
blove merged 1 commit into
mainfrom
blove/docs-premium-polish
Aug 30, 2026
Merged

feat(website): premium-polish pass on the docs chrome#872
blove merged 1 commit into
mainfrom
blove/docs-premium-polish

Conversation

@blove

@blove blove commented Aug 30, 2026

Copy link
Copy Markdown
Contributor

Summary

Tier 1+2 of the docs premium-polish redesign (from the Namespace-docs reference analysis), keeping Threadplane's identity (navy accent, Garamond headings, mono labels):

  • PageActions → "Copy page" split button. The primary segment copies the page as Markdown in one click (the highest-value action was buried in a menu); the chevron opens the existing menu (Open in ChatGPT / View as Markdown / Edit on GitHub). The fix(website): docs polish 3/3 — a11y and interaction #865 keyboard a11y is preserved: menu focuses its first item on open, arrow/Home/End roving, Escape closes and restores trigger focus. Both segments keep ≥44px hit areas via ::after extension — overflow: hidden on the group was dropped for per-segment radii so the hit areas aren't clipped.
  • TOC → scroll-position indicator. Continuous hairline rail; the active link paints an accent bar over it plus 500 weight, level-3 items indent. Active tracking now computes "last heading above the reading line" (rAF-throttled) instead of an IntersectionObserver band — jump-scrolls and hash navigation always yield an active item (the old band could leave the TOC with no active state).
  • Sidebar. Per-section stroke glyphs (getting-started / guides / concepts / components / a2ui / api / reference), search trigger gains a leading search icon and a real <kbd> ⌘K chip, nav links get more vertical rhythm and a 500-weight active state.
  • Docs index. 20px card gap + min() clamp on the grid column floor.

Blast radius

All six changed files are docs-scoped (docs components, docs.css, one .docs-index-grid rule in pages.css used only by /docs). Marketing and homepage untouched.

Verification

  • Browser-measured: split-button menu keyboard flow end-to-end, active-rail accent (#004090) + weight computed on data-active, hit targets 44×45.5 (chevron) and full-width×45.5 (primary), no horizontal overflow at 375, index grid single-column at mobile.
  • nx test website green (PageActions spec updated for the split button), lint 0 errors (guard at error), production build green.

🤖 Generated with Claude Code

Tier 1+2 of the docs visual redesign (Namespace-reference analysis):

- PageActions becomes a labeled 'Copy page' split button — the primary
  segment copies the page as Markdown directly; the chevron opens the
  existing actions menu (ChatGPT / View as Markdown / Edit on GitHub)
  with the #865 keyboard a11y preserved. Both segments keep 44px hit
  areas via ::after extension (overflow: hidden dropped in favor of
  per-segment radii so the hit areas aren't clipped).
- TOC becomes a scroll-position indicator: continuous hairline rail,
  active link paints an accent bar segment + 500 weight. Active
  tracking now computes 'last heading above the reading line' instead
  of an IntersectionObserver band, so jump-scrolls and hash navigation
  always yield an active item.
- Sidebar: per-section stroke glyphs (getting-started/guides/concepts/
  components/a2ui/api/reference), search trigger gains a leading search
  icon and a real <kbd> ⌘K chip, nav links get more vertical air and a
  500-weight active state.
- Docs index grid: 20px gap + min() clamp on the column floor.

Verified in-browser: menu keyboard flow (focus first item, Escape,
focus restore), active-rail accent (#004090) computes on data-active,
44px hit targets, no horizontal overflow at 375. nx test website green,
lint 0 errors, production build green.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@vercel

vercel Bot commented Aug 30, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
threadplane Ready Ready Preview Aug 30, 2026 2:53pm

Request Review

@blove
blove enabled auto-merge (squash) August 30, 2026 14:50
@github-actions

github-actions Bot commented Aug 30, 2026

Copy link
Copy Markdown
Contributor

Claude finished @blove's task in 0s —— View job


I'll analyze this and get back to you.

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Automated approval: this PR received an intelligent (AI) code review. See the review comments on this PR.

@blove
blove merged commit 93635ad into main Aug 30, 2026
24 checks passed
@blove
blove deleted the blove/docs-premium-polish branch September 3, 2026 22:30
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