New to Angular? Before getting into Angular Material, it might be helpful to:

- watch the videos about Angular.js framework
- read the Material Design specifications for components, animations, styles, and layouts.

## How do I start with Angular Material?

- Visit the CodePen Community for Angular Material
- Learn with Material-Start: 10-step Tutorial (es6)
- Learn with Material-Start: Completed (es6)
- Learn with Material-Start: Completed (Typescript)
- Learn with Material-Start: Completed (es5)
- Start with a blank CodePen Material Application
- Use the Github Starter Project
- Use the "Edit on CodePen" button on any of our Demos

### Build a Material Application (blank shell)

See this example application on CodePen that loads the Angular Material library from the Google CDN:

Now just your add your Angular Material components and other HTML content to your Blank starter app.

### Our CodePen Community

You can also visit our CodePen Community to explore more samples and ideas.

### Installing the Angular Material Libraries

You can install the Angular Material library (and its dependent libraries) in your local project using either NPM, JSPM, or Bower.

Angular Material also integrates with some additional, optional libraries which you may elect to include:

- ngMessages - Provides a consistent mechanism for displaying form errors and other messages.
- ngSanitize - The ngSanitize module provides functionality to sanitize HTML content in Material components.
- ngRoute - Provides a clean routing system for your application.

### Unsupported Integrations

Angular Material v1.0 has known integration issues with the following libraries:

- ngTouch - ngMaterial conflicts with ngTouch for click, tap, and swipe support on touch-enabled devices.
- Ionic - Open-source SDK for developing hybrid mobile apps with Web technologies has touch support that interferes with ngMaterial's mobile gesture features.

## Contributing to Angular Material

- Please read our contributor guidelines.
- To contribute, fork our GitHub repository.
- For problems, search the GitHub Issues and/or create a New Issue.
- For questions, search the Forum and/or post a new question.
- Join the Gitter Chat.