Simple Healthcare
Core components

The building blocks, audited

Every component on the checklist, mapped to what our products ship, with a live example and an honest check against each item.

31 components185 checklist items
Met
166
of 185 checklist items
Partial
7
of 185 checklist items
Missing
12
of 185 checklist items

How to read this page

Status on each component says whether a shared component exists and is in production use. The checklist under it grades the component against the Design System Checklist items by reading its code, not its intent. Partial means the behavior is there but incomplete or not exposed as a prop.

Cross-cutting gaps

prefers-reduced-motion is now honored by Toast, Tooltip, Modal, Loading, Skeleton, and Button's loading spinner, but not yet by the remaining animated components, like Dropdown/Menu's open transition. Icon-only close buttons now all have accessible names (Toast, Modal, and Tag).
AdoptedDraftProposedNot started
Actions and navigation

How the reader moves and acts.

Button

Adopted

Interactive element used for single-step actions.

Ships asButton

Translucent variant, for a secondary action on a dark surface
Icons
As a link
Active state
The held button carries aria-pressed="true". Press and hold any button above to see the transient press feedback.
Loading state
Loading sets aria-busy and aria-disabled but leaves the button focusable, so the state reaches whoever just pressed it. The spinner takes the leading icon's slot, so a button that has one does not change width.
  • ColorsMetTen solid and nine outline colors plus link, ai, and translucent. More than a semantic system needs; the Foundations semantic roles would cut this to six.
  • VariantsMetSolid, outline, and link. variant="translucent" is a white wash (15% at rest, 25% on hover, 35% held) with white text, for a secondary action sitting on a dark blue surface like a hero, next to a solid primary. Its focus ring drops the offset so it doesn't cut a white gap into the dark surface.
  • SizesMetsm, md, lg.
  • Icon supportMeticon and iconRight props size themselves to the button. Dropping the label squares the padding for an icon-only button; aria-* props are forwarded, so aria-label gives it a name.
  • Hover stateMet
  • Active stateMetactive holds the button a shade past its hover and sets aria-pressed. Press feedback on every variant via active:brightness-95.
  • Loading stateMetloading shows a currentColor spinner in the leading icon slot, so a button with an icon keeps its width. Sets aria-busy and aria-disabled and forces type=button, rather than disabling, so focus and the announcement stay with the user. loadingText swaps the label.
  • Disabled stateMetopacity-50 and the disabled attribute. A disabled href button falls back to a real button.
  • Accessibility roleMetRenders <button> or next/link <a> based on href.
  • Focus indicatorMetfocus-visible:ring-2 in the variant's own color, so the ring answers the keyboard and stays off on mouse click.

Tabs

Adopted

Navigation between multiple pages or content sections.

Ships asTabs (uncontrolled), TabLinks (controlled)

Median negotiated rate across in-network plans.

Median negotiated rate across in-network plans.

Rates panel. Arrow keys, Home, and End move focus and selection between tabs.

  • Content compositionMetPanels are children matched by index.
  • VariantsMetdefault, pills, underlined.
  • Selected stateMetaria-selected on the trigger.
  • Disabled stateMet
  • Icon supportMetOptional icon per tab, rendered ahead of the label. TabLinks shares the same Tab type but does not render it yet.
  • Equal width layoutMetfullWidth stretches the tab list and centers each label.
  • Keyboard supportMetArrow keys, Home, and End move focus and selection with a roving tabindex, skipping disabled tabs and wrapping at the ends. IDs are generated per instance with useId(), so aria-labelledby/aria-controls resolve to real elements even with multiple Tabs on a page.

Category toggle

Draft

Segmented control for switching between exactly two categories, like Physicians and Facilities. Not on the checklist; graded against the Tabs items.

Ships asCategoryToggle

Searching for

Two categories only

