👋
← Hyzer

Centers for Medicare & Medicaid Services · Medical Bill Rights

Built accessible from the first commit, on a legislative deadline

The No Surprises Act gave people rights about medical bills that most of them did not know they had. CMS needed a portal explaining those rights and taking complaints, live before the deadline in the law. I joined six months out. I was tech lead by the end, after the previous lead was let go a month before delivery. It shipped on time.

Accessibility 2023 via Coforma

Guides routed
27
Pages, EN and ES
54
Shipped in
6 months

The problem

What is broken is the American healthcare system, and this portal does not fix that. It does the next most useful thing. It tells people what their rights are when a bill shows up that they should never have received.

Someone holding that bill is stressed, often unwell, usually on a phone, and not in a research mood. The portal had to get them from “this looks wrong” to the guide that covers their situation, or to a complaint in front of a CMS caseworker. Without reading the legislation first.

What I did

I owned the front-end architecture: the React form layer, localization, field and schema validation on client and server, and the path a complaint takes through Drupal into Salesforce, where CMS agents work the case. Finding the protection that covers you meant reading policy. So I built a wizard that asks about your situation and routes you to the guide that answers it. Twenty-seven guides, English and Spanish, 54 pages behind a handful of questions.

The accessibility work was net new. Nothing had shipped, so nothing needed remediation. The forms, the wizard's branching, and every validation and error state were built to Section 508 and WCAG from the first commit.

The result

It shipped on time, ahead of the deadline the legislation set. It is live at cms.gov/medical-bill-rights.

Being live is the accessibility proof. This is a public form on a federal domain, where Section 508 and WCAG are a legal obligation, and the standard gets checked. Go use it with a keyboard.

The first step of the action plan wizard: a progress bar, the question “Are you having issues with a bill for medical services you received?”, and two radio options, one for someone already dealing with a bill and one for someone planning ahead.
Step one of the wizard. A few questions instead of 27 guides and a search box.
The “Before you get started” step of the complaint form, with a prompt to switch to Spanish, a plain-language summary of the security and privacy agreement, and seven collapsed sections holding the full legal text above an Accept button.
The privacy gate before a complaint. Plain-language summary on top, full legal text behind disclosures, and the Spanish switch in reach on every step.

Let's build.

Tell me where you're stuck and I'll tell you what it'll take.

Book a call