Name		Name	Last commit message	Last commit date
.gemini		.gemini
.github		.github
.husky		.husky
.ng-dev		.ng-dev
.vscode		.vscode
docs		docs
goldens		goldens
guides		guides
integration		integration
scripts		scripts
src		src
test		test
tools		tools
.bazel_fix_commands.json		.bazel_fix_commands.json
.bazelrc		.bazelrc
.bazelversion		.bazelversion
.editorconfig		.editorconfig
.firebaserc		.firebaserc
.git-blame-ignore-revs		.git-blame-ignore-revs
.gitignore		.gitignore
.nvmrc		.nvmrc
.prettierignore		.prettierignore
.prettierrc		.prettierrc
.pullapprove.yml		.pullapprove.yml
.stylelintrc.json		.stylelintrc.json
BUILD.bazel		BUILD.bazel
CHANGELOG.md		CHANGELOG.md
CHANGELOG_ARCHIVE.md		CHANGELOG_ARCHIVE.md
CODE_OF_CONDUCT.md		CODE_OF_CONDUCT.md
CODE_REVIEWS.md		CODE_REVIEWS.md
CODING_STANDARDS.md		CODING_STANDARDS.md
CONTRIBUTING.md		CONTRIBUTING.md
DEV_ENVIRONMENT.md		DEV_ENVIRONMENT.md
FAQ.md		FAQ.md
LICENSE		LICENSE
MODULE.bazel		MODULE.bazel
MODULE.bazel.lock		MODULE.bazel.lock
README.md		README.md
REPO.bazel		REPO.bazel
SECURITY.md		SECURITY.md
firebase.json		firebase.json
package.json		package.json
packages.bzl		packages.bzl
pkg-externals.bzl		pkg-externals.bzl
pnpm-lock.yaml		pnpm-lock.yaml
pnpm-workspace.yaml		pnpm-workspace.yaml
renovate.json		renovate.json
tsconfig.json		tsconfig.json
tslint.json		tslint.json

Repository files navigation

Official components for Angular

The Angular team builds and maintains both common UI components and tools to help you build your own custom components. The team maintains several npm packages.

Package	Description	Docs
@angular/aria	Collection of headless, accessible directives that implement common WAI-ARIA patterns	Docs
@angular/cdk	Library that helps you author custom UI components with common interaction patterns	Docs
@angular/material	Material Design UI components for Angular applications	Docs
@angular/google-maps	Angular components built on top of the Google Maps JavaScript API	Docs
@angular/youtube-player	Angular component built on top of the YouTube Player API	Docs

Quick links

Documentation, demos, and guides | Frequently Asked Questions | Community Google group | Contributing | StackBlitz Template

Getting started

See our Getting Started Guide if you're building your first project with Angular Material.

Contributing

If you'd like to contribute, please follow our contributing guidelines. Please see our help wanted label for a list of issues with good opportunities for contribution. You can also use the good first issue label to find issues if you are just starting to contribute to the project.

About the team

The Angular Components team is part of the Angular team at Google. The team includes both Google employees and community contributors from around the globe.

Our team has two primary goals:

Build high-quality UI components that developers can drop into existing applications
Provide tools that help developers build their own custom components with common interaction patterns

What do we mean by "high-quality" components?

Internationalized and accessible so that all users can use them.
Straightforward APIs that don't confuse developers.
Behave as expected across a wide variety of use-cases without bugs.
Behavior is well-tested with both unit and integration tests.
Customizable within the bounds of the Material Design specification.
Performance cost is minimized.
Code is clean and well-documented to serve as an example for Angular developers.

Support policy

Angular Material and the CDK follow the same support and release policy as the Angular framework. For details on supported versions and update practices, see the Angular support policy and schedule.

Browser and screen reader support

The Angular Components team supports the most recent two versions of all major browsers: Chrome (including Android), Firefox, Safari (including iOS), and Edge.

We aim for great user experience with the following screen readers: