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
- Archetype: wizard. One question per page, a back link on every page, a task list for the spine rather than a progress bar, and a check-your-answers page before anything is sent.
- Data stance: prose-first. The only figures are the fee, the date and the head count, and each one reads as a sentence rather than as a cell.
- Density: GOV.UK default. 19px body text, a two-thirds measure inside a 960px page, and the 5px spacing scale (5, 10, 15, 20, 25, 30, 40, 50, 60).
- The one bold thing: nothing is decorated and every edge is finished. One question per page to the GDS pattern (question is the
h1and the label, error summary linked to the fields and focused, "Error: " in the title, what was typed kept), and every date is worked out from one fixed "today" (Thursday 29 October 2026): earliest and latest visit, call-back, results within 10 working days of the chosen visit, answers saved for 28 days. Changed 2026-10-29: the first version had no script at all. A journey in one file needs a stand-in for the server, so a short inline script routes by hash and validates; each page is still a real<form>with a submit button, a redirect replaces history so Back never bounces, andenhancement_lint.pystays clean. The start page is plain HTML. Round two, 2026-10-29: the start page now follows the GOV.UK start-page layout. A caption above the title, then a three-row fact list (fee £128.50, 5 minutes, results 19 November) in the two-thirds, and a step-by-step "What happens next" in the one-third (call-back Monday 2 November, visits Thursday 5 November to Thursday 10 December, results within 10 working days). All plain HTML, so it stands with JavaScript off; the script hides the one-third on every other route. The phase banner is one baseline-aligned row.
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:
| Pair | Ratio | Where |
|---|---|---|
--govuk-text #0b0c0c on --govuk-body-background #ffffff | 19.59:1 | every word of the question, the hint and the answers |
--govuk-white on --govuk-green-primary #0f7a52 | 5.35:1 | Continue, Accept and send |
--govuk-error #ca3535 on #ffffff | 5.16:1 | the error summary and the field message |
--govuk-focus-text on --govuk-focus #ffdd00 | 14.54:1 | every focused control |
--govuk-blue-shade-50 on --govuk-blue-tint-80 | 9.13:1 | the In progress tag |
--govuk-black-tint-25 on --govuk-black-tint-95 | 8.14:1 | the Cannot start yet tag |
--govuk-input-border on #ffffff | 19.59:1 | the 2px control boundary (SC 1.4.11) |
--govuk-white on --govuk-blue-primary #1d70b8 | 5.17:1 | the Not started tag |
Deviations
- Buttons take
--govuk-green-primary. The functional theme emits no button colour, and the palette green is the nearest published value; white on it measures 5.35:1. - One theme. GOV.UK publishes light only, so light is what ships.
- A script stands in for the server. Each page has its own
h1and its own title, and focus moves to the heading (or the error summary) on every page.
Round eight, 2026-10-29
- Empty right third beside the design notes (1440). Real. The notes sat in a
col-two-thirdswith nothing in the other column, while the start page uses its one-third for "What happens next" and "Related". The notes now carry the sameRelatedlist in acol-one-thirdaside (Start the service, Every page in this service, Accessibility statement), under the system's 5px brand rule. The two-thirds measure is unchanged. It stacks under the notes below 769px. - Two phone numbers. Real: the footer said 01634 960 100, the body and the script said 01634 960 118. The footer now reads "Water team: 01632 960 118" (see round nine for the number), so the page carries one number everywhere.
- "Make Start now the hero". Declined as a change. Since round two the first screen at 1440 already shows the title, the three facts and Start now with the step-by-step beside them, and GOV.UK gives this system the least visual licence: the decisive moment is that one green button and the three figures that tell the householder what it costs and when, and decoration would be a deviation. At 390 the button sits at the fold by design of the pattern (title, lede, facts).
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.
- The council number was a real exchange (severity 3 for a real reader). 01634 960 118 is a Medway number; the page now uses 01632 960 118, inside the range Ofcom reserves for drama, to match the example numbers the telephone error already gave. The footer, every link and the script agree.
- The declaration cited a law that does not say it. "An offence under the Private Water Supplies Regulations 2016" is replaced by the GOV.UK wording: the details are correct to the best of your knowledge.
- Saved answers contradicted the cookies page. The cookies page said answers last until the window closes; the start and saved pages said 28 days. The cookies page now names the one cookie and the 26 November deletion date, and the saved page says how to carry on (open the service on the same device, Start now, the task list is waiting).
- Error messages carried an invented warning triangle. Removed. The bold red text, the "Error:" prefix for a screen reader and the red bar are the pattern.
- Hint paragraphs doubled the gap (a 20px paragraph margin inside a 15px hint). The date question's two paragraphs now sit 10px apart and the last has no margin.
- Type was in px. Every font size is now rem and every line height unitless, so the page follows the size the reader chose in the browser. At 150% text on a 320px screen the start page used to scroll sideways because the three figures were set no-wrap; they wrap now.
- Measured values brought to the live component: inset text 10px bar, panel 5px border and 15px/35px padding, footer 10px rule, caption 21/24px (27px on the start page), the radio hint tucked 5px under its label, the back chevron sized in em so it stays on the text at any zoom.
- Start page figures: label and figure stay together and centre against the note beside them, where before a three-line note pushed "19 November" away from its label.
- Text wrapping: headings and the service name balance (no lone "test"), paragraphs avoid widows.
- Print: the confirmation prints without the portfolio links, buttons, page list and notes, and the green panel prints as a black outline.
- Notes panel: the table has two columns, not three with an empty one, giving the text 30px.
- The page weight claim said 70 KB and the file was 73 KB; it now says under 80 KB.
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.
- A half-typed answer could be sent (severity 3). On the check page, Change on the date, type 99 in the day box, then Save and come back later: the section still counted as done, and the check page showed "Sunday 7 February 2027", a date nobody typed, ready to send. Save now drops an answer that would be sent back from the done list, and a section counts as done only while its stored answer still passes its own checks (so the task list and the check page agree).
- The safety line was last (severity 2). "Do not run any tap for 6 hours before the visit" sat below four paragraphs on the confirmation. It is now the first thing under the panel.
- Sent with no way back (severity 2). The confirmation now has "If something is wrong": ring the water team and give the reference number.
- Who cannot use the service came after Start now (severity 2). The sentence about water-company supplies is now under the lede, above the button. The button still ends at 885px at 1440x900.
- One fact stated two ways (severity 1). "How long it takes" and "What it costs" repeated the fee, the five minutes and the 26 November date already in the three facts above. Both sections removed.
- The page never named its "today" (severity 1). The design notes now say every date is worked out from Thursday 29 October 2026. Every date was re-derived: 2 Nov Monday, 5 Nov and 10 Dec and 19 Nov and 26 Nov Thursdays, 21 Nov Saturday, 12 Nov Thursday plus 10 working days is 26 Nov.
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.
- Fix. The out-of-area page now follows the "you cannot use this service" pattern: what happened (the h1), why (the postcode is in another council's area), and where to go instead, under "Where to go instead" and "If the postcode is wrong". The page links to Find your local council on GOV.UK. The Change the postcode link stays for a typing slip, and the water team phone stays for a resident who thinks the postcode is ours. The old promise to name the right council is gone.
- New sentences. "Find your local council on GOV.UK. Enter your postcode and it shows which council covers it. That council can tell you what to do about testing your water." The link goes to https://www.gov.uk/find-local-council, a generic route true everywhere in England. Also new: the two h2 headings and "If you think your supply is in the Wealdshire district, ring the water team on ...".
- Inventions. No other council, phone number or fee is named. The claim that another council can advise on water testing is generic and assumes only that private supplies are a council matter.
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".
- Fix. The GOV.UK "Complete multiple tasks" pattern calls each row a task, so the counter now reads "You have completed N of 4 tasks." (index.html:1282). The page-map notes say "Four tasks. The first three can be done in any order; the last cannot start yet." (1448) and "Two of the four tasks completed." (1449). Every count now agrees with the four rows the reader sees; the check-and-send row stays a task that cannot start until the other three are completed.
- Left as the system has it. No way back after "Application sent" (severity 1): the pattern (design-system.service.gov.uk/patterns/confirmation-pages/) requires a reference number, what happens next and when, contact details, next-step links, a feedback link and a way to save a record, and no undo or edit control. It asks services to cope with a bookmarked return, which this page does by redirecting to the task list. The page already gives the water team phone and the reference number.
- Left, not the system. The page map and design notes under every route are the portfolio device (see the Related list above); removing them would remove the index of states.
- Inventions. None.
- Status wording. The not-started tag reads "Not yet started", the current GOV.UK task list wording (changed by the orchestrating session after the builder flagged it).
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).
- Fix, which and why. Moved both blocks out of the service into one portfolio band below the GOV.UK footer (
#portfolio,hiddenby default), reached by a single link in the footer ("Portfolio: every page in this service and the design notes", route#/portfolio). Chosen over "start page only" because the start page is the service's front door and would still be 2,000px of portfolio furniture; a band that exists only on its own route leaves every service page, the start page included, as a service would ship it. The band shows only on#/portfolio; any other route hides it again, so no question page carries it. Every route stays reachable: the page-map links are unchanged and each opens its page with earlier answers filled in, and the footer link is on every page. The header "All pages in this service" link is removed so there is one way in; the header "Portfolio" link to the portfolio home stays. The notes' Related list drops its link to the map, which is now above it. The band keeps its own focus: route#/portfoliosets the title, focuses the map heading and scrolls the band into view, and leaves the page above as it was (state is not reset). Print hides the band and the footer link. Start page at 360 is now 2,815px (was 6,987). - Caption spacing.
.captionkeeps the 5px bottom margin at tablet and desktop too (the 641px rule set it to 0), the value the system already used on phones. Gap measured at 1440 on the start and question pages: 5px (was 0). - Untouched. Error summary, focus and the "Error: " title: verified unchanged by driving the Saturday error page from the band at all four widths.
- Inventions. None beyond the footer link wording.