Skip to content

UI review

Review the built site for every change that affects layout, navigation, cards, or typography.

Required viewports

Viewport Use
390 x 844 phone baseline
768 x 1024 tablet / narrow desktop
1440 x 900 desktop
1728 x 1117 wide desktop

Check both light and dark themes.

Required pages

  • Home page
  • Specialization index
  • One specialization page
  • Frontier index by track
  • One feasibility class
  • One long foundation module

Acceptance checks

  • Card titles align with their descriptions and metadata.
  • Cards use one column on narrow screens.
  • Body text remains readable without zoom.
  • Dark-mode headings, card titles, body text, muted metadata, and links retain clear contrast against page and card surfaces.
  • No card, table, heading, code block, or URL creates horizontal page scroll.
  • Keyboard focus is visible.
  • Status labels remain clear without color.
  • Reduced-motion settings remove hover and transition motion.
  • Tables scroll inside their own container on narrow screens.

Run the source and built-site checks before browser review:

uv run --frozen python scripts/audit_ui.py
uv run --frozen python scripts/audit_contrast.py
uv run --frozen zensical build --clean
uv run --frozen python scripts/audit_ui.py --site site