diff --git a/README.md b/README.md index 6a75df66de..b846ae1dd2 100644 --- a/README.md +++ b/README.md @@ -1,21 +1,83 @@ # Material Web -Material -[web components](https://developer.mozilla.org/en-US/docs/Web/Web_Components) -is a UI toolkit to build customizable and accessible web applications. + -[Material 3](https://m3.material.io/) is the latest version of -Google's open-source design system. +[![Published on npm](https://img.shields.io/npm/v/%40material%2Fweb)](https://www.npmjs.com/package/@material/web) +[![Join our Discord](https://img.shields.io/badge/discord-join%20chat-5865F2.svg?logo=discord&logoColor=fff&label=%23material)](https://lit.dev/discord/) +[![Test status](https://github.com/material-components/material-web/actions/workflows/test.yml/badge.svg)](https://github.com/material-components/material-web/actions/workflows/test.yml) +[![npm Downloads](https://img.shields.io/npm/dm/%40material%2Fweb?label=npm%20downloads)](https://npm-stat.com/charts.html?package=%40material%2Fweb) +[![jsDelivr hits (npm)](https://img.shields.io/jsdelivr/npm/hm/%40material%2Fweb)](https://www.jsdelivr.com/package/npm/@material/web?tab=stats) -> Tip: Using Angular? We recommend using -> [Angular Material](https://material.angular.io/) components -> instead. +`@material/web` is a library of +[web components](https://developer.mozilla.org/en-US/docs/Web/Web_Components) +that helps build beautiful and accessible web applications. It uses +[Material 3](https://m3.material.io/), the latest version of Google's +open-source design system. -**Resources** +## Resources - [Introduction](./docs/intro.md) - [Roadmap](./docs/roadmap.md) -- [Quick start](./docs/quick-start.md) -- [Bundle sizes](./docs/size.md) - [Component docs](./docs/components/) +- [Bundle size](./docs/size.md) - [Browser support and FAQ](./docs/support.md) + +## Quick start + +> Tip: Using Angular? We recommend using +> [Angular Material](https://material.angular.io/) components +> instead. + +This code snippet is a buildless example that loads `@material/web` from a CDN. +Check out the [quick start](./docs/quick-start.md) guide to install and build +for production. + + + +```html +
+ + + + + +