Material Design Lite

A library of Material Design components in CSS, JS and HTML

Material Design Lite lets you add a Material Design look and feel to your static content websites. It doesn’t rely on any JavaScript frameworks and aims to optimise for cross-device use, gracefully degrade in older browsers and offer an experience that is accessible from the get-go.

Quick start

Four quick start options are available:

• Download the latest release.
• Clone the repo: git clone https://github.com/google/material-design-lite.git.
• Install with Bower: bower install material-design-lite.
• Install with npm: npm install material-design-lite.

What's included

Within the download you'll find the following directories and files, logically grouping common assets and providing both compiled and minified variations. You'll see something like this:

├── css
│   ├── material.css
│   └── material.min.css
├── js
│   ├── material.js
│   ├── material.min.js
│   └── material.min.js.map
├── templates
├── images
├── src
├── package.json
├── bower.json
├── gulpfile.js
├── LICENSE
├── README.md

We provide compiled CSS and JS (material.*), as well as compiled and minified CSS and JS (material.min.*). JS source maps (material.*.map) are available for use with certain browsers' developer tools.

Getting Started

Download

Clone or download this repository and reference the following files in your project:

<script src="js/material.min.js"></script>
<link rel="stylesheet" href="css/material.min.css">

You will want to include the entire package to ensure optional assets like images or fonts are correctly included.

npm

$ npm install --save material-design-lite

bower

$ bower install --save material-design-lite

Development

The sources (JS, Sass) and demo files for all components can be found in the src directory. To get started modifying them, first install the necessary dependencies, from the root of the project:

$ npm install && npm install -g gulp

Next, run the following one-liner to preview the components:

$ gulp serve

Any changes made to files inside the src directory will cause the page to reload. This page can also be loaded up on physical devices thanks to BrowserSync.

To build a production version of the components, run:

$ gulp

This will clean and update the css, js and images directories in the root of the project with minified and concatenated versions of the component files. Namely, css/material.min.css and js/material.min.js.

Templates

The templates/ subdirectory contains a few exemplary usages of MDL. Templates have their own, quasi-separate gulp pipeline and can be compiled with gulp templates. The templates use the vanilla MDL JS and themed CSS files. Extraneous styles are kept in a separate CSS file. Use gulp serve to take a look at the templates:

• General template
• Blog template and blog entry
• Dashboard template

Browser Support

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

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

Versioning

For transparency into our release cycle and in striving to maintain backward compatibility, Material Design Lite is maintained under the Semantic Versioning guidelines. Sometimes we screw up, but we'll adhere to those rules whenever possible.

Feature requests

If you find MDL doesn't contain a particular component you think would be useful, please check the issue tracker in case work has already started on it. If not, you can request new component in the following thread. Please be sure to include justification for why you think the component should be implemented to help us with planning.

In-development

Here, you can find early live previews of our work for testing or demo purposes.

• Visual tests for components
• Android.com Material Design Lite demo
• Theme customiser prototype

Do you include any features that a framework comes with?

Material Design Lite is focused on delivering a vanilla CSS/JS/HTML library of components. We are not a framework. If you are building a single-page app and require features like two-way data-binding, templating, CSS scoping and so forth, we recommend trying out the excellent Polymer project.

License

Copyright Google, 2015. Licensed under an Apache-2 license.