README

Material Design Light

CSS Framework for Material Design 3
Explore the docs »

Report bug

About

Material Design Light is a lightweight CSS framework that implements the Material Design 3 to the full extent.

The project is heavily work in progress and offers zero support or assurances on anything.

Features

• 💅 Material Design 3 (Material You) - adheres to the latest design by Google
• 🎨 Customizable - with the design tokens you can make the framework truly yours
• ⚡ Cutting-Edge Technology - uses the latest CSS features allowing for zero JavaScript
• 🏎 Lighweight - minified version is lighter than the popular CSS frameworks
• 🤟 No JavaScript - framework doesn't rely on JavaScript
• 😎 Clean HTML - uses the right elements and supports accessibility features
• 🔧 Vanilla CSS - compiled as "vanilla" CSS, written with SCSS superset (SASS)
• 📱 Responsive - works with any screen size and follows the adaptive design

Quick start

Several quick start options are available:

• Download the latest release
• Clone the repository: git clone https://github.com/mdlightdev/material-design-light.git
• Install with npm: npm i material-design-light
• Install with Composer: composer require mdlightdev/material-design-light
• Install with NuGet: Install-Package MaterialDesignLight

What's included

Within the download you'll find the following directories and files, logically grouping common assets and providing both compiled and minified variations.

material-design-light/
└── css/
    ├── material-design-light.css
    ├── material-design-light.css.map
    └── material-design-light.min.css

Material Design Light provides compiled CSS (material-design-light.*), as well as compiled and minified CSS (material-design-light.min.*). Source maps (material-design-light.*.map) are available for use with certain browsers' developer tools.

Bugs and feature requests

Have a bug or a feature request? If your problem or idea is not addressed yet, please open a new issue.

Contributing

Check out the CONTRIBUTING.md for more information.

Clone and setup the repository:

git clone https://github.com/mdlightdev/material-design-light.git
cd material-design-light
npm install

Versioning

For transparency into the release cycle and in striving to maintain backward compatibility, Material Design Light is maintained under the Semantic Versioning 2.0.0 guidelines.

See the Releases section of the GitHub project for changelogs for each release version of Material Design Light.

Copyright and license

Copyright © Material Design Light 2022. All rights reserved. Material Design Light is licensed under the terms of the Mozilla Public License Version 2.0 (MPL 2.0). All other trademarks and trade names referenced herein are the properties of their respective owners in Finland and other countries.