Accessibility at HallPal

HallPal is committed to keeping the admin dashboard usable for school administrators, teachers, and support staff regardless of how they interact with a computer. This page documents our current conformance target, known limitations, and how to report an issue.

Last reviewed

Conformance target

The HallPal admin dashboard targets WCAG 2.2 Level AA. This includes:

  • Text contrast of at least 4.5:1 (3:1 for large text).
  • All interactive controls reachable via keyboard.
  • Every interactive control has a visible focus indicator.
  • Tap targets at least 24×24 CSS pixels (WCAG 2.2).
  • Content reflows without horizontal scroll at 320 CSS pixels wide (400% zoom on a 1280px display).
  • Animations respect the user's prefers-reduced-motion preference.
  • Status messages announced to screen readers via ARIA live regions.
  • Landmarks (main, navigation, banner) so screen readers can jump between page regions.
  • A skip-to-main-content link as the first tab stop on every page.

How we verify

Every merge into main runs an automated accessibility suite against every authenticated route:

  • axe-core scan for WCAG 2.0/2.1/2.2 A + AA rules — in both light AND dark themes. Blocks the build on any critical or serious violation.
  • Keyboard-focus walk — Tab-navigates every route and asserts each focused element has a visible focus indicator and never escapes into an untrapped <body>.
  • Modal focus-trap regression test — opens modals, verifies Tab/Shift+Tab cycle within, Esc closes, focus restores to the opener.
  • 200% zoom reflow test — renders each route at a 640px viewport and asserts no non-exempt content overflows.
  • Accessibility-tree snapshots — the landmarks + headings a screen reader would traverse are committed to source control; unintended structural changes fail CI.
  • ESLint jsx-a11y strict rules — catches labeling and role misuse at lint time.

We also do periodic manual verification with the NVDA and VoiceOver screen readers, and via keyboard-only navigation through the most common workflows (create student, invite teacher, edit a hallpass, generate a join code).

Known limitations

  • The data-table routes (/students, /passes, /teachers, /homebases) may render a horizontal scrollbar at 640 CSS pixels. Data tables are explicitly exempt from WCAG 1.4.10 Reflow's no-horizontal-scroll rule; the full table is reachable via the horizontal scroll and each row remains keyboard-navigable.
  • Some third-party embedded content (charts, PDFs) may not fully comply. We're working to replace or wrap these where possible.

Report an issue

If you hit an accessibility barrier in HallPal — a page you can't read, a control you can't reach, an announcement that doesn't make sense — please tell us. We take these seriously and prioritize fixes over new features.

Email support@hallpal.divz.io with a description of the issue, the URL where it happened, and (if you're comfortable sharing) the assistive technology you were using. We aim to respond within 5 business days.

Standards + policy

  • Target: WCAG 2.2 Level AA.
  • US ADA Title II / III — public digital services.
  • EU Accessibility Act (EAA) — effective June 2025.
  • Section 508 (US federal procurement) — HallPal is not yet a Section 508 vendor; VPAT available on request.