diff --git a/apps/events/CHANGELOG.md b/apps/events/CHANGELOG.md index 113e6cc..6cbb446 100644 --- a/apps/events/CHANGELOG.md +++ b/apps/events/CHANGELOG.md @@ -7,6 +7,37 @@ and this project follows [Semantic Versioning](https://semver.org/). ## [Unreleased] +## [1.50.0] - 2026-10-28 + +### Added + +- **Accessibility pass (WCAG 2.2 AA)** on the public pages, sign-in/sign-up, registration, + payment, My Events and the self-service kiosk: + - **Keyboard:** a "Skip to main content" link as the first Tab stop on every page; a clear focus + ring (in the brand colour) on everything you can tab to; popups (Contact us, Join the waitlist, + Sponsor a spot, Transfer ticket, the registration popup and send dialogs on My Events, the kiosk's + Change Event and Confirm account changes) are announced as dialogs, take focus when they open, + keep Tab inside, close with Escape and hand focus back. The kiosk's "Create an account" switch + and its password eye can now be used with the keyboard. + - **Screen readers:** every form field on those pages has a label tied to it (sign-in, sign-up, + forgot/reset password, activation, profile, privacy centre, payments filters, donate, forms, + feedback, consent, waitlist, sponsorship, transfer, kiosk and its custom questions); ticket + quantity buttons say what they do ("Add one Adult", "Remove one Adult") and the number is + announced; option buttons say which one is chosen; error messages are announced when they + appear. + - **Colour:** light grey text darkened to meet 4.5:1, and links inside sentences are underlined + so they don't rely on colour alone. The page honours "reduce motion" on the device. + - **Branding:** Site settings → Branding (and the setup wizard) warn when the primary colour is + too light for white text and links (under 4.5:1) and offer a darker shade of it in one click. +- Automated accessibility checks: `e2e/accessibility.spec.ts` runs axe-core (WCAG 2.0–2.2 A/AA + rules) on those pages, plus keyboard tests (skip link, popup focus and Escape, ticket quantities, + the kiosk switch). New dev dependency `@axe-core/playwright`. +- `components/shared/ModalOverlay.tsx` for the app's own popups, and `components/layout/SkipLink.tsx`. + +### Changed + +- e2e tests click ticket quantities by name (`/^Add one /`) instead of "+". + ## [1.49.2] - 2026-10-28 ### Added diff --git a/apps/events/FEATURES.md b/apps/events/FEATURES.md index 5c26dda..291cfb9 100644 --- a/apps/events/FEATURES.md +++ b/apps/events/FEATURES.md @@ -35,10 +35,11 @@ WhatsApp · PM2 for process management · optional Sentry for error monitoring. 19. [Volunteer rosters](#volunteer-rosters) 20. [Accounts & security](#accounts--security) 21. [Privacy (POPIA)](#privacy-popia) -22. [Help system](#help-system) -23. [Background jobs](#background-jobs) -24. [Operations](#operations) -25. [Page map](#page-map) +22. [Accessibility](#accessibility) +23. [Help system](#help-system) +24. [Background jobs](#background-jobs) +25. [Operations](#operations) +26. [Page map](#page-map) --- @@ -545,7 +546,7 @@ applied without a restart. Secrets are encrypted with AES-256-GCM. |-----|----------| | Organisation | Name, tagline, contact email/phone, address (with map link) | | Campuses | Off by default. Turn on, then add, order, archive or delete campuses (name, web address, address, contact, colour, logo, default event location, daily-summary recipients) | -| Branding | Primary/secondary/accent colours, logo, favicon, colours suggested from the logo, live website/email preview on desktop and mobile | +| Branding | Primary/secondary/accent colours (with a readability warning and a darker shade offered when the primary is too light), logo, favicon, colours suggested from the logo, live website/email preview on desktop and mobile | | Notifications | Registrations inbox and admin notification emails | | Email | SMTP host/port/TLS/user/password/from, with a "Test connection" button | | Legal | Operator, Information Officer, website, effective date for the Terms/Privacy pages | @@ -784,6 +785,18 @@ log. --- +## Accessibility + +Built to WCAG 2.2 AA on the public pages, sign-in, registration, payment, My Events and the +self-service kiosk (1.50.0): "Skip to main content" link, visible keyboard focus, labelled fields, +named buttons (ticket quantities say "Add one …"), errors announced as they appear, popups that +trap focus and close with Escape, readable contrast with underlined in-text links, and "reduce +motion" respected. Branding warns when the primary colour is too light for white text and +suggests a darker shade. axe-core checks and keyboard tests in the e2e suite +(`e2e/accessibility.spec.ts`) keep it that way. + +--- + ## Help system A floating **"Need help?"** button on every page opens a page-specific guide diff --git a/apps/events/SETTINGS.md b/apps/events/SETTINGS.md index ab9aae8..f4771b2 100644 --- a/apps/events/SETTINGS.md +++ b/apps/events/SETTINGS.md @@ -23,7 +23,7 @@ in-process settings cache TTL) without a server restart. | Setting | Default when unset | Notes | |---|---|---| -| `primary_color` | Legacy `accent_color` value if present, else `#4F46E5` (indigo) on the website / `#1e3a5f` (navy) in emails | See [Two different fallbacks](#two-different-fallbacks-for-primary_color) below — this is the one setting with a genuine inconsistency worth knowing about. Drives buttons, links, nav highlights, and the email header/CTA. | +| `primary_color` | Legacy `accent_color` value if present, else `#4F46E5` (indigo) on the website / `#1e3a5f` (navy) in emails | See [Two different fallbacks](#two-different-fallbacks-for-primary_color) below — this is the one setting with a genuine inconsistency worth knowing about. Drives buttons, links, nav highlights, and the email header/CTA. The Branding tab warns when it is under 4.5:1 against white (too light for white text and links) and offers a darker shade (1.50.0). | | `secondary_color` | `210 40% 96.1%` background / near-black text (light gray "wash", shadcn's stock theme) | The Branding tab's color picker *pre-fills* `#8B5CF6` as a suggested starting point, but that's only a UI default — if you never hit Save, the actual site uses the light-gray fallback, not violet. | | `accent_color` | `210 40% 96.1%` background / near-black text (same light gray as Secondary) | Same story as Secondary — the picker pre-fills `#EC4899` (pink) as a suggestion only. | | `logo_url` | Bundled logo (`frontend/src/app/church_logo.jpg`) | Shown in the navbar. This is still the original Hope Family Church artwork checked into the repo — swap the file (or upload a real logo via the Branding tab) before deploying for a different organisation. | diff --git a/apps/events/WHATS-NEW.md b/apps/events/WHATS-NEW.md index 5f985b3..99d1181 100644 --- a/apps/events/WHATS-NEW.md +++ b/apps/events/WHATS-NEW.md @@ -12,6 +12,16 @@ Write for church admins, not developers: no environment variables, endpoints or developer log is CHANGELOG.md. A tagged version without a section here shows "No details given". --> +## 1.50.0 + +- **Easier for everyone to use.** The public pages, registration, payment, My Events and the + self-service kiosk now work properly with a keyboard and with screen readers: a "Skip to main + content" link, a clear outline showing where you are, popups that can be closed with Escape, and + every form field, button and error message read out correctly. Faint grey text is darker and + links in sentences are underlined, so they're easier to read. +- **Branding check.** If the main colour you pick in Site settings → Branding is too light for + white text to be readable, you'll see a warning and can switch to a darker shade with one click. + ## 1.49.2 - **Saved filters.** On Manage registrations, Users, Events and Reports, save the filters you use diff --git a/apps/events/backend/package-lock.json b/apps/events/backend/package-lock.json index 728b179..cb33f50 100644 --- a/apps/events/backend/package-lock.json +++ b/apps/events/backend/package-lock.json @@ -1,12 +1,12 @@ { "name": "event-management-backend", - "version": "1.49.2", + "version": "1.50.0", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "event-management-backend", - "version": "1.49.2", + "version": "1.50.0", "hasInstallScript": true, "dependencies": { "@prisma/adapter-pg": "^7.10.1", diff --git a/apps/events/backend/package.json b/apps/events/backend/package.json index a6c35b1..a2a5620 100644 --- a/apps/events/backend/package.json +++ b/apps/events/backend/package.json @@ -1,6 +1,6 @@ { "name": "event-management-backend", - "version": "1.49.2", + "version": "1.50.0", "description": "Event Management System Backend", "main": "src/index.js", "scripts": { diff --git a/apps/events/docs/HANDOVER.md b/apps/events/docs/HANDOVER.md index e9a0d7a..0a4f760 100644 --- a/apps/events/docs/HANDOVER.md +++ b/apps/events/docs/HANDOVER.md @@ -1,6 +1,6 @@ # Handover — where things stand and how to carry on -Last updated: 2026-10-28, after **1.49.2** (and Hub 1.5.0). The plan itself is in +Last updated: 2026-10-28, after **1.50.0** (and Hub 1.5.0). The plan itself is in [ROADMAP-v2.md](./ROADMAP-v2.md) (decisions table at the end); the previous round of features is in [FEATURES-ROUND-1.md](./FEATURES-ROUND-1.md). @@ -14,6 +14,7 @@ encrypted settings unreadable or break existing installs. | Version | What | |---------|------| +| 1.50.0 | **Accessibility pass** (§11, WCAG 2.2 AA) on public pages, auth, registration, payment, My Events and the kiosk: skip link, focus ring, labelled fields, named quantity buttons, announced errors, `ModalOverlay` popups (focus trap, Escape), contrast and underlined in-text links, reduce-motion; Branding warns about a too-light primary colour. axe + keyboard e2e in `e2e/accessibility.spec.ts` | | 1.49.2 | **Saved filters** (§9 part 3) on registrations, users, events and reports (`/api/saved-filters`, `components/shared/SavedFilters.tsx`). Migration `20261028180000_saved_filters` | | 1.49.1 | **Bulk actions** on Manage registrations (§9 part 2): message, mark paid, move ticket, allocate, export, cancel (`POST /api/registrations/bulk`, `utils/bulkRegistrations.js`). Migration `20261028170000_registrations_bulk` | | 1.49.0 | **Dashboard and command palette** (§9 part 1): Today and Waiting for you on the staff/supervisor/admin dashboards (`GET /api/dashboard/today`), Ctrl+K palette (`GET /api/dashboard/search`, pages in `lib/commandPages.ts`), deep links on events/registrations/users | @@ -58,9 +59,12 @@ encrypted settings unreadable or break existing installs. Hub 1.1.0 is deployed with update requests rolled out, and `scripts/install.sh` has been tried on a test server (both done 2026-10-28). -1. **1.50.0 — Accessibility pass (WCAG 2.2 AA)** (§11), then **1.51.0 — TypeScript backend, OpenAPI - and `/api/v2`** (§14), then **2.0.0 — AI helpers** (§15). Languages (Afrikaans, §10) are removed - from scope (2026-10-28). +1. **1.50.1 — pagination and search on long lists**: check the Audit log and the other pages whose + data grows large (registrations, users, payments, messages, access/consent logs, background + jobs, webhooks deliveries …) for server-side paging, search and filters, and add them where + missing (Joshua, 2026-10-28). +2. **1.51.0 — TypeScript backend, OpenAPI and `/api/v2`** (§14), then **2.0.0 — AI helpers** (§15). + Languages (Afrikaans, §10) are removed from scope (2026-10-28). ## Working on this repo @@ -417,6 +421,21 @@ a test server (both done 2026-10-28). page to `PAGES` (and the component's `page` type), then pass the values in and apply them out. - e2e `saved-filters.spec.ts` (deletes what it saves). +## Accessibility (1.50.0) + +- **Popups:** use `components/shared/ModalOverlay.tsx` (`labelledBy` = the heading's id, `onClose`, + `closeOnBackdrop`) instead of a bare `fixed inset-0` div — it gives the dialog role, focus trap, + Escape and focus return. Radix `ui/dialog` is fine too. +- **Fields:** tie every visible `