Skip to content

feat(overview): add GitHub icon link to nav on every page#589

Merged
HenryLach merged 2 commits into
mainfrom
feat/github-icon-in-nav
May 19, 2026
Merged

feat(overview): add GitHub icon link to nav on every page#589
HenryLach merged 2 commits into
mainfrom
feat/github-icon-in-nav

Conversation

@HenryLach
Copy link
Copy Markdown
Owner

Adds a GitHub icon to the right side of the eyebrow on every page of the Taskplane Overview microsite, linking to the source repository. Positioned to the left of the existing prev / index / next nav arrows so the deck-navigation controls stay grouped on the right edge.

Implementation

  • Inlined SVG (not <img>) so fill="currentColor" picks up the green from .page-nav and follows the same hover-to---text transition as the arrow glyphs.
  • Pages 01–17 — link inserted as the first child of the existing <nav class="page-nav"> so the icon sits left of the arrows.
  • index.html — previously had no .page-nav (eyebrow held only title + logo). Added a minimal <nav class="page-nav" aria-label="External links"> containing just the GitHub link, so the icon still appears in the same screen position. The aria-label intentionally says 'External links' rather than 'Page navigation' since it doesn't navigate within the deck.
  • SVG sized at 0.85em — tracks the nav font-size while compensating for the fact that the SVG fills its full viewBox whereas arrow glyphs leave intrinsic side bearings, so the visual weight matches.
  • target="_blank" rel="noopener" — repo opens in a new tab.

To check before merging

  • Icon appears on the right of every page (yes, including the index)
  • Color matches the arrow glyphs (green by default, lifts on hover)
  • Size feels right relative to the arrows — if it's too big or too small, the single knob is .page-nav a svg { width / height } in shared.css
  • Clicking the icon opens the GitHub repo in a new tab
  • On mobile, the icon participates in the stacked eyebrow's nav row alongside the existing arrows

No release. Pure microsite UI enhancement.

HenryLach added 2 commits May 19, 2026 08:03
The github wordmark SVG is inlined (rather than referenced as an <img>)
so its fill="currentColor" inherits from the .page-nav green color and
follows the same hover transition / touch-target padding as the existing
prev / index / next anchors.

Implementation:

* For pages 01-17 (which already have <nav class="page-nav">), the
  link is inserted as the FIRST child of the nav so it sits to the
  left of the arrow controls.

* For index.html (which previously had no .page-nav — eyebrow held
  just the title + logo), a minimal <nav class="page-nav"> is added
  containing only the GitHub link. The aria-label is 'External links'
  rather than 'Page navigation' since it doesn't navigate within
  the deck.

* The SVG is sized at 0.85em (width and height) so it tracks the
  nav font-size while matching the visual weight of the arrow
  glyphs, which leave intrinsic side bearings inside their font
  box. fill="currentColor" keeps the icon green on default and
  picks up the hover --text color automatically.

* The link uses target="_blank" rel="noopener" so the source
  repo opens in a new tab — readers stay on the deck after viewing
  source.
The <a> tag wrapping the GitHub SVG now carries:

  title='Taskplane repository'       desktop browser tooltip on hover.
  aria-label='Taskplane repository'  accessible name announced by
                                       screen readers (replaces the
                                       earlier 'GitHub repository').

<a> has no 'alt' attribute (that's an <img>-only thing), but
aria-label is the same accessibility primitive — it overrides any
descendant text or graphic and gives assistive tech a single
authoritative label. 'Taskplane repository' is more specific than
'GitHub repository' since the link goes to one particular repo.

All 18 pages updated via sed since the pattern was identical.
@HenryLach HenryLach merged commit 9fc04bc into main May 19, 2026
1 check passed
@HenryLach HenryLach deleted the feat/github-icon-in-nav branch May 19, 2026 12:12
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