Installation

Angular Material Dev (Blocks) are designed for Angular and requires the following versions: | Package | Version | | ----------------- | ------- | | Angular | 20+ | | @angular/cdk | 20+ | | @angular/material | 20+ | | tailwindcss | 4 | > As of October 2025, we also provide support for Angular v19. But, we recommend using Angular v20+ for the best experience. ### Create a new Angular project In terminal, run the following command to create a new Angular project: ```bash ng new my-app --style scss ``` > [SCSS](https://sass-lang.com/) is needed for [`@angular/material`](https://material.angular.dev/)'s overrides API to [customize tokens](https://material.angular.dev/guide/theming#customizing-tokens). ### Use `@ngm-dev/cli` to complete the setup You can use `@ngm-dev/cli` to complete the setup & skip manual steps. Run the following command to initialize `@ngm-dev/cli` in your project: ```bash npx @ngm-dev/cli init ``` Simply follow the prompts to complete the setup. And you're good to go! To know more about `@ngm-dev/cli`, please visit [CLI Setup](/docs/cli/setup) page. If for some reason CLI fails to complete above steps, you can follow manual setup, go to [Manual Setup](/docs/getting-started/manual-setup) page.