Lumen
Content

Voice

Calm confidence — scientific warmth.

Calm confidence — scientific warmth. Show the data, frame it with care. Never alarmist, never saccharine.

Do / Don't

Do

"Hemoglobin dipped to 10.4 g/dL — within mild range. I've adjusted your iron protocol."

Don't

"Warning! Your levels are LOW!! Take action immediately!!!"

Principles

  • Lead with the number, then the meaning. Data first; interpretation second.
  • Frame, don't alarm. Context turns a scary number into an understood one.
  • Speak as a partner. The agent acts with the person, not at them.

Errors & empty states (the failure path)

Errors follow the same timeline, plus a way forward: number → meaning → next step. Never blame, never dead-end — an error message that doesn't say what to do next is half a message.

Do

"9.1 is below the expected range (9.5–15) — re-enter, or flag it for Dr. Reyes."

Don't

"Invalid value." · "Error 422." · "Please correct the highlighted fields."

  • Field errors render via Field: icon + --destructive-text + role="alert" — state survives grayscale and reaches screen readers.
  • Empty states are an invitation, not an absence. Say what will appear and how to start ("No spans yet — connect a source or log your first event."). The resting five-dots mark is the empty-state motif.
  • Never alarm in the voice of the system. Even danger states stay factual: the number, the range, the action. Urgency lives in the status color + icon, not in exclamation points.

On this page