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.
You can see these components in action at http://material.angularjs.org
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.
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
, or download the files directly from the bower-material repository.
- 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)
- http://github.com/ajoslin/conventional-changelog
- git commit-msg hook available here. Place it in
.git/hooks/commit-msg
, and runchmod +x .git/hooks/commit-msg
. It will validate your commit messages for you.
npm install
for gulp depsgit submodule update --init
to add icons subfolderbower install
for angular depsgulp build
(aliasgulp
) to build, add--release
flag to uglify & strip console.log.gulp watch
to build & rebuild on changesgulp validate
to test and jshintgulp jshint
to run jshintgulp karma
to test oncegulp karma-watch
to test & watch for changesgulp docs
to build docs into dist/docs
- See
docs/README.md
.