← Back to the screen

Design system portfolio

Design record: Apply for a private water supply test

The four direction lines behind this page, the generator command that produced its tokens, and the pairs it was measured against.

A householder on a private borehole applies to Wealdshire District Council for a sampling visit. The whole journey runs on the one page: start page, task list, five question pages, check your answers, confirmation panel, plus the save page and the out-of-area page. Every error page is reached by making the mistake. A list at the foot opens any page with earlier answers filled in.

Direction

Generator

govuk_tokens.py --theme palette
govuk_tokens.py --theme functional
govuk_tokens.py --type --spacing
govuk_tokens.py --contrast

tokens.css is the first two, unedited. The type scale and the 5px spacing scale come from the third and are authored in the page's own <style>, because the generator publishes them as a table rather than as custom properties.

Measured contrast

contrast.py from web-design/scripts, WCAG 2.2:

PairRatioWhere
--govuk-text #0b0c0c on --govuk-body-background #ffffff19.59:1every word of the question, the hint and the answers
--govuk-white on --govuk-green-primary #0f7a525.35:1Continue, Accept and send
--govuk-error #ca3535 on #ffffff5.16:1the error summary and the field message
--govuk-focus-text on --govuk-focus #ffdd0014.54:1every focused control
--govuk-blue-shade-50 on --govuk-blue-tint-809.13:1the In progress tag
--govuk-black-tint-25 on --govuk-black-tint-958.14:1the Cannot start yet tag
--govuk-input-border on #ffffff19.59:1the 2px control boundary (SC 1.4.11)
--govuk-white on --govuk-blue-primary #1d70b85.17:1the Not started tag

Deviations

Round eight, 2026-10-29

Round nine, 2026-11-09

Held against the live GOV.UK stylesheet (the same v6 values this system's generator emits) and walked end to end as the householder: start, every question, an error on every field, change links, confirmation, at 360, 390 (mobile emulation, 3x), 320 and 150% text, and every width from 320 to 1920 in 10px steps across all 23 routes (no horizontal overflow at any). Ten-heuristic score 32 before, 35 after.

Left alone: the order and wording of the questions, the dates (every one still comes from Thursday 29 October 2026 and was re-derived: 5 November first visit, 10 December last, call back by Monday 2 November, results 19 November, answers kept to 26 November), and light only.

Round ten, 2026-11-09

A second, colder read. Ten-heuristic score 33 before, 36 after (round nine said 35; the save defect below was passed by it). Driven at 1440, 1920, 390 and 360 (mobile emulation, 3x), light and dark (the page ships light only, so both match), after the last edit.

Left: an error summary link on a phone scrolls the field to the top and the question scrolls away (severity 1, the GOV.UK component does the same). The task list counts four sections including the send step (taste).

Inventions: the line "To change your answers, ring the water team ... and give your reference number" assumes the team can change an application by phone; the brief gives no change rule.

copy-lint.ignore: none exists for this page.

Round thirteen (2026-11-10)

The independent reviewer named the out-of-area dead end as the only content gap (severity 1). A valid postcode outside Wealdshire (GU27 3AA, reproduced at 1440, 390 and 360) ended on a page whose only way forward was ringing the council that cannot help, with a promise ("we will tell you which council to contact") and no link.

Round fifteen (2026-11-10)

The independent reviewer found one fact stated two ways (severity 1). The task list said "You have completed 0 of 4 sections" and showed four rows, while the page map said "Three sections you can do in any order". Reproduced at 1440: counter "0 of 4 sections", four rows (three Not started, one Cannot start yet), map note "Three sections".

Round seventeen (2026-11-10)

The independent reviewer (ship note, sev 1) found the portfolio's "Every page in this service" index and the design notes under the form on every route, which no GOV.UK service would ship: the start page was 6,987px at 360. Reproduced at 360, 390, 1440 and 1920: both blocks visible on all twelve routes. Also reproduced: at 1440 the caption "Private water supplies" sat 0px above the h1 (5px at 390 and 360).