Skip to content

Polish docs site with custom theme, interactive hero, and link fixes#1763

Merged
kmcginnes merged 17 commits into
feat/starlight-docsfrom
feat/starlight-docs-improvements
Jun 4, 2026
Merged

Polish docs site with custom theme, interactive hero, and link fixes#1763
kmcginnes merged 17 commits into
feat/starlight-docsfrom
feat/starlight-docs-improvements

Conversation

@kmcginnes
Copy link
Copy Markdown
Collaborator

@kmcginnes kmcginnes commented May 12, 2026

Description

Gives the docs site a branded identity, replaces plain markdown with Starlight's built-in components, fixes broken relative links, and adds view transitions.

Theme & Landing Page

  • Add branded visual theme: violet accent, Inter font, slate grays with dark/light mode support
  • Add interactive animated graph background on the landing page hero with mouse-reactive nodes
  • Add frosted nav bar, gradient CTA button, and hover states on primary/minimal buttons
  • Move search to right side of nav bar alongside social icons and theme switcher

Starlight Components & Content

  • Replace plain link lists with Starlight LinkCard, CardGrid, Steps, Tabs, and Badge components throughout
  • Improve guides and configuration page formatting

Link & Asset Fixes

  • Fix all broken relative links caused by Starlight's URL structure (each page gets its own directory level)
  • Remove duplicate/unused images and dead CSS variables

Infrastructure

  • Add view transitions via astro-vtbot
  • Set browser tab title to "Docs | Graph Explorer" while hero displays a separate headline
  • Add workflow_dispatch input for building docs from a specific branch
  • Clean up temporary feature branch deploy triggers

Validation

  • pnpm docs:build passes (26 pages, no warnings)
  • All internal links verified by URL resolution tracing
  • Animation lifecycle confirmed: rAF cancels on view transition navigation
  • Graph animation respects prefers-reduced-motion
  • Uses CSS Color Level 5 relative color syntax (oklch(from ...)) — acceptable for a developer docs audience

Related Issues

Check List

  • I confirm that my contribution is made under the terms of the Apache 2.0 license.
  • I have verified pnpm checks passes with no errors.
  • I have verified pnpm test passes with no failures.
  • I have covered new added functionality with unit tests if necessary.
  • I have updated documentation if necessary.

kmcginnes and others added 4 commits May 12, 2026 19:37
…shed components

Add animated graph background to the hero section with mouse-reactive nodes,
switch color palette to slate/violet using Tailwind OKLCH values, add frosted
nav bar, gradient CTA button, and consistent card/link-card/pagination styling.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Relative links from non-index pages used ./ or ../ incorrectly for
Starlight's URL structure where each page gets its own directory level.
Also removes duplicate/unused images, cancels the rAF animation loop
on view transition navigation, and removes dead CSS variables and a
no-op media query.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@kmcginnes kmcginnes changed the title Use Starlight built-in components across docs Polish docs site with custom theme, interactive hero, and link fixes May 14, 2026
kmcginnes and others added 6 commits May 14, 2026 16:27
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
The page covers database version recommendations, not hardware requirements.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
… tab

Starlight renders the browser tab as "{page title} | {site title}", so
setting page title to "Docs" gives "Docs | Graph Explorer" while the
hero still displays "Every Connection Tells a Story" as the headline.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Primary button brightens on hover; minimal button transitions to accent
color matching the secondary button hover behavior.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
…cher

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@kmcginnes kmcginnes merged commit 3175785 into feat/starlight-docs Jun 4, 2026
@kmcginnes kmcginnes deleted the feat/starlight-docs-improvements branch June 4, 2026 21:36
kmcginnes added a commit that referenced this pull request Jun 4, 2026
…1763)

* Use Starlight built-in components and add manual dispatch to docs workflow

* Add hero image with gradient blob and feature cards to landing page

* Temporarily trigger docs deploy from feature branch

* Improve guides and configuration page formatting

* Add view transitions, brand colors, badge-style config, and polish

* Update docs site styles with Tailwind color palette and Obsidian-inspired components

* Add Inter font, custom Hero component, amber accent with stone grays

* Subtle sidebar active item, improve light mode accent contrast

* Enhance docs site with interactive graph hero, violet theme, and polished components

Add animated graph background to the hero section with mouse-reactive nodes,
switch color palette to slate/violet using Tailwind OKLCH values, add frosted
nav bar, gradient CTA button, and consistent card/link-card/pagination styling.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* Fix broken relative links, clean up unused assets and dead CSS

Relative links from non-index pages used ./ or ../ incorrectly for
Starlight's URL structure where each page gets its own directory level.
Also removes duplicate/unused images, cancels the rAF animation loop
on view transition navigation, and removes dead CSS variables and a
no-op media query.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* Remove temporary feature branch from docs deploy trigger

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* Fix minimum-requirements description to match page content

The page covers database version recommendations, not hardware requirements.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* Use hero.title for landing page headline, keep page title for browser tab

Starlight renders the browser tab as "{page title} | {site title}", so
setting page title to "Docs" gives "Docs | Graph Explorer" while the
hero still displays "Every Connection Tells a Story" as the headline.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* Add hover states to primary and minimal buttons

Primary button brightens on hover; minimal button transitions to accent
color matching the secondary button hover behavior.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* Move search to right side of nav bar with social icons and theme switcher

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* Temporarily trigger docs deploy from feature branch

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* Remove temporary feature branch from docs deploy trigger

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
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