Material Design Lite

An implementation of Material Design
components in vanilla CSS, JS, and HTML.

Material Design Lite (MDL) lets you add a Material Design look and feel to your
static content websites. It doesn't rely on any JavaScript frameworks or
libraries. Optimized for cross-device use, gracefully degrades in older
browsers, and offers an experience that is accessible from the get-go.

Limited support

Material Design Lite is now in limited support, with development having moved to the
Material Components for the web repository.

No further development is taking place in MDL by the core team, but we are happy to review PRs, fix critical bugs and
push out new releases. No breaking changes will be accepted.

Heads up: the old getmdl.io site is gone, and the documentation and component gallery
that used to live there are no longer available. MDL itself still works fine as a vanilla
set of Material Design CSS, JS, and HTML you can drop into any project — only the hosted
docs site has been retired.

Use MDL on your site?

This document is targeted at developers that will contribute to or compile MDL.
If you just want to use MDL on a website or web app, the safest bet is to
self-host the v1.3.0 release, since the previously-recommended
getmdl.io-hosted assets are no longer available.

Grab the prebuilt CSS and JS from the
v1.3.0 release on GitHub
and serve them from your own origin.
Or, if you need a drop-in CDN alternative, MDL is mirrored on
CDNJS.
The package is also still published on npm as
material-design-lite.

Browser Support

IE9	IE10	IE11	Chrome	Opera	Firefox	Safari	Chrome (Android)	Mobile Safari
B	A	A	A	A	A	A	A	A

A-grade browsers are fully supported. B-grade browsers will gracefully degrade
to our CSS-only experience.

Download / Clone

Clone the repo using Git:

bash
git clone https://github.com/google/material-design-lite.git

Alternatively you can download
this repository.

Windows users, if you have trouble compiling due to line endings then make sure
you configure git to checkout the repository with lf (unix) line endings. This
can be achieved by setting core.eol.

bash
git config core.eol lf
git config core.autocrlf input
git rm --cached -r .
git reset --hard

Remember, the master branch is considered unstable. Do not use this in
production. Use a tagged state of the repository, npm, or bower for stability!

Feature requests

MDL is currently in limited support mode, with no further development taking place by the core team.
We are happy to accept and review pull requests for new functionality, however, as long as there are no breaking
changes.

Want to contribute?

If you found a bug, have any questions or want to contribute. Follow our
guidelines,
and help improve the Material Design Lite. For more information visit our
wiki.

Please use the default branch, mdl-1.x.

Take note that Material Components for Web, which is MDL v2, is under early Alpha stages (which means everything is a moving target, and we can change anything at any moment). Use with caution.

However, we would absolutely love to have people testing MCW and provide feedback about their experiences using it, especially integrating with other frameworks and libraries.