# Demeter Accessibility Statement

Demeter is committed to being usable by everyone, including people who rely on
assistive technologies. This statement describes our accessibility target, the
features we provide, and known limitations. It complements the technical
[accessibility audit report](audit-report.md).

## Conformance target

We target **WCAG 2.1 Level AA**. The web dashboard's components pass an
automated axe-core A/AA scan with **zero violations**, and conformance is
enforced in CI by the accessibility test suite
(`apps/demeter/web/src/__tests__/accessibility.test.tsx`, 92 tests). See the
[audit report](audit-report.md) for the per-success-criterion evidence.

## Accessibility features

- **Keyboard navigation** (29.21.20.8 / WCAG 2.1.1): every interactive control
  is reachable and operable by keyboard; a "Skip to main content" link bypasses
  the navigation (WCAG 2.4.1); focus is visible and trapped within modals.
- **Screen-reader support**: semantic landmarks (`main`, `nav`), ARIA
  roles/names, `aria-live` announcements for toasts/errors, and (mobile)
  `accessibilityRole`/ `accessibilityLabel`/`accessibilityViewIsModal` on the
  design-system primitives.
- **Color & contrast** (29.21.20.1): body text and surfaces meet AA contrast;
  contrast is checkable via `@demeter/accessibility` (`contrastRatio`,
  `meetsContrast`). Color is never the sole means of conveying information
  (icons
  - text accompany status colors).
- **Colorblind-safe palettes** (29.21.20.2): charts/categorical color use the
  Okabe–Ito palette, verified distinguishable under protanopia, deuteranopia,
  and tritanopia via the `@demeter/accessibility` CVD-simulation utilities.
- **Resize text / font scaling** (WCAG 1.4.4): text uses relative units and
  honours the browser/OS font-size and zoom settings; the mobile app respects
  the OS Dynamic Type / font-size setting.
- **Reduced motion**: animations honour `prefers-reduced-motion`; status
  components provide non-motion fallbacks.

## Known limitations

- **High-contrast / large-text / simplified / one-handed UI modes** (29.21.20.1,
  .3, .4, .5, .9) are progressive theme/layout enhancements in the app; the
  underlying color and font-scaling logic is in place, with the toggles rolling
  out in the UI.
- **Audio descriptions for images** (29.21.20.6): images carry text
  alternatives; spoken audio descriptions are a roadmap item.
- **Haptic feedback** (29.21.20.7) is a native-mobile enhancement.
- **Live assistive-technology passes** (VoiceOver, TalkBack, NVDA, JAWS) are
  recommended before each release; automated checks cover the semantic contract,
  not the lived experience.

## Standards & techniques

- WCAG 2.1 AA success criteria (see the audit report's conformance table).
- ARIA Authoring Practices for composite widgets (dialogs, toasts, switches).
- Okabe & Ito (2008) colorblind-safe palette; Machado et al. (2009) CVD model.

## Feedback

If you encounter an accessibility barrier in Demeter, please tell us via the
in-app **Help** (`/settings/help`) or the community so we can fix it. We treat
accessibility defects as bugs, not feature requests.