Use this when the reader picks between exactly two categories. If a third is ever needed, switch to Tabs instead; a segmented control with three or more options gets cramped and loses its either/or meaning. For an on/off setting, use the Switch.
  • VariantsMetsolid (blue selected pill on a white track) for white surfaces, inverse (white selected pill) for blue ones.
  • Selected stateMetrole=radiogroup with role=radio and aria-checked on each segment, so the pair reads as one choice.
  • Icon supportMetOptional icon per option, rendered ahead of the label.
  • SizesMetsm and md.
  • Keyboard supportMetRoving tabindex. Any arrow key moves to the other option; Home and End jump to the first and last.
  • Accessibility labelMetaria-label, or aria-labelledby when a visible label sits beside it, names the group.
  • Disabled stateMissingNot needed yet; there is no case for a category that can be shown but not chosen.

Pagination

Adopted

Enables a selection from a range of pages.

Ships asPagination

  • Selected page stateMetHighlighted blue and re-selecting is a no-op. aria-current reaches the DOM now that Button forwards aria-* props.
  • Page display rangesMetTwo pages either side of the current one, with ellipses.
  • Amount of items per pageMetpageSize, pageSizeOptions, and onPageSizeChange render the shared Dropdown. Opt-in: omit them and the control does not render.
  • Indeterminate amount of pagesMethasMore adds a load-more control.
  • Full page label announcementsMetaria-label="Page n" now lands on the button.
  • State announcementMetA visible "Page n of m" label (plus "+" under hasMore) doubles as a role=status region, so it announces on every page change for screen readers too.
Forms

How the reader tells us things. Native inputs are styled by element in base.css; the richer pieces are components.

Text field

Draft

Form field to enter and edit single-line text.

Ships asTextField

Icon, prefix, and suffix
$
/ mo
Sizes

We will never share this

  • LabelMetlabel renders a real <label htmlFor>, paired to a generated id when none is given.
  • Error stateMeterror reddens the border and sets aria-invalid; errorMessage renders below with role=alert, wired up via aria-describedby.
  • Disabled stateMet
  • PlaceholderMetNative placeholder passes through.
  • Helper textMethelperText renders below the field, aria-describedby-linked, unless an error message is showing instead.
  • Icon supportMeticon renders a leading Icon, mutually exclusive with prefix. Password (below) still owns the trailing show/hide case.
  • Prefix / SuffixMetprefix and suffix render fixed text or an element on either side, e.g. a currency symbol or a unit.
  • SizesMetsize takes sm, md (default), or lg, matching Select's scale.
  • Accessibility labelMetNative <input>; aria-label and other aria-* props pass straight through.

Text area

Draft

Form field to enter and edit multiline text.

Ships asTextArea

Visible to the advisor assigned to this case

  • LabelMet
  • Error stateMeterror reddens the border and sets aria-invalid; errorMessage renders below with role=alert.
  • Disabled stateMet
  • PlaceholderMet
  • Helper textMethelperText renders below, aria-describedby-linked, unless an error message is showing instead.
  • SizesMetsize (sm/md/lg) sets padding and text size; rows sets height; resize-y still lets the reader grow it further.
  • Accessibility labelMet

Select

Adopted

Choose a single value from a list of options. The shared Dropdown also does multi-select, search, and async options.

Ships asDropdown; native <select> styled by base.css

Clicking this label focuses and opens the field โ€” try it.
Icon and prefix
Sizes
Translucent variant, for a secondary control on a dark surface
Error state and helper text

Applies to all dependents on this plan

  • LabelMetid now lands on a real (visually hidden) button rather than the div trigger โ€” a div is not a "labelable" element, so a label's click never reached it. Clicking an external <label htmlFor> now opens the field and focuses it.
  • Error stateMeterror reddens the border and sets aria-invalid; errorMessage renders below the field with role=alert and is wired up via aria-describedby.
  • Disabled stateMet
  • PlaceholderMetPlus a clear control to return to it.
  • Helper textMethelperText renders below the field, aria-describedby-linked, unless an error message is showing instead.
  • Icon supportMetOptions can carry an icon, and icon now adds a leading icon on the field itself, in both the closed trigger and the search input.
  • PrefixMetprefix renders fixed text or an element before the value (e.g. "$"), positioned the same way as icon and mutually exclusive with it.
  • SizesMetsize takes sm, md (default, pixel-identical to before), or lg.
  • VariantsMetvariant="translucent-blue" restyles the field and its menu as a translucent white wash on a dark blue surface, for a secondary control where the default white field would sit white-on-white. Text, placeholder, tags, and option states are all re-tinted. The error border and message keep their red.
  • Accessibility labelMetThe field now carries role=combobox with aria-expanded/aria-haspopup/aria-controls, the popup is role=listbox, and each row is role=option with aria-selected. aria-label and other aria-* props pass through. Arrow, Home, End, Enter, and Escape keys work.

