1.8 KiB
layout | title | group |
---|---|---|
docs | Customization options | getting-started |
Material Design for Bootstrap 4 is designed to be customized via Sass variables. You may customize any Bootstrap or MDB variable.
{% callout info %} The following assumes you have setup your Build tools {% endcallout %}
{% callout warning %}
If overriding a variable via Sass, ensure that your are @import
ing the underscored file _core.scss
not the main file used for distributions. For more information see this StackOverflow post.
{% endcallout %}
Here are some ways to customize:
1. (Recommended) Include the source in your application
Installing via npm (recommended) or bower, customizing MDB is a breeze.
- Add
bootstrap-material-design
as a dependency to yourpackage.json
or yourbower.json
npm install
orbower install
depending on your tool of choice- Add either
node_modules
orbower_components
in theincludePaths
for your grunt-sass, gulp-sass, or equivalent so you are able to import without specifying the full path of the resource. - In your application's SCSS, redefine any customized variable before
@import
ing bootstrap material design. For example:
$brand-primary: #3f51b5; // bootstrap variable
$mdb-label-color-focus: #303f9f; // mdb variable
@import "bootstrap-material-design/scss/core"; // make sure to use _core.scss!
3. Download the source and change/compile
{% callout warning %} This method is not recommended because it may be difficult to use source control and keep up to date with new releases. Please consider the recommended method above. {% endcallout %}
- Download the source via npm, bower or otherwise
- Change any of the variables
- Run
grunt dist