Health questionnaire

A React block (a whole screen) in Beamline's Clinic app.

A patient's medical history as a versioned questionnaire. Every question takes Yes, No or I don't know, and one not answered says so, never read as No; a Yes opens its follow-up, which is then required. Sections show how many of their questions are answered; the form reads in the chosen language. Earlier versions sit on a rail with their dates and who signed them; a signed one opens read only, and a history signed over a year ago says to update it. A draft saves the answers but isn't a reviewed history; a provider signs it once nothing is missing (what is, is listed), and a refused save keeps the answers. The provider's panel lists what changed since the last signed history (was → now, a question's old answer also said under it) and every question still to answer, each opening its section.

Use it for

Taking or updating a patient's medical history at a visit, with a provider's review.
Any questionnaire where unknown must stay apart from no and versions are kept.

Not for

A general multi-step form (step-form).
Configuring which forms clients get (client-forms).

Anatomy

header: the product's mark, the title and patient, the form language
stale notice: when the last signed history is over a year old
versions: this visit, then earlier versions with date and signer
sections with answered counts; questions with Yes, No or I don't know, not answered said, the follow-up after a Yes
review: answered count, what's missing, save as draft, the provider, sign as reviewed

States

question: not answered (dashed), yes (warning edge), I don't know (info edge), no
follow-up: needed with a Yes
section: some answered (warning) or all (success)
version: this visit (new, draft or signed), earlier (read only)
draft saved (not a review); signed; refused (answers kept)
stale: said
phone: one column, the questions first
right to left: the layout mirrors
reduced motion: nothing animates

Keyboard

Tab through versions, sections and each question's choices; arrows move within a question's choices; Tab to the review

Motion

Nothing moves. Nothing runs at rest.

Props

Prop	Type	Default	Description
`patient` (required)	`string`	—
`sections` (required)	`HealthSection[]`	—
`languages` (required)	`{ id: string; label: string; }[]`	—
`defaultLanguage`	`string`	—
`versions` (required)	`HealthVersion[]`	—	Earlier versions, newest first; signed ones are read only.
`draft`	`HealthVersion \| null`	—	This visit's draft, if one was saved.
`providers` (required)	`{ id: string; name: string; }[]`	—
`now`	`string`	—
`onSaveDraft`	`((answers: Record<string, HealthAnswer>) => Promise<unknown>)`	—
`onSign`	`((answers: Record<string, HealthAnswer>, providerId: string) => Promise<unknown>)`	—	Sign this visit's answers as reviewed; reject with the reason to keep them.
`product`	`string`	—	Your product's name, shown as its mark.
`className`	`string`	—	Classes on the documented visual root; no override by default.
`ref`	`Ref<HTMLDivElement>`	—	Receives the documented native target or imperative handle; omitted by default.

Built from

Import

import { HealthQuestionnaire } from "@beamline/health-questionnaire";

Get it

Health questionnaire is part of Beamline UI. Install the parts you need in your React app as compiled packages or editable source. Get Beamline · Connect your agent