Checkbox

Draft

Form field used to select one or multiple values from a list.

Ships asCheckbox, CheckboxGroup

Indeterminate ("select all")
Checkbox group
Accepted networks
  • LabelMetlabel renders inside the same <label> as the box, so clicking either toggles it.
  • Checked stateMetA custom box driven by a real (visually hidden) input, so :checked and keyboard behavior stay native.
  • Error stateMeterror reddens the border; errorMessage renders below with role=alert.
  • Disabled stateMet
  • Indeterminate stateMetindeterminate is set imperatively on the DOM node โ€” there is no HTML attribute for it โ€” and rendered as a dash.
  • Checkbox groupMetCheckboxGroup wraps role=group with a legend, wiring shared value/onChange across its options.
  • Keyboard supportMetNative input: Space toggles, Tab moves focus.

Input radio

Draft

Form element for selecting one option from a list.

Ships asRadio, RadioGroup

Rate type
Rate type (row layout)
With an error
  • LabelMet
  • Checked stateMet
  • Error stateMetRadioGroup reddens every option's border and renders errorMessage below with role=alert.
  • Disabled stateMetPer option via the group's options array, or for the whole group at once.
  • Radio groupMetRadioGroup renders role=radiogroup with a legend and shares one name across its options, which gets arrow-key navigation and single selection from the browser for free.
  • Keyboard supportMetNative input grouping.

Switch

Adopted

Toggle for immediately changing the state of a single item.

Ships asToggle

Small, external label
  • LabelMetlabel renders a real <label htmlFor>, pairing to a generated id when none is given.
  • Checked stateMetrole=switch with aria-checked.
  • Disabled stateMet
  • Keyboard navigationMetNative button.
  • Accessibility labelMetaria-label prop, or the sr-only "Toggle" fallback when neither it nor label is given.

Calendar

Draft

Grid of days in one or more months for picking a date or a range.

Ships asCalendar

Single date

Selected: November 18, 2026

November 2026
SunMonTueWedThuFriSat

November 2026. 11/18/2026 selected

Range

None โ€“ None

November 2026
SunMonTueWedThuFriSat

November 2026. No dates selected

  • Display modesMetmode="single" or "range"; range mode highlights the span between the two chosen endpoints.
  • Selected stateMetaria-selected on the day button, plus a distinct ring marking today.
  • Month selectionMetMonth and year <select> jump straight to any month, alongside prev/next buttons.
  • Day namesMetLocale-aware abbreviated weekday header, reordered to the locale's first day of week.
  • InternationalisationMetlocale drives month/weekday names and, where the runtime supports Intl.Locale#weekInfo, the default first day of week; weekStartsOn overrides it explicitly.
  • Keyboard navigationMetRoving tabindex: arrow keys move by day or week, Home/End move within the week, PageUp/PageDown move by month (Shift for year), Enter/Space selects.
  • State announcementMetA role=status live region announces the visible month and current selection; each day button's accessible name is its full date rather than just the number.
Feedback

How we tell the reader what happened, what is happening, and what to watch for.

Alert

Adopted

Prominent message about the whole page or a specific area of it.

Ships asCallout

Heads up

Prices are median negotiated rates and exclude facility fees.

Estimate

Your actual cost depends on your plan and deductible status.

Saved

Your plan has been saved to this browser.
  • ColorsMetNine variants; 800-on-50 text pairs pass AA.
  • Title supportMet
  • Icon supportMetAny icon from the set.
  • Supplementary actionsMetactions renders a dedicated slot below the body, separate from children.
  • ResponsivenessMetBlock element, full width of its container.
  • Accessibility rolesMetrole="alert" for the red variant, role="status" for the rest, so assistive tech announces it on mount.

