DOCS / GUIDES

Accessibility at the coop

Build apps that every bird can use, including birds with unusual perches.

Beginner10 min read
Before you beginYou need the cluck CLI, a Pollosoft account, and a coop to work in. No prior experience required. Curiosity and a mild fondness for chickens are helpful.

Overview

Build apps that every bird can use, including birds with unusual perches. The whole thing takes about 10 minutes, and the commands below are the ones you will use along the way.

$ cluck a11y scan
$ cluck a11y report --format html
$ cluck preen --a11y

Steps

  1. Semantics first. Use real buttons, headings, and labels. A div with an onclick is a hen wearing a fox costume.
  2. Keyboard support. Everything should work without a mouse. Tab order should follow visual order.
  3. Contrast and motion. Keep a 4.5:1 contrast ratio and respect prefers-reduced-motion.
  4. Automate and test. Run cluck a11y scan in CI, then test with a screen reader yourself. Automation finds about a third of the problems.

Commands used

Keep going

Stuck? Check the error codes, the FAQ, or the glossary.