Intro to Material Web Components

Material web, also known as Material Web Components or MWC, is a library of web components that follows Google's Material Design guidelines.

Material Design is a design system built and supported by Google designers and developers. Guidelines for building Material apps and components are published on

The latest version, Material 3, enables personal, adaptive, and expressive experiences – from dynamic color and enhanced accessibility, to foundations for large screen layouts and design tokens.

An example of a Material Design application.

Web components are custom HTML elements with encapsulated styles and behavior. They work across many different frameworks (such as Lit, React, Vue, and Svelte) as well as web environments (such as Eleventy, Wordpress, and Ruby on Rails).

Many components in this library are drop-in replacements for browser elements like <button> and <input>.

<!-- Browser elements -->
    <input type="email" name="email" required>
    <input type="checkbox" name="subscribe">

  <button type="reset">Reset</button>

<!-- Material elements -->
  <md-outlined-text-field label="Email" type="email"
      name="email" required></md-outlined-text-field>
    <md-checkbox name="subscribe"></md-checkbox>

  <md-text-button type="reset">Reset</md-text-button>

Design tokens are the building blocks of all UI elements. In MWC, tokens are CSS custom properties that can be used to style components.

:root {
  --md-sys-color-primary: olive;
  --md-sys-color-secondary: tomato;
  --md-ref-typeface-brand: 'Open Sans';
  --md-ref-typeface-plain: system-ui;
IntroductionQuick StartRoadmapSupportBundle Sizes
Material ThemingColorTypographyShape
ButtonsCheckboxChipsDialogsFloating action button (FAB)Icon ButtonsListsMenusProgress indicatorsRadioRippleSelectSlidersSwitchTabsText field