Toast

Adopted

Notification message displayed above the page content.

Ships asToast via ToastProvider and useToast()

  • Content compositionMetmessage is a ReactNode, so any content (not just a string) can be passed.
  • ColorsMetNine variants.
  • Icon supportMetChosen automatically by variant; not overridable.
  • TimeoutMet5 s default with a close button. addToast(variant, message, {duration}) now overrides it per toast.
  • StackingMetBottom center, newest last, animated with AnimatePresence.
  • Supplementary actionMetaddToast(variant, message, {action}) renders a labeled button next to the close control.
  • Focus managementMetHovering or focusing inside the toast pauses its timeout and resumes it on leave/blur. The close button has aria-label="Dismiss notification".
  • Reduced motionMetuseReducedMotion() from motion/react swaps in a near-instant fade when the system preference is set.

Tooltip

Adopted

Contextual text shown on hover or focus.

Ships asInfo

Median negotiated rate
ย 
  • PositioningMetFour positions via prop, and it flips to the opposite side once open if the preferred side has no room, measured against the actual trigger and tooltip rects.
  • TimeoutMetA 300ms delay before opening keeps it from flashing while a cursor passes over it.
  • Keyboard supportMetThe trigger is a real button, opens on focus as well as hover, and carries aria-describedby pointing at the tooltip content (role="tooltip").

Drawer

Draft

Bottom sheet for small screens: slides up over the page and holds any content, such as a set of filters. Not on the checklist; graded against the Modal items.

Ships asDrawer

Drag the handle down, press Escape, or tap the dimmed page to close.
  • Content compositionMetchildren is anything. The body scrolls when it outgrows the drawer, which caps at 90% of the screen height.
  • Supplementary actionsMetfooter pins below the body (the primary button); action sits opposite the title (a Reset link).
  • Close actionPartialBackdrop tap, Escape, and dragging the handle or header down. There is no visible close button, so put one in action if a screen needs it.
  • PositioningPartialBottom only. Modal covers side sheets.
  • SizesPartialFull width on phones, capped at max-w-lg from md. Height follows content; there is no size prop.
  • Focus trappingMetFocus moves in on open, Tab and Shift+Tab cycle within, and focus returns to the trigger on close. The page behind stops scrolling.
  • Keyboard navigationMetEscape closes from anywhere inside.
  • Title labelingMetrole="dialog", aria-modal, and aria-labelledby from title; ariaLabel names a drawer with no visible title.
  • Reduced motionMetuseReducedMotion() swaps the slide for a fade and turns dragging off.

Loading indicator

Adopted

Animated element that communicates progress without saying how long it will take.

Ships asLoading

Waking up the servers...
Waking up the servers...About 8s left
  • ColorsMetcolor takes blue (default), gray, green, or red.
  • SizesMetsize takes sm, md (default), or lg, scaling the spinner and message text together.
  • Loading durationMetIndeterminate by default with rotating messages; etaSeconds shows a live countdown when the wait time is known.
  • Reduced motionMetuseReducedMotion() drops the spin/orbit/pulse animations, leaving a static mark and message.
  • Accessibility labelMetrole="status" makes the rotating message announce itself; label sets an accessible name for the whole region.

Progress bar

Draft

Bar showing progress for a long task or one with several steps. Range is a slider, not a progress bar.

Ships asProgressBar

Uploading claim documents0%
Refreshing prices
  • LabelMetlabel renders visible text above the bar, wired to it via aria-labelledby; showValue adds the rounded percentage alongside it.
  • SizesMetsize takes sm, md (default), or lg.
  • DurationMetPassing value renders a determinate fill; omitting it shows an indeterminate sliding bar for unknown durations.
  • Accessibility labelMetaria-label covers the case with no visible label. role=progressbar carries aria-valuenow/min/max when determinate, and omits them (per the native <progress> convention) when not.

Skeleton

Adopted

Placeholder that stands in for page elements while their data loads.

