Accessibility

PupWiki aims to make its guides and tools usable for as many people as possible, including users who rely on keyboard navigation, screen readers, clear labels, readable contrast, and responsive layouts.

What PupWiki aims to support

• Keyboard navigation — All interactive elements (links, buttons, form controls, filter chips, tool steps) are reachable and operable by keyboard.
• Visible focus states — Focus indicators are visible on all interactive elements. We use design tokens that maintain consistent, high-contrast focus rings.
• Labeled form controls — All form fields, selects, and inputs have associated labels. Required fields are marked both visually and programmatically.
• Screen reader structure — Pages use semantic headings (h1–h3), landmark regions (main, nav, footer), and ARIA attributes where appropriate.
• Color contrast — Text and interactive elements use design tokens calibrated for WCAG AA contrast ratios.
• Responsive layouts — All pages and tools work on mobile, tablet, and desktop screen sizes without horizontal scrolling.
• Descriptive links — Links describe their destination rather than using generic text like "click here" or "read more."
• Error messages — Form validation errors are conveyed in text, not color alone, and are associated with the relevant field.

Tool and form accessibility

PupWiki's interactive tools (Dog Breed Selector Quiz, Dog Cost Calculator, Dog Training Plan Generator, Dog Food Calculator, etc.) are built as React islands with semantic HTML and ARIA attributes. Tools avoid mouse-only interactions and present results in a way that does not rely solely on color to convey meaning.

Multi-step tool forms use clear step indicators, labeled fields, and accessible button states (including aria-pressed for toggle buttons and aria-live regions for result counts).

Known limitations

PupWiki is an actively maintained site. Known accessibility gaps include:

• Some data-dense comparison tables may not yet have full screen reader optimisation for all cell relationships.
• Some image alt text descriptions are generated programmatically and may be less descriptive than ideal for complex photos.
• PDF or downloadable file support is not currently offered.

We work to improve these areas as part of ongoing development.

Report an accessibility issue

If you encounter a barrier on PupWiki — a page element you cannot reach by keyboard, a label that is missing, a contrast issue, or any other accessibility concern — please contact us with:

• The page URL where the issue occurs.
• The assistive technology and browser you are using (if known).
• A description of the barrier.

Accessibility reports are reviewed and prioritised as part of our standard correction workflow. We aim to respond within 5 business days.

Page last updated: 2026-06-06