@ai-created/ui
All guidelines
Guideline 05Canonical

Accessibility standards

The release contract for inclusive semantics, input, perception, reflow, motion, and assistive technology behavior.

Owner
Design Systems and Engineering
Last reviewed
August 2026
Review cadence
Every release and quarterly manual audit
Source of truth
WCAG 2.2 AA target and component accessibility specs

Required outcomes

01

Core workflows operate with keyboard and screen reader alone.

02

Content remains usable at 200 percent zoom and 320 CSS pixels.

03

Component releases include automated and manual accessibility evidence.

01

Conformance target

WCAG 2.2 Level AA is the minimum. Native semantics and platform conventions are the starting point.

Acceptance matrix

AreaMinimumEvidence
Contrast4.5:1 text, 3:1 large text and meaningful UI graphicsTheme-paired contrast audit
KeyboardAll actions reachable, operable, and escapableInteraction tests plus manual pass
FocusVisible, ordered, not obscured, restored after overlaysBoth themes at desktop and mobile viewport
Touch44 by 44 CSS pixel target where practicalRendered target inspection
Zoom and reflow200 percent zoom and 320 CSS pixel width without lost contentManual browser matrix
MotionReduced-motion alternative and no unsafe flashingMedia query and behavior review
Names and rolesProgrammatic name, role, value, stateAccessibility tree and screen reader
02

Keyboard, focus, and announcements

Keyboard behavior follows the native element or established ARIA pattern, never a visual imitation.

Interaction requirements

01

Use native controls first

Buttons, links, inputs, selects, and dialogs provide behavior that custom roles must otherwise reproduce.

02

Do not trap focus outside a modal

Only active modal dialogs contain focus. Escape closes when cancellation is supported.

03

Return focus intentionally

Closing transient UI restores focus to the trigger or the next logical workflow target.

04

Announce outcomes, not activity noise

Use live regions for asynchronous results that are not otherwise focused. Avoid repeated progress chatter.

Common keyboard contracts

PatternKeys
Button and toggleEnter and Space activate
TabsArrow keys move; Home and End jump; focus and selection policy is documented
MenuArrow keys move; Enter selects; Escape closes and restores focus
DialogTab cycles inside; Escape cancels when allowed
SliderArrow keys step; Page keys make larger changes; Home and End set bounds
Radio groupArrow keys move and select within the group
03

Perception, reflow, and user preferences

Information survives theme, forced colors, text spacing, zoom, and reduced motion.

Resilience checks

Visual

  • Light and dark themes retain hierarchy.
  • Forced-colors mode preserves controls and focus.
  • Status includes text or shape in addition to color.
  • Browser text-spacing overrides do not clip content.

Responsive

  • No two-dimensional scrolling for ordinary content at 320 CSS pixels.
  • Sticky regions do not obscure focus.
  • Landscape mobile retains primary actions.
  • Tables provide a deliberate narrow-screen strategy.

Preferences

  • Reduced motion removes nonessential movement.
  • Autoplay is absent or user-controlled.
  • Animation does not block interaction.
  • Theme choice persists without flash.
04

Accessibility test responsibilities

Automation catches regressions. Manual evaluation confirms that the workflow is actually understandable.

Release evidence

  1. 01

    Author

    Owner: Component author

    Semantic markup, keyboard tests, labels, state announcements

    Exit gateNo known serious automated violations.
  2. 02

    Review

    Owner: Design Systems

    Focus, contrast, zoom, reflow, reduced-motion evidence

    Exit gateBoth themes and exceptional states pass.
  3. 03

    Assistive technology

    Owner: QA or trained reviewer

    VoiceOver/Safari plus NVDA/Firefox or equivalent workflow notes

    Exit gateName, role, state, reading order, and recovery are usable.
  4. 04

    Monitor

    Owner: Product team

    Reported issue triage and regression coverage

    Exit gateCritical issues block release; fixes add lasting tests.