Files

Material Design 3 reference (extracted 2026-09-13)

What Google's documentation says, condensed for auditing this library against it. Every file keeps the wording of the site where a rule is stated, the tables verbatim, and a source URL per section. Numbers the site only draws in pictures were taken from androidx Compose Material 3's token files (compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/tokens/) and the Material Components Android component docs, and are marked with their source.

File Covers
foundations.md, foundations-supplement.md accessibility, content design, customisation, design tokens, interaction (gestures, inputs, selection, states), layout (window size classes, scaffold, grids and spacing, canonical layouts, RTL), usability, glossary
styles.md, styles-supplement.md colour (roles, system, dynamic, custom colours, contrast), elevation, icons, motion (Expressive springs, easing and duration, transitions), shape (corner scale, shapes, morph), spacing, typography
components-actions-communication-containment.md buttons, icon buttons, button groups, split button, segmented buttons, FAB, extended FAB, FAB menu, badges, progress indicators, loading indicator, snackbar, tooltips, bottom sheets, cards, carousel, dialogs, divider, lists, side sheets, menus
components-navigation-selection-inputs.md app bars, navigation bar, navigation rail, navigation drawer, tabs, toolbars, search, checkbox, chips, radio button, sliders, switch, text fields, date pickers, time pickers, data tables
pages.txt the 238 pages under /foundations, /styles and /components in the site's sitemap (watches and XR left out) — the coverage checklist; every one was fetched

Refreshing

m3.material.io renders only in a browser. Read it through a reader proxy, one page at a time (it rate-limits with HTTP 429; retry after a few seconds; add -H "x-no-cache: true" for a stale snapshot):

curl -sL "https://m3.material.io/sitemap.xml" | grep -o '<loc>[^<]*' | sed 's/<loc>//'   # the page list
curl -sL "https://r.jina.ai/https://m3.material.io/components/buttons/specs"            # one page

The audits that used these files are in docs/audits/m3-alignment/.

Attribution

The text is Google's, from https://m3.material.io, reproduced here so the library can be checked against it; the token values are from the Android Open Source Project (Apache-2.0, see NOTICE). Google publishes its design documentation under the Creative Commons Attribution 4.0 licence "except as otherwise noted"; confirm the statement in the site's footer before reproducing these files anywhere else. docs/ is export-ignored, so they are not part of the Composer distribution.