Bootstrap 5 & Material Design UI KIT
Go to file
Fez Vrasta 6a4db9412a Merge pull request #112 from npvn/develop
Add null check for $ripple
2014-10-12 11:42:49 +02:00
demo/imgs added nice banner 2014-10-03 15:52:14 +02:00
dist Add null check for $ripple 2014-10-12 15:42:56 +07:00
fonts refactor of the dist files 2014-10-05 09:32:48 +02:00
less change font to Roboto, change border radius and fab style to reflect google guidelines 2014-10-10 23:22:15 -07:00
sass improved support for Meteor.js (#103) 2014-10-08 14:52:08 +02:00
screenshots refactor of the dist files 2014-10-05 09:32:48 +02:00
scripts Add null check for $ripple 2014-10-12 15:42:56 +07:00
template Add null check for $ripple 2014-10-12 15:42:56 +07:00
test fixes #81: integrating with Travis CI 2014-10-04 20:16:13 -04:00
.editorconfig support for editorconfig 2014-10-05 10:20:47 +02:00
.gitignore adding specrunner and its build config for testing in browser 2014-10-03 15:46:35 -04:00
.jshintrc reverted jshint rules, cleaned up source where it was failing. updating build process errors. TODO: fix livereload 2014-10-03 16:46:56 -04:00
.travis.yml fixed quotes 2014-10-05 09:00:13 +02:00
bower.json ripples.js is now part of the core 2014-10-08 08:41:42 +02:00
CONTRIBUTING.md security fix 2014-10-02 11:36:05 +02:00
Gruntfile.js fixes #106 - also fixes the jshint errors from prior commit 2014-10-10 10:34:36 +02:00
index.html organized some icons 2014-10-07 10:06:14 +02:00
LICENSE.md First draft of the license. 2014-08-18 14:13:03 +02:00
package.json fixes #106 - also fixes the jshint errors from prior commit 2014-10-10 10:34:36 +02:00
README.md Merge pull request #72 from FezVrasta/develop 2014-10-03 15:52:35 +02:00

banner

This Bootstrap theme is an easy way to use the new Material Design guidelines by Google in your Bootstrap 3 based application. Just include the theme right after the Bootstrap CSS and include the javascript at the end of your document, everything will be converted to Material Design (paper) style.

This theme is in early development and is not ready for production.

Check out the demo at this link (could be not even with the master branch).

How to install

BOWER:       bower install bootstrap-material-design --save
GEMS:        gem install bootstrap-material-design

LESS & SASS

We decided to merge the SASS fork in to the main repository instead of having two seperate ones, #40. The default grunt task will compile the LESS source. To use the SASS base use the SCSS task grunt scss.

NB The LESS and SASS bases should reflect each other, right now this project is unstable and under heavy development so this might not be true before the first stable release.

Getting started

Navigate to the template/ folder in this repository, and you will see the index.html file, which has the CSS include statements, in the head section and the JS includes just before body section closes. You need to copy the material/ folder to the root of your project, ensuring that all the files in your project can access the files through the relative URL, supplied in the CSS and the JS includes.

Todo

I'll try to write every component without the need of Javascript but just CSS, and use JS only if strictly needed. More "todo" things can be found in the ISSUES of this repository.

Support me

If you like this project you may support me by donating something on Gittip, starring this repository or reporting bugs and ideas in the issue section.

gittip issues

Contribute

Please see the contrib file.

Documentation

Material Design for Bootstrap provides some additional stuff to get the best from Material Design.

Variations:

There are 17 additional color variations (in addition to the classic 4 variations) for buttons, inputs, checkboxes, radios, alerts, navbars, tabs, labels, paginations, progress bars and more. They can be used by adding the class suffix -material-color to the desired element and replacing color with the desired one.

Example:

<button class="btn btn-material-deeppurple">Deep purple button</button>

These colors are taken from the Material Design color palette and are reported below:

palette

Buttons:

Add .btn-flat to a button to make it flat, without shadows. Add .btn-raised to a button to add a permanent shadow to it.

Inputs:

Add .floating-label to an input field with a placeholder to transform the placeholder in a floating label.

Remember to use the proper HTML markup to get radio and checkboxes styled correctly (choose between radio or checkbox):

<div class="radio/checkbox radio-primary">
    <label>
        <input type="radio/checkbox" checked>
        Option one is this
    </label>
</div>

Icons:

Material Design for Bootstrap includes 490 original Material Design icons! These icons are extracted from the original Google sources and are licensed under the BSD license. They are provided as an iconic and easy to use font.

Variations are available for every icon, including the original Bootstrap icons.

The syntax to add a Material icon is:

 <i class="icon icon-material-favorite"></i>

Plugins

Material Design for Bootstrap comes with styling support for various external scripts:

SnackbarJS

Create snackbars and toasts with SnackbarJS plugin. The default toast style is the squared one (snackbar style). If you like to use the rounded style (toast style), please add the toast class to the style option of SnackbarJS.

RipplesJS

This is part of Material Design for Bootstrap project and is a plain Javascript script which creates the ripple effect on click of the defined elements. At the moment RipplesJS does not have its own repository but it will probably have one in the future.

noUiSlider

Make cross-browser sliders and get them styled with Material Design thanks to the support provided by this theme. Read more about noUiSlider here

Selectize.js

Transform select and multi select inputs in advanced text inputs. Material Design for BS provides a fulle replacement of the plugin's CSS, don't include it so. Read more about selectize.js

Compatibility

Currently Material Design for Bootstrap supports Google Chrome (tested v37+), Mozilla Firefox (tested 30+), and Internet Explorer (tested 11+). Mobile browsers are not currently tested but it may work.