SPB Git

Repository Public License

accessibility.md 4.8 KB

# Accessibility Report

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.

This is a self-review. It lists what was built and what is known to be missing.

An 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; 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.

# VoiceOver

Element Behaviour
Record button "Start recording" / "Stop and save"
Pause, marker, transport buttons labelled; the marker button also has a long-press for the marker list
Recording timer label "Recording duration", value in minutes and seconds
Level meter one element: "Input level", value "−12 decibels full scale peak" or "Clipping"
Live waveform, live spectrogram labelled; contents are not described
Spectrum plot value announces the dominant frequency and its level, or "No signal"
Band meters and band legend each band named with its range and level
File waveform adjustable: swipe up or down moves the playhead 5 s; value gives the position
Spectrogram label plus the palette and dB range
Metric tiles label, value and unit read as one element
Section titles exposed as headers
Transcript lines combined element; "Play from here" custom action; current line marked selected
Notes points hint says whether tapping plays the source or that no source was found
Library rows combined element with title, date, duration and status
Charts loudness, average spectrum and activity timeline have labels; the activity timeline gives the segment count

# Colour and contrast

  • 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.
  • 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.
  • 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.
  • Plots keep a dark background in light appearance, so plot contrast does not depend on the appearance.
  • 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.

# Dynamic Type

Text is built from text styles and scales. Known weak spots:

  • 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.
  • The recording timer is a fixed 60 / 76 pt with a minimum scale factor.
  • 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.

# Motion

With 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.

# Haptics and alternatives

Haptics mark start, pause, resume, marker and save. Each has a visible counterpart (state chip, marker count, timer), so nothing depends on feeling a tap.

# Input

  • Every control is a standard SwiftUI control and is reachable by keyboard focus and Switch Control in principle; this was not exercised.
  • 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.
  • No custom keyboard shortcuts are defined for iPad hardware keyboards.

# Language

English and French (Canada) throughout, including accessibility labels and permission prompts.

# Gaps, in order of importance

  1. No device audit with VoiceOver.
  2. Range selection requires a drag.
  3. 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.
  4. Fixed-size plot labels.
  5. No hardware-keyboard shortcuts.
  6. Contrast ratios not measured.
Files main
Menu

Theme