Working draft. helpKNX is an actively developed product. This page describes our conformance target, what's already in place, and what's still being worked on. We update it as our accessibility audit cycle continues.
Our target
helpKNX targets WCAG 2.1 Level AA for every public-facing page, every authenticated dashboard, and every email template. That standard is the practical floor for ADA Title III on US commercial sites and a reasonable baseline for the kind of assistive technology our audience actually uses.
What's in place today
- Skip to main content link, revealed on first Tab keypress, on every page.
- Semantic landmarks —
<header>,<nav>,<main>,<footer>— not div soup. - Visible focus indicators on every interactive element.
:focus-visiblerings on inputs, buttons, links, and the search field group. - Form labels are explicit
<label for>pairings, generated by Razor's tag helpers; no placeholder-as-label patterns. - Form errors are announced to assistive tech via
aria-live="polite"on the validation summary. - Color contrast on body text and primary buttons meets AA (4.5:1). The brand gold has a darker text-safe variant reserved for use on light backgrounds.
- Keyboard reachable — every link, button, and form control is reachable by Tab in a sensible order.
- Reduced motion respected — the cookie banner's slide-in animation is disabled when
prefers-reduced-motion: reduceis set. - Language declared on the document root (
lang="en").
What we're still working on
- A manual screen-reader pass across the candidate and employer flows. Automated tooling catches roughly 30–40% of issues; the rest live in interaction patterns and content ordering that need human review.
- A third-party accessibility audit before public launch. We'll publish the result and the remediation list here.
- Administrative pages have had less aesthetic attention than the public site. They meet the same conformance target but the polish gap is real and on the list.
Standards we reference
- Web Content Accessibility Guidelines 2.1 — the international standard, Level AA target.
- ADA Title III — the US legal framework that applies to public-facing commercial sites.
- ARIA Authoring Practices — the patterns we follow for non-trivial widgets (modal dialogs, comboboxes, etc.) when we add them.
Found something we missed?
Email [email protected] with the subject line Accessibility issue. Tell us:
- The page or screen where you ran into it.
- What you were trying to do.
- What assistive tech you use, if any (screen reader, switch input, voice control, etc.).
We treat accessibility reports as support priority, not as feature requests. You'll get a real human reply.