Accessibility

We target WCAG 2.1 Level AAconformance across the consumer chat, the JCIL Cloud developer console, and the embeddable widget. This page is honest about where we stand — what works, what's in progress, and how to report issues.

What works today

  • Keyboard navigation — every interactive element in the chat UI is reachable via Tab, activated via Enter/Space, and dismissable via Escape where applicable.
  • Semantic HTML — headings (h1–h4), lists, tables, form labels, buttons, and ARIA roles are used correctly throughout.
  • Focus indicators — the primary focus ring uses the gold accent color with sufficient contrast against the background.
  • Color contrast — body text against the dark background meets AA (≥4.5:1). Large text and UI components meet AA Large.
  • Reduced motion — animations respect prefers-reduced-motion; thinking-block pulse and streaming indicators fall back to static styles.
  • Responsive layout — the chat and Trust Center render cleanly down to 375px viewport widths without horizontal scrolling.
  • Form accessibility — every input has a programmatically associated label, required fields are marked, inline errors are announced to assistive tech via aria-invalid and error-message regions.
  • Voice input — the chat composer supports Web Speech API dictation with a visible "Listening…" indicator.
  • Alt text — image outputs from the image-gen tool include the generating prompt as alt text for screen readers.
  • Skip to main content — keyboard users can bypass the chat sidebar via the first Tab stop.

Known gaps (in progress)

  • Streaming message announcement— streamed assistant responses update frequently; we do not yet announce every chunk to screen readers (the alternative would be overwhelming). A "response complete" announcement is planned.
  • Code block labels — the language label on code blocks is visible but not yet announced as a structured landmark to screen readers.
  • Tool output structure — image-gen and document-creator results render as custom cards; screen reader users get usable alt / title text, but the visual card structure is not yet a perfect semantic mirror.
  • Automated WCAG audit — we have not yet commissioned an external VPAT (Voluntary Product Accessibility Template). Planned for the SOC 2 Type 1 milestone.

Assistive technology we test against

  • VoiceOver on macOS + iOS (primary)
  • NVDA on Windows (secondary, via remote testing)
  • Keyboard-only navigation (no mouse/trackpad)
  • High-contrast mode (Windows)
  • Reduced-motion system preference (macOS / iOS / Windows)
  • Browser zoom up to 200%

Report an accessibility issue

If JCIL.AI is not working for you because of an accessibility barrier, please let us know — these reports are a priority and we treat them like security issues.

Submit through the compliance contact form with topic general compliance question(there isn't a dedicated accessibility topic yet; mention "accessibility" in the message and it routes to the same founder inbox). We acknowledge within two business days and work with you on a resolution or workaround.

Embed widget accessibility for customer deployments

Organizations deploying the JCIL Cloud widget on their own site are responsible for the surrounding page's accessibility (page heading structure, contrast between your theme and the widget, landmark roles). We provide the widget as an iframe with conforming internals — keyboard reachable, labeled controls, focus management on open/close.

Last updated: April 17, 2026. Conformance targets: WCAG 2.1 Level AA, Section 508 Refresh.