Skip to content

Add semantic navigation and enhance skip link visibility #12075

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
pelikhan merged 3 commits into from
Jan 27, 2026
+24 −2
Merged

Add semantic navigation and enhance skip link visibility #12075

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
bdd6625
Initial plan
Copilot Jan 27, 2026
69f0ede
Add semantic navigation and improve accessibility
Copilot Jan 27, 2026
ca088eb
Merge branch 'main' into copilot/update-multi-device-testing-report-a…
pelikhan Jan 27, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions docs/src/components/CustomHeader.astro
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,15 +6,15 @@ const base = import.meta.env.BASE_URL;
// Filter out RSS link from social links
---

<div class="custom-header-links">
<nav class="custom-header-links" aria-label="Primary navigation">
<a href={`${base}introduction/overview/`} class="header-link">Docs</a>
<a href={`${base}setup/quick-start/`} class="header-link">Quick Start</a>
<a href={`${base}examples/comment-triggered/chatops/`} class="header-link">Examples</a>
<a href={`${base}reference/workflow-structure/`} class="header-link">Reference</a>
<a href={`${base}blog/`} class="header-link">Blog</a>
<a href={`${base}reference/faq/`} class="header-link">FAQ</a>
<a href={`${base}blog/2026-01-12-welcome-to-pelis-agent-factory/`} class="header-link">Peli's Agent Factory</a>
</div>
</nav>
<Default {...Astro.props} />

<style>
Expand Down
22 changes: 22 additions & 0 deletions docs/src/styles/custom.css
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -79,6 +79,28 @@
animation: light-glow-move 20s ease-in-out infinite;
}

/* Skip to Content Link - Enhanced Accessibility */
/* Override Starlight's default skip link styles for better visibility */
a[href*="#"][href$="_top"]:focus,
a[href*="#overview"]:focus:first-child {
clip: auto !important;
clip-path: none !important;
position: fixed !important;
top: 1rem !important;
left: 1rem !important;
z-index: 9999 !important;
padding: 1rem 1.5rem !important;
background-color: var(--sl-color-accent) !important;
color: var(--sl-color-text-invert) !important;
text-decoration: none !important;
font-weight: 600 !important;
font-size: 1rem !important;
border-radius: 0.5rem !important;
box-shadow: 0 4px 12px rgba(0, 0, 0, 0.3) !important;
outline: 3px solid var(--sl-color-accent-high) !important;
outline-offset: 2px !important;
}

/* Campaign specs Mermaid diagram colors
We style Mermaid nodes by their class (tracked, notTracked, workflow, external)
so we can use lighter colors in light mode and darker colors in dark mode. */
Expand Down