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

Modal

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

workingUSWDS-derived

Site Alert

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

workingUSWDS-derived

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

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

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

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

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