Tiny A11y

Write as little code as possible. Use native HTML elements that are already accessible instead of adding ARIA attributes to generic elements.

Core Principles

1. Trust the browser — Native elements have built-in accessibility
2. Semantic over ARIA — Use the right element, not role attributes
3. Less is more — Every ARIA attribute you don't write is one less thing to break
4. Native first — Use <dialog>, <details>, <button> before reaching for JavaScript

References

• Use WCAG 2.2 Understanding for accessibility guidance
• Use WAI-ARIA 1.2 for ARIA attributes
• Use APG Gherkin for component test cases
• Use Design Tokens for design systems terminology