Repository Public License
1<!--2ORIX Audio3File: docs/reports/accessibility.md4Author: Simon-Pierre Boucher5Contact: contact@spboucher.ai6-->78# Accessibility Report910**Date:** 2026-11-20 · **Basis:** code review and the iOS 26.5 simulator · **Not done:** an audit with VoiceOver, Switch Control or Voice Control on a physical device, and no testing with people who rely on assistive technology.1112This is a self-review. It lists what was built and what is known to be missing.1314An automated XCUITest accessibility audit (contrast, Dynamic Type, clipped text, element descriptions) was started after this review was written. Its raw output is [`accessibility-audit.txt`](accessibility-audit.txt); where that file and this page differ, the audit output is the evidence. Its findings and the fixes made in response are summarised in `RELEASE-REPORT.md`, not here.1516## VoiceOver1718| Element | Behaviour |19|---|---|20| Record button | "Start recording" / "Stop and save" |21| Pause, marker, transport buttons | labelled; the marker button also has a long-press for the marker list |22| Recording timer | label "Recording duration", value in minutes and seconds |23| Level meter | one element: "Input level", value "−12 decibels full scale peak" or "Clipping" |24| Live waveform, live spectrogram | labelled; contents are not described |25| Spectrum plot | value announces the dominant frequency and its level, or "No signal" |26| Band meters and band legend | each band named with its range and level |27| File waveform | adjustable: swipe up or down moves the playhead 5 s; value gives the position |28| Spectrogram | label plus the palette and dB range |29| Metric tiles | label, value and unit read as one element |30| Section titles | exposed as headers |31| Transcript lines | combined element; "Play from here" custom action; current line marked selected |32| Notes points | hint says whether tapping plays the source or that no source was found |33| Library rows | combined element with title, date, duration and status |34| Charts | loudness, average spectrum and activity timeline have labels; the activity timeline gives the segment count |3536## Colour and contrast3738- **No information by hue alone.** Bands are named next to their colours wherever they appear. Status chips pair colour with a symbol and a word. Findings have a symbol and a title.39- **Waveform without colour vision:** the "Band shares" style encodes the same measurement as stacked segment heights; "Amplitude" and "RMS and peak envelope" use no spectral colour.40- **Spectrogram palettes:** Monochrome, High Contrast and Colorblind-friendly (cividis anchors) are selectable; five palettes are tested for monotonic lightness, so magnitude reads as brightness as well as hue.41- **Plots keep a dark background in light appearance**, so plot contrast does not depend on the appearance.42- Text uses the system's semantic sizes on the app's own colour tokens. Contrast was not measured by hand; the automated audit flags the pairs that fail, and the secondary text colour has since been darkened (light) and lightened (dark) in response.4344## Dynamic Type4546Text is built from text styles and scales. Known weak spots:4748- Plot axis labels and the band legend are fixed at 8–10 pt. They are supplementary to VoiceOver values and readouts but do not grow.49- The recording timer is a fixed 60 / 76 pt with a minimum scale factor.50- Metric tiles wrap labels to two lines and shrink values to 60 %; at the largest accessibility sizes some values will be tight. Not checked at every size.5152## Motion5354With Reduce Motion, the live waveform updates five times a second and the live spectrogram four times instead of 60 and 30, and the record button changes shape without a spring. There are no parallax or decorative animations.5556## Haptics and alternatives5758Haptics mark start, pause, resume, marker and save. Each has a visible counterpart (state chip, marker count, timer), so nothing depends on feeling a tap.5960## Input6162- Every control is a standard SwiftUI control and is reachable by keyboard focus and Switch Control in principle; this was not exercised.63- Timeline gestures (pinch, drag) have non-gesture equivalents for the essentials: transport buttons, marker navigation, "Show the whole recording", and the adjustable action on the waveform. **Selecting a range has no non-gesture alternative**; that is a gap.64- No custom keyboard shortcuts are defined for iPad hardware keyboards.6566## Language6768English and French (Canada) throughout, including accessibility labels and permission prompts.6970## Gaps, in order of importance71721. No device audit with VoiceOver.732. Range selection requires a drag.743. Plot contents (the shape of a waveform, the picture in a spectrogram) are not conveyed non-visually beyond summary values. The analysis panel carries the same information as numbers.754. Fixed-size plot labels.765. No hardware-keyboard shortcuts.776. Contrast ratios not measured.78