nadavhury / material

Material design for Angular

Material Design for AngularJS Apps

Material Design is a specification for a unified system of visual, motion, and interaction design that adapts across different devices. Our goal is to deliver a lean, lightweight set of AngularJS-native UI elements that implement the material design system for use in Angular SPAs.

This project is still in early preview. It is a complementary effort to the Polymer project's paper elements collection.

Please note that using Angular Material requires the use of Angular 1.3.x or higher. These components are intended to work in the latest version of "evergreen" browsers (Chrome, Firefox, Internet Explorer, Safari).

Demo Site

You can see these components in action at http://material.angularjs.org.

Or you run build the docs and demos locally. See the Documentation README for details.

Development

This project is in early development via a small core team of Ionic Framework and AngularJS developers. We don't have guidelines yet for broader community involvement, although we hope to have some soon.

For issues, including progress on accessibility support for these UI elements, see the Issue Tracker.

See CONTRIBUTING.md for information on structure, documentation, and code conventions.

Usage

In its current early state, use AngularJS Material Design at your own risk. APIs are changing rapidly.

If you wish to use angular-material anyway, you can:

• bower install angular-material to the get latest stable release

  or download the files directly from the bower-material repository.

• bower install angular-material#master to get the version just committed to master

  Note that master is less stable than a release.

View the README in the bower-material repository for how to get started.

File Structure

• Components belong in src/components/{componentName}
• Component modules must be named material.components.{componentName}
• Templates for directives are declared inline
• Gulp builds files to dist folder, which is not version controlled (read below)

Commit Conventions

• http://github.com/ajoslin/conventional-changelog
• git commit-msg hook available here. Place it in .git/hooks/commit-msg, and run chmod +x .git/hooks/commit-msg. It will validate your commit messages for you.

Development

For each milestone release, always run:

• npm update for gulp deps
• bower update for angular deps

The following command line tasks are available:

• gulp build (alias gulp) to build, add --release flag to uglify & strip console.log.
• gulp watch to build & rebuild on changes
• gulp validate to test and jshint
• gulp jshint to run jshint
• gulp karma to test once
• gulp karma-watch to test & watch for changes
• gulp docs to build docs into dist/docs

Documentation

• See docs/README.md.