Skip to main content brightness_auto motion_photos_off palette download more_vert
toc

Material Web 3.0

About

Getting started and project information: how to install and use Material Web 3.0, how it follows the Material 3 spec, what is coming next, and where to get help.

11 pages · View as Markdown

  • Introduction

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

  • Spec compliance

    What the spec checks, ARIA and axe results, Baseline use and size budgets say about md-gb-* components.

  • Quick Start

    For fast prototyping, use a CDN such as esm.run to load @material/web without installing it.

  • Migration

    Version 3.0 renames most elements from md- to md-gb- and moves them to Material 3 Expressive.

  • Roadmap

    This roadmap describes current, future, and past goals for Material Web Components.

  • Support

    Version 3.0 targets Baseline widely available: the web platform features it uses have worked in all major browsers for at least 30 months.

  • Bundle Sizes

    Every md-gb- component is checked against a Brotli-compressed size budget for its JavaScript and CSS (the measured size plus 10% headroom), defined in scripts/size/gb-budgets.json.

  • Browser support

    Version 3.0 only uses web platform features that are Baseline widely available.

  • AI agents

    labs/gb/skill/ is a Claude Code skill named md-gb.

  • Debugging

    The shared plumbing of the components (motion waits, overflow measure passes, and scroll steps) can record performance marks.

  • Use with shadcn/ui

    Install the md-gb elements as React components with the shadcn CLI, themed by your shadcn variables.

Install Material Web 3.0

Your browser did not offer to install the docs as an app. Install them from the browser instead:

Close
Send feedback
Bug Documentation Idea

Opens a new GitHub issue for material-components/material-web in a new tab, with this filled in.

Cancel Open issue