Ships asLoadingSkeleton, SkeletonShape

  • SizesMetsize (sm/md/lg) scales bar height, line count stays configurable via lines.
  • ShapesMetThe exported SkeletonShape primitive takes rect (default), circle for avatars, or square for thumbnails.
  • CompositionMetpage, card, and inline variants are built from SkeletonShape, which is also exported to compose custom layouts.
  • Reduced motionMetThe pulse is driven by motion/react's useReducedMotion() instead of the Tailwind animate-pulse utility, so it can be turned off.
Content

Containers and small elements that carry content.

Card

Adopted

Container that groups information about a subject and its related actions.

Ships asCard

With title

Card body. Anything can go here, including other components.

Media and actions

Media on top, a footer bar of actions below.

Clickable card

Clickable card

The whole card links through an overlay; the footer link stays independently clickable.

Without a title the body starts at the top.

  • Content compositionMetOptional title, children, media, and footer slots; any of them can be left out. headingLevel sets h2, h3, or h4 so the title fits the page outline.
  • Media sectionsMetmedia renders full-bleed above the header, clipped to the top corners of the card.
  • Supplementary actionsMetfooter renders a bar below the content that stays clickable. href makes the whole card a link through an overlay anchor named by the title (or linkLabel), so buttons in the footer or body are not nested inside it.
  • ResponsivenessMetFills its container and can shrink inside a grid (min-w-0).
  • Card groupsMetCardGroup is a grid with one shared gap and equal-height rows; columns (1 to 4) collapses to one column on phones.

Accordion

Not started

Toggles the visibility of a content region when its trigger is pressed.

Ships asNative <details>, unstyled

What is a negotiated rate?

The price an insurer and a provider have agreed on for a service. Native details element, unstyled.

  • Active stateMissing
  • CompositionMissing
  • Toggle transitionMissing
  • Content and trigger relationMissing

List

Draft

Displays a list of items.

Ships asNative ul and ol styled by base.css

  • Unordered item
  • Another item
    • Nested item
  1. Ordered item
  2. Second item
  • OrderMetdisc and decimal. Nested lists are handled.
  • Content compositionMet
  • Accessibility roleMetNative elements.

Divider

Draft

Element for visual content separation.

Ships asNative hr styled in this app, not in base.css

Above the rule.


Below the rule.

  • DirectionPartialHorizontal only. Vertical dividers are hand-built with border-l.
  • Accessibility roleMethr has the separator role natively.

Image

Draft

Utility for displaying images and controlling their behavior.

Ships asnext/image

Simple Healthcare mark

next/image with explicit width and height. The mark is an SVG so density is moot; raster images get a srcset.

  • SizesMetwidth and height, or fill with sizes. aspect-ratio via a wrapper class.
  • Image fallbackMissingA broken src shows the browser default.
  • Screen density supportMetnext/image generates srcset.
  • Alt textMetalt is required by the type.

Avatar

Draft

Thumbnail of a user photo, organization, or other content. Likely needed once accounts show a signed-in user.

Ships asAvatar, AvatarGroup

Priya Shah
Jordan Lee
Priya Shah
  • ImageMetA plain img (not next/image, since sources are arbitrary and unknown at build time), masked to the avatar's shape and cropped with object-cover.
  • Image fallbackMetonError catches a broken src and falls back to initials from name, or an icon when there's no name either.
  • SizesMetsize takes xs, sm, md (default), lg, or xl.
  • ColorsMetThe fallback background is derived from name by default (so the same person is always the same color), or set explicitly via color. All six pair white text at AA contrast.
  • ShapeMetshape takes circle (default) or square.
  • Avatar groupsMetAvatarGroup overlaps its avatars with a ring to separate them, and collapses the rest into a "+N" avatar once max is exceeded.
  • Accessibility labelMetrole="img" with aria-label={name} when there's no photo; the img itself carries alt={name} when there is one.

Badge

Adopted

Compact element that represents the status of an object or a user input.

Ships asTag

