You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Add accessibility baseline: skip link, focus styles, nav label #6
The theme ships no accessibility baseline. parts/header.html and parts/footer.html use correct landmark elements, but there is no skip link, no navigation label and no focus styling. Because every client theme starts from this markup, the gap is systemic and is rarely retrofitted after launch.
Add:
A skip-to-content link as the first focusable element, visually hidden until focused, targeting the main content landmark.
An aria-label on the navigation block in parts/header.html.
Visible :focus-visible styling defined through theme.json styles (elements.link, button and input focus states) rather than a new stylesheet, so the zero-render-blocking-CSS path is preserved.
A main landmark wrapping post content in the templates, where not already present.
Do not introduce a custom stylesheet or JavaScript for this.
Acceptance criteria
Tabbing from page load reveals the skip link as the first stop; activating it moves focus to the main content.
Every interactive element has a visible focus indicator meeting WCAG 2.2 AA non-text contrast.
Navigation is announced with a distinct accessible name.
Each template exposes exactly one main landmark.
An axe or pa11y run against a scaffolded install reports no violations on the front page, a single post and a 404.
Theme still ships zero render-blocking CSS; no new stylesheet or script added.
Shipped skip link + #main-content on the index main landmark and focus styling. Happy to extend the main id to other templates and add an explicit nav aria-label next if you want the full #6 checklist in one go.
Activity
KhyFee commentedon Aug 11, 2026
For a WordPress starter baseline I'd ship:
av (�ria-label="Primary" or similar)
That covers the common checklist without a heavyweight a11y library. I can PR those four if you want them broken out separately.
KhyFee commentedon Aug 11, 2026
PR open: #9
Shipped skip link +
#main-contenton the index main landmark and focus styling. Happy to extend the main id to other templates and add an explicit navaria-labelnext if you want the full #6 checklist in one go.