angular-material-dev/mat-exp

Mat Expressive is a library that brings Google's Material 3 Expressive design system to Angular applications. It works on top of Angular Material, the official UI component library for the Angular framework. The goal is to give existing Angular Material components a fresh, updated look that matches the latest Material 3 Expressive visual style. Importantly, this project is not a replacement for Angular Material, nor is it a modified copy of it. Instead, it provides three kinds of additions. First, it offers style sheets that you apply to your existing Angular Material components to update their appearance. Second, it provides directives, which are small pieces of code that can attach to components when plain styles are not enough to achieve the desired look or behavior. Third, it includes brand new components for situations that Angular Material does not cover at all. The library works by using Angular Material's built-in theming tools, specifically something called the overrides API and CSS variables. These are standard mechanisms that Angular Material provides for customizing how components look. When a visual change cannot be achieved through those standard tools, the library applies styles directly to the underlying HTML elements of a component. The developers note that this direct approach could break if Angular Material changes its internal structure in a future update, and they plan to track and fix those issues as they arise. Users can also turn off the direct HTML styling if they prefer, though some visual effects like icon sizing and shape morphing will not work without it. Installing the library is straightforward if you already use Angular. You run a single command in your project terminal, and the library handles the setup. Full documentation, including installation guides and interactive playgrounds, is available on the project's website. The project is free and open source under the MIT license. The primary contributor is Dharmen Shah, and the project welcomes contributions of all kinds from the community. Users can ask questions or report issues through GitHub.