In networkVerifiedEstimateOut of networkPendingMedicareWith iconWith close
SolidSolidSolidSolidOutlineOutlineOutline
SmallMediumLarge
3 unread notifications3Empty badge renders nothing: []
  • ColorsMetNine variants. Soft pairs are 800-on-100; solid pairs clear 4.5:1 for small text in both themes.
  • VariantsMetappearance takes soft (default), solid, or outline. Outline is a ring rather than a border, so all three are the same size.
  • SizesMetsize takes sm, md (default, what every existing Tag is), or lg.
  • Icon supportMeticon renders a leading icon from the set, sized to the badge. An Icon as a child still works.
  • Dismissible actionMetonClose renders an X with an accessible name, Remove plus the text by default or closeLabel, and a visible keyboard focus ring.
  • Empty stateMetA badge with no content and no icon renders nothing instead of an empty pill. A count of 0 is content and still shows.
  • PositioningMetdot renders a content-free notification dot (label gives it screen-reader text), and TagAnchor pins any badge to a corner of the element it wraps.

Icon

Adopted

Wrapper for SVG assets that controls their appearance.

Ships asIcon

The whole set

All 94 keys on the Icons map, drawn from the map itself. The name under each glyph is what you pass to <Icon icon="..."/>.

  • ArrowDown
  • ArrowLeft
  • ArrowRight
  • ArrowUp
  • Asclepius
  • Bell
  • Bookmark
  • BookOpen
  • Building
  • Building2
  • Calendar
  • Camera
  • ChartBar
  • Chat
  • ChatCircleText
  • Check
  • CheckThin
  • ChevronDown
  • ChevronLeft
  • ChevronRight
  • ChevronUp
  • CircleX
  • CircleCheck
  • Clock
  • Coins
  • Columns
  • Copy
  • CreditCard
  • Database
  • Doctor
  • DotsThree
  • Download
  • Envelope
  • Eye
  • EyeSlash
  • FileText
  • Flag
  • Funnel
  • Gauge
  • Gear
  • Globe
  • History
  • Hospital
  • House
  • Image
  • ImageBroken
  • Info
  • Key
  • Layout
  • LightBulb
  • List
  • LoaderCircle
  • Lock
  • LogIn
  • LogOut
  • Mail
  • Moon
  • Outbound
  • PaperPlane
  • Pencil
  • Printer
  • Plus
  • Question
  • Receipt
  • Refresh
  • Rows
  • Ruler
  • Save
  • Scales
  • SealWarning
  • Search
  • Shield
  • Sliders
  • Sort
  • SortAlphaAsc
  • SortAlphaDesc
  • SortNumAsc
  • SortNumDesc
  • Spark
  • Sparkles
  • Square
  • Stack
  • Star
  • Table
  • TestTube
  • Trash
  • TriangleAlert
  • Undo
  • User
  • Users
  • UserCircle
  • UserFocus
  • Wrench
  • X
  • ColorsMetcurrentColor, so any text-* utility applies.
  • SizesMetsm 16, md 20, lg 28, xl 36.
  • InteractivityMetNever interactive on its own; wrap in Button. Accessible names are the open item on Foundations.
Not on the checklist

Shared components with no checklist counterpart. They follow the same rules; there is just no external list to grade them against.

Range

Slider with role=slider, aria-value*, keyboard steps, and a commitOn prop for drag versus release. The best-instrumented component in the library.

Password

Text field with a show/hide toggle. The toggle has a proper aria-label.

Code

Inline and block code. Block mode has a language badge; syntax highlighting is commented out.

TabLinks

Controlled tab strip with no panels, for routing-driven tabs.

Panel

Flat bordered surface at elevation 1, rounded-lg. Every white box on this site is one.

Table

Read-only data table: blue-900 header on blue-50, gray-200 rules, no vertical lines. A numeric prop right-aligns columns in the mono face.

Chip

Pill label or in-page link. Light on white, dark on a gradient.

IconTile

40px tinted square holding one icon, for section and feature headings.

Gradient

The three Brand gradients as a surface, picked by tone, so nobody composes their own stops.

PageHero

The masthead pattern from Brand: eyebrow, two-tone title, lead, and meta on a gradient, with optional background rings and children. Every page here uses it.

ButtonSpinner

The ring Button shows in its loading state. Its own file (and its own "use client") so Button stays renderable from a server component; not meant to be used on its own.