U.S. flagA digital services project by Flexion

Design System

A USWDS-aligned design system built with CUBE CSS methodology. Semantic tokens, layout compositions, and accessible components.

Foundations

Tokens

Two-tier token architecture: USWDS palette tokens and semantic role-based tokens.

Typography

Font families, type scale, weights, line heights, measure, and heading hierarchy.

Compositions

Layout primitives from CUBE CSS: stack, cluster, center, sidebar, grid.

Base Classes

Shared CSS properties extracted into multi-selector rules.

Rules

Token rules, component rules, and accessibility invariants.

Data Visualizations

Accessibility-first guidance for charts, graphs, maps, and infographics.

Layout

Page layouts (content, sidebar-start, sidebar-end), breakout tracks, and container contracts that guide layouts toward correctness by default.

Layout

Accordion

An expandable/collapsible content section, borderless or bordered.

workingUSWDS-derived

Card

A card groups related content in a container with header, body, media, and footer sections.

workingUSWDS-derived

Collection

A list of structured items with headings, descriptions, and optional metadata.

workingUSWDS-derived

Icon

SVG icon from the USWDS icon sprite. Scales with text by default.

workingUSWDS-derived

List

Ordered and unordered lists with USWDS spacing and an unstyled variant.

workingUSWDS-derived

Prose

Typographic defaults for long-form content with USWDS measure (68ex reading width).

workingUSWDS-derived

Table

A styled data table with support for bordered, borderless, striped, compact, scrollable, and stacked variants.

workingUSWDS-derived

Tab Group

A tabbed interface for switching between content panels. Progressively enhanced from stacked content.

workingUSWDS-derived

Tag

A small label used to categorize or mark items.

workingUSWDS-derived

Feedback

Alert

A colored alert box for informational, warning, success, error, or emergency messages.

workingUSWDS-derived

Change Indicator

Small colored dot (with optional label) marking an item as modified, added, or removed.

workingCustom

Confidence Badge

Compact badge flagging extracted fields that need review. Stays hidden for high-confidence values and surfaces "Review" or "Low confidence" otherwise.

workingCustom

Modal

Dialog overlay with focus trapping, backdrop, and keyboard management.

workingUSWDS-derived

Preview Banner

Full-width warning banner shown on branch-qualified form pages to indicate a non-production preview and that submissions will reference the branch commit.

workingCustom

Semantic Diff

Grouped list of spec changes (added, removed, modified, moved, renamed) with a category badge and human-readable description per change.

workingCustom

Site Alert

A page-level alert for system-wide notices, appearing above content.

workingUSWDS-derived

Spec Diff Browser

Annotated single-column diff of a form spec. Renders the head tree with inline change badges, before/after rows for modified fields, and base-only entries spliced in for removed pages, groups, and fields. Tops the view with an overview strip of change counts and jump-links.

workingCustom

Summary Box

A bordered callout box for highlighting key information or takeaways.

workingUSWDS-derived

Tooltip

Hover/focus information popup with positioning and viewport edge detection.

workingUSWDS-derived

Variant Callout

Prominent callout announcing which LLM variant will run a task, with affordances to change the selection and see benchmarks.

workingCustom

Identity

Banner

Official .gov/.mil banner identifying the site as a government website.

workingUSWDS-derived

Identifier

Agency identification block with logos, required links, and disclaimers.

workingUSWDS-derived

Navigation

Branch Switcher

Dropdown for switching between branches with a filter and an inline create-branch form.

workingCustom

Breadcrumb

A trail of links showing the current page location within a site hierarchy.

workingUSWDS-derived

Footer

Page footer with navigation links, contact info, and agency branding.

workingUSWDS-derived

Header

Site header with logo, primary navigation, and responsive mobile menu.

workingUSWDS-derived

In-Page Navigation

A sticky sidebar table of contents auto-generated from page headings, with scroll spy highlighting.

workingUSWDS-derived

Language Selector

Language switcher with two-language toggle and multi-language dropdown modes.

workingUSWDS-derived

Link

A styled anchor for navigation with optional external link icon.

workingUSWDS-derived

Pagination

Navigation for moving between pages of a multi-page content set.

workingUSWDS-derived

Search

A search form with input field and submit button for finding content.

workingUSWDS-derived

Side Navigation

A vertical navigation menu for navigating related pages within a section.

workingUSWDS-derived

Spec Browser

Two-pane structured browser for DataCollectionSpec + FormSpec content. Sticky sidebar lists pages and groups; the content pane shows collapsible panels with page summaries and field tables.

workingCustom

Actions

Button

A clickable button for form submissions and actions.

stableUSWDS-derived

Button Group

Groups buttons horizontally with proper spacing.

stableUSWDS-derived

Form Controls

Character Count

Attaches to a textarea or text input and shows remaining characters.

workingUSWDS-derived

Chat Panel

A conversational interface for interactive form filling.

workingCustom

Checkbox

A custom-styled checkbox with tile variant support.

workingUSWDS-derived

Combo Box

A typeahead/autocomplete select with text input and filterable dropdown list.

workingUSWDS-derived

Date Picker

A calendar date selector popup from a text input with keyboard navigation and min/max date support.

workingUSWDS-derived

Date Range Picker

Paired start and end date pickers that coordinate date constraints.

workingUSWDS-derived

Error Message

An inline error message for form validation.

workingUSWDS-derived

File Input

File upload control with drag-and-drop, preview, and file type validation.

workingUSWDS-derived

Form

Form container that provides proper spacing between form groups.

workingUSWDS-derived

Input Mask

Formatted input overlay showing the expected pattern (phone, SSN, zip+4).

workingUSWDS-derived

Input Prefix/Suffix

Add-ons that attach to the start or end of a text input to provide visual context.

workingUSWDS-derived

Label

A label for form controls.

workingUSWDS-derived

Memorable Date

Three separate inputs for month, day, and year — easier to remember than a date picker.

workingUSWDS-derived

Radio

A custom-styled radio button with tile variant support.

workingUSWDS-derived

Range Slider

A styled range input with live value display.

workingUSWDS-derived

Select

A styled native select with custom dropdown chevron.

workingUSWDS-derived

Text Input

A single-line text input for form data.

workingUSWDS-derived

Time Picker

A combo box variant for time selection with configurable time range and step interval.

workingUSWDS-derived

Textarea

A multi-line text input for longer form content.

workingUSWDS-derived

Validation

Validation message patterns for inline (per-field) and summary (top of form) error display.

workingUSWDS-derived

Process

Process List

A numbered vertical step list with headings and content per step, connected by a vertical line.

workingUSWDS-derived

Step Indicator

A multi-step progress indicator showing completed, current, and remaining steps.

workingUSWDS-derived