material-design-lite/README.md

65 lines
1.5 KiB
Markdown
Raw Normal View History

# Material Design Lite
2014-04-16 06:26:21 -07:00
2015-02-04 22:46:41 -08:00
> A library of [Material Design](www.google.com/design/spec/material-design/introduction.html) components in CSS, JS and HTML
2014-04-16 07:12:57 -07:00
2015-02-04 02:14:46 -08:00
## Getting Started
2014-04-16 07:12:57 -07:00
2015-02-04 22:46:41 -08:00
### Download
Clone or [download](https://github.com/google/material-design-lite/archive/master.zip) this repository
2015-02-04 02:14:46 -08:00
and reference the following files in your project:
2014-05-23 12:02:58 -07:00
2015-02-04 02:14:46 -08:00
```html
<script src="js/material.min.js">
<link rel="stylesheet" href="css/material.min.css">
```
2015-02-04 02:14:46 -08:00
You will want to include the entire package to ensure optional assets like images or fonts are correctly
included.
2014-05-27 02:27:36 -07:00
2015-02-04 22:46:41 -08:00
### npm
2014-06-16 07:03:08 -07:00
2015-02-04 22:46:41 -08:00
```
$ npm install --save material-design-lite
2015-02-04 02:14:46 -08:00
```
2014-06-19 05:50:10 -07:00
2015-02-04 22:46:41 -08:00
### bower
2014-05-16 02:59:52 -07:00
2015-02-04 22:46:41 -08:00
```
$ bower install --save material-design-lite
2015-02-04 02:14:46 -08:00
```
2014-06-16 03:26:01 -07:00
2015-02-04 22:46:41 -08:00
2015-02-04 02:14:46 -08:00
## Development
2014-06-19 07:22:40 -07:00
2015-02-04 02:14:46 -08:00
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:
2014-06-16 03:26:01 -07:00
2015-02-04 22:46:41 -08:00
```
2015-02-04 02:14:46 -08:00
$ npm install && npm install -g gulp
```
2014-06-16 03:26:01 -07:00
2015-02-04 02:14:46 -08:00
Next, run the following one-liner to preview the components:
2014-06-16 03:26:01 -07:00
2015-02-04 22:46:41 -08:00
```
2015-02-04 02:14:46 -08:00
$ gulp serve
```
2014-06-06 03:55:13 -07:00
2015-02-04 02:14:46 -08:00
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.
2015-02-04 02:14:46 -08:00
To build a production version of the components, run:
2015-02-04 22:46:41 -08:00
```
2015-02-04 02:14:46 -08:00
$ gulp
```
2015-02-04 02:14:46 -08:00
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`.
2014-06-16 03:14:04 -07:00
2015-02-04 22:46:41 -08:00
2014-06-06 05:06:29 -07:00
## License
Copyright Google, 2015. Licensed under an Apache-2 license.