Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 2 additions & 1 deletion .cspellignore
Original file line number Diff line number Diff line change
Expand Up @@ -64,4 +64,5 @@ timestamptz
formatjs
autoplay
authproxy
xact
xact
WCAG
21 changes: 21 additions & 0 deletions docs/docs/9-coding-guidelines/13-accessibility.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
---
title: Accessibility
---

Comet projects aim to conform to [WCAG 2.1 Level AA](https://www.w3.org/TR/WCAG21/).

## POUR Principles

- **Perceivable:** Provide text alternatives, captions, and sufficient contrast.
- **Operable:** All functionality must be keyboard accessible.
- **Understandable:** Use predictable behavior, clear instructions, and helpful error messages.
- **Robust:** Ensure content works with a wide range of devices and assistive technologies.

## Key Rules

- Use semantic HTML (`<nav>`, `<main>`, `<button>`, `<label>`, etc.).
- Color contrast: at least **4.5:1** for normal text, **3:1** for large text.
- All interactive elements must be keyboard operable with visible focus indicators.
- Images need meaningful `alt` text; use `alt=""` for decorative images.
- Associate form inputs with `<label>` (or `aria-label` / `aria-labelledby`).
- Respect `prefers-reduced-motion`; avoid autoplay animations for users who have requested reduced motion.
Loading