Skip to content

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

Open
kmcginnes wants to merge 17 commits into
feat/starlight-docsfrom
feat/starlight-docs-improvements
Open

Polish docs site with custom theme, interactive hero, and link fixes#1763
kmcginnes wants to merge 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>
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