Tutorial and Components

Short Description and Usage

Material Dashboard is a free Material Bootstrap Admin with a fresh, new design inspired by Google's Material Design. We are very excited to introduce our take on the material concepts through an easy to use and beautiful set of components. Material Dashboard was built over the popular Bootstrap framework and it comes with a couple of third-party plugins redesigned to fit in with the rest of the elements.

Using it is very simple and it will enable you to refresh you classic looking application. To get the desired effect you will also need to integrate JS plugins that take a little bit more effort. It the end the result will be worth it.

Getting Started

The Material Dashboard is built on top of Bootstrap 3, so you can safely use it on your existing or new Bootstrap project. No line of code from Bootstrap 3 was changed, so you don't have to worry about undesired effects in your work.

The easiest way to start is to use our start-up template where all the files are already included and ready to use.

File Structure

Once you have downloaded the archive and opened it, you will find the following structure:

Let's take it one by one:

material-dashboard
--assets
---css
-----bootstrap.min.css
-----demo.css
-----material-dashboard.css
---img
---js
-----bootstrap-notify.js
-----bootstrap.min.js
-----chartist.min.js
-----demo.js
-----jquery-3.1.0.min.js
-----material-dashboard.js
-----material.min.js
----sass
-----md
-----material-dashboard.scss
--documentation
----tutorial-components.html
--examples

Restyled Components

Here is the list of Bootstrap 3 components that were restyled in Material Dashboard:

• Buttons
• Inputs
• Textarea
• Menu
• Dropdown
• Navigation Menu
• Labels
• Notifications
• Typography
• Tables

New Components

Besides giving the existing Bootstrap elements a new look, we added new ones, so that the interface and consistent and homogenous.

Going through them, we added:

• Checkboxes
• Radio Buttons
• Card Stats
• Card Charts
• Card with tabs
• Material Icons

Components

Buttons

Colors

We worked over the original Bootstrap classes, choosing a different, slightly intenser colour palette.

Default Primary Info Success Warning Danger

<button class="btn btn-default">Default</button>
<button class="btn btn-primary">Primary</button>
<button class="btn btn-info">Info</button>
<button class="btn btn-success">Success</button>
<button class="btn btn-warning">Warning</button>
<button class="btn btn-danger">Danger</button>
    			

Checkboxes

To use the custom checkboxes, you don't need to import any separate Javascript file, everything is inside material.min.js

<div class="checkbox">
	<label>
		<input type="checkbox" name="optionsCheckboxes">
		Unchecked
	</label>
</div>
<div class="checkbox">
	<label>
		<input type="checkbox" name="optionsCheckboxes" checked>
		Checked
	</label>
</div>
<div class="checkbox">
	<label>
		<input type="checkbox" name="optionsCheckboxes" disabled>
		Disabled Unchecked
	</label>
</div>
<div class="checkbox">
	<label>
		<input type="checkbox" name="optionsCheckboxes" disabled checked>
		Disabled Checked
	</label>
</div>

				

Radio Buttons

To use the custom radio buttons, you don't need to import any separate Javascript file, everything is inside material.min.js.

<div class="radio">
	<label>
		<input type="radio" name="optionsRadios">
		Radio is off
	</label>
</div>
<div class="radio">
	<label>
		<input type="radio" name="optionsRadios" checked="true">
		Radio is on
	</label>
</div>
<div class="radio">
	<label>
		<input type="radio" name="optionsRadiosDisabled" disabled>
		Disabled Radio is off
	</label>
</div>
<div class="radio">
	<label>
		<input type="radio" name="optionsRadiosDisabled" checked="true" disabled>
		Disabled Radio is on
	</label>
</div>
    			

Dropdown

We are very proud to present the dropdown which has a subtle animation. IMPORTANT! The focus state is Purple by default and, on the dropdowns from the navbars, they will take the colour of the parent navbar.

<div class="dropdown">
	<a href="#" class="btn dropdown-toggle" data-toggle="dropdown">
    	Regular
    	<b class="caret"></b>
	</a>
	<ul class="dropdown-menu">
		<li><a href="#">Action</a></li>
		<li><a href="#">Another action</a></li>
		<li><a href="#">Something else here</a></li>
		<li class="divider"></li>
		<li><a href="#">Separated link</a></li>
		<li class="divider"></li>
		<li><a href="#">One more separated link</a></li>
	</ul>
</div>
    			

Inputs

We restyled the Bootstrap inputs to give them a more flat, minimal look. You can use them with regular labels, floating labels and states or input groups.

<div class="col-sm-4">
	<div class="form-group">
    	<input type="text" value="" placeholder="Regular" class="form-control" />
	</div>
</div>

<div class="col-sm-4">
	<div class="form-group label-floating">
		<label class="control-label">With Floating Label</label>
		<input type="email" class="form-control">
	</div>
</div>

<div class="col-sm-4">
	<div class="form-group label-floating has-success">
		<label class="control-label">Success input</label>
		<input type="text" value="Success" class="form-control" />
		<span class="form-control-feedback">
			<i class="material-icons">done</i>
		</span>
	</div>
</div>

<div class="col-sm-4">
	<div class="form-group label-floating has-error">
		<label class="control-label">Error input</label>
		<input type="email" value="Error Input" class="form-control" />
		<span class="material-icons form-control-feedback">clear</span>
	</div>
</div>

<div class="col-sm-4">
	<div class="input-group">
		<span class="input-group-addon">
			<i class="material-icons">group</i>
		</span>
		<input type="text" class="form-control" placeholder="With Material Icons">
	</div>
</div>

<div class="col-sm-4">
	<div class="input-group">
		<span class="input-group-addon">
			<i class="fa fa-group"></i>
		</span>
		<input type="text" class="form-control" placeholder="With Font Awesome Icons">
	</div>
</div>
				

Textarea

The textarea has a new style, so it looks similar to all other inputs.

<textarea class="form-control" placeholder="Here can be your nice text" rows="5"></textarea>
				

Navbar

The classic Bootstrap Navbar was restyled:

<nav class="navbar navbar-default" role="navigation">
	<div class="container-fluid">
    	<div class="navbar-header">
    		<button type="button" class="navbar-toggle" data-toggle="collapse" data-target="#bs-example-navbar-collapse-1">
                <span class="sr-only">Toggle navigation</span>
                <span class="icon-bar"></span>
                <span class="icon-bar"></span>
                <span class="icon-bar"></span>
    		</button>
    		<a class="navbar-brand" href="#">Brand</a>
    	</div>

    	<div class="collapse navbar-collapse" id="bs-example-navbar-collapse-1">
    		<ul class="nav navbar-nav">
				<li class="active"><a href="#">Link</a></li>
        		<li><a href="#">Link</a></li>
        		<li class="dropdown">
        			<a href="#" class="dropdown-toggle" data-toggle="dropdown">Dropdown <b class="caret"></b></a>
        			<ul class="dropdown-menu">
					  <li><a href="#">Action</a></li>
					  <li><a href="#">Another action</a></li>
					  <li><a href="#">Something else here</a></li>
					  <li class="divider"></li>
					  <li><a href="#">Separated link</a></li>
					  <li class="divider"></li>
				      <li><a href="#">One more separated link</a></li>
        			</ul>
        		</li>
    		</ul>
    	</div>
	</div>
</nav>
	    		

Besides the default navbar, we added 5 new colors: primary, blue, green, orange, red. If you want to use one of them, you have to replace the .navbar-default or .navbar-primary with the class for the chosen colour .navbar-info, .navbar-success, .navbar-warning or .navbar-danger.

Besides all this customisation, we have an extra navbar. .navbar-transparent is a special class that you can to use if you want the navbar to be transparent.

Nav Pills

We changed the design for the Bootstrap nav pills into something a bit more fresh. We have also added more colour classes for customisation like .nav-pills-primary, .nav-pills-info, .nav-pills-success, .nav-pills-warning, .nav-pills-danger.

Simple

We added coloured shadows to the pills and created two options: horizontal and vertical (using the class .nav-stacked).

With Icons

If you want to also add icons, you can use this version with the two options: horizontal and vertical. To use them, please add the .nav-pills-icons class.

<!-- simple and horizontal -->
<ul class="nav nav-pills nav-pills-info">
  <li class="active"><a href="#pill1" data-toggle="tab">Profile</a></li>
  <li><a href="#pill2" data-toggle="tab">Settings</a></li>
  <li><a href="#pill3" data-toggle="tab">Options</a></li>
</ul>

<!-- simple and vertical -->
<ul class="nav nav-pills nav-pills-info nav-stacked">
  <li class="active"><a href="#tab1" data-toggle="tab">Profile</a></li>
  <li><a href="#tab2" data-toggle="tab">Settings</a></li>
  <li><a href="#tab3" data-toggle="tab">Options</a></li>
</ul>

<!-- with icons and horizontal -->
<ul class="nav nav-pills nav-pills-icons nav-pills-primary" role="tablist">
	<li>
		<a href="#dashboard" role="tab" data-toggle="tab">
			<i class="material-icons">dashboard</i>
			Dashboard
		</a>
	</li>
	<li class="active">
		<a href="#schedule" role="tab" data-toggle="tab">
			<i class="material-icons">schedule</i>
			Schedule
		</a>
	</li>
	<li>
		<a href="#tasks" role="tab" data-toggle="tab">
			<i class="material-icons">list</i>
			Tasks
		</a>
	</li>
</ul>

<!-- with icons and vertical -->
<ul class="nav nav-pills nav-pills-icons nav-stacked" role="tablist">
	<li class="active">
		<a href="#dashboard-2" role="tab" data-toggle="tab">
			<i class="material-icons">dashboard</i>
			Dashboard
		</a>
	</li>
	<li >
        <a href="#schedule-2" role="tab" data-toggle="tab">
			<i class="material-icons">schedule</i>
			Schedule
        </a>
    </li>
</ul>
        		

Tables

All Boostrap classes for tables are supported and improved.

Simple Table inside a card

<div class="card">
	<div class="card-header" data-background-color="purple">
		<h4 class="title">Table Title</h4>
		<p class="category">Here is a subtitle for this table</p>
	</div>
	<div class="card-content table-responsive table-full-width">
		<table class="table">
			<thead class="text-danger">
				<th>Name</th>
				<th>Country</th>
				<th>City</th>
				<th>Salary</th>
			</thead>
			<tbody>
				<tr>
					<td>Dakota Rice</td>
					<td>Niger</td>
					<td>Oud-Turnhout</td>
					<td class="text-primary">$36,738</td>
				</tr>
				<tr>
					<td>Minerva Hooper</td>
					<td>Curaçao</td>
					<td>Sinaai-Waas</td>
					<td class="text-primary">$23,789</td>
				</tr>
				<tr>
					<td>Sage Rodriguez</td>
					<td>Netherlands</td>
					<td>Baileux</td>
					<td class="text-primary">$56,142</td>
				</tr>
				<tr>
					<td>Philip Chaney</td>
					<td>Korea, South</td>
					<td>Overland Park</td>
					<td class="text-primary">$38,735</td>
				</tr>
				<tr>
					<td>Doris Greene</td>
					<td>Malawi</td>
					<td>Feldkirchen in Kärnten</td>
					<td class="text-primary">$63,542</td>
				</tr>
				<tr>
					<td>Mason Porter</td>
					<td>Chile</td>
					<td>Gloucester</td>
					<td class="text-primary">$78,615</td>
				</tr>
			</tbody>
		</table>

	</div>
</div>
		    

Material Icons

Through most of the examples in this dashboard, we have used the default Icons for the Material Design provided by Google.

<i class="material-icons">face</i>
			

Notifications

The new notifications are looking fresh and clean. They go great with the navbar. For the following notification examples we used the .container-fluid class, so they will be fluid. Please use the class .container when you use them outside of the .wrapper so they will be aligned with the general page container.

<div class="alert alert-info">
<div class="container-fluid">
  <div class="alert-icon">
	<i class="material-icons">info_outline</i>
  </div>
  <button type="button" class="close" data-dismiss="alert" aria-label="Close">
	<span aria-hidden="true"><i class="material-icons">clear</i></span>
  </button>
  <b>Info alert:</b> You've got some friends nearby, stop looking at your phone and find them...
</div>
</div>

<div class="alert alert-success">
<div class="container-fluid">
  <div class="alert-icon">
	<i class="material-icons">check</i>
  </div>
  <button type="button" class="close" data-dismiss="alert" aria-label="Close">
	<span aria-hidden="true"><i class="material-icons">clear</i></span>
  </button>
  <b>Success Alert:</b> Yuhuuu! You've got your $11.99 album from The Weeknd
</div>
</div>

<div class="alert alert-warning">
<div class="container-fluid">
  <div class="alert-icon">
	<i class="material-icons">warning</i>
  </div>
  <button type="button" class="close" data-dismiss="alert" aria-label="Close">
	<span aria-hidden="true"><i class="material-icons">clear</i></span>
  </button>
  <b>Warning Alert:</b> Hey, it looks like you still have the "copyright &copy;  2015" in your footer. Please update it!
</div>
</div>

<div class="alert alert-danger">
<div class="container-fluid">
  <div class="alert-icon">
    <i class="material-icons">error_outline</i>
  </div>
  <button type="button" class="close" data-dismiss="alert" aria-label="Close">
	<span aria-hidden="true"><i class="material-icons">clear</i></span>
  </button>
  <b>Error Alert:</b> Damn man! You screwed up the server this time. You should find a good excuse for your Boss...
</div>
</div>
				

Cards

We think cards are one of the best ways to organise your information. We went all out with possibilities and we recommended finding the right fit for your product. The general class for a card is called .card. The information inside the card usually goes inside the content (class .card-content). The content can have three types of elements inside: .title and .category. You can optionally add a .card-footer, if you want to place a call-to-action.
You can change the color of the header using the data-background-color attribute like this: data-background-color="{ purple | blue | green | orange | red }".
If you want to use the cards on white background you can remove it's shadow using the class .card-plain

Card Chart

<div class="col-md-6">
	<div class="card">
		<div class="card-header card-chart" data-background-color="orange">
			<div class="ct-chart" id="dailySalesChart"></div>
		</div>
		<div class="card-content">
			<h4 class="title">Daily Sales</h4>
			<p class="category"><span class="text-success"><i class="fa fa-long-arrow-up"></i> 55%  </span> increase in today sales.</p>
		</div>
		<div class="card-footer">
			<div class="stats">
				<i class="material-icons">access_time</i> updated 4 minutes ago
			</div>
		</div>
	</div>
</div>

// INFO: #dailySalesChart is initialised inside demo.js on method initDocumentationCharts
                

Card Stats

<div class="card card-stats">
	<div class="card-header" data-background-color="orange">
		<i class="material-icons">content_copy</i>
	</div>
	<div class="card-content">
		<p class="category">Used Space</p>
		<h3 class="title">49/50<small>GB</small></h3>
	</div>
	<div class="card-footer">
		<div class="stats">
			<i class="material-icons text-danger">warning</i> <a href="#pablo">Get More Space...</a>
		</div>
	</div>
</div>
                

Card Nav-Tabs

<div class="card card-nav-tabs">
	<div class="card-header" data-background-color="purple">
		<div class="nav-tabs-navigation">
			<div class="nav-tabs-wrapper">
				<span class="nav-tabs-title">Tasks:</span>
				<ul class="nav nav-tabs" data-tabs="tabs">
					<li class="active">
						<a href="#profile" data-toggle="tab">
							<i class="material-icons">bug_report</i>
							First
						<div class="ripple-container"></div></a>
					</li>
					<li class="">
						<a href="#messages" data-toggle="tab">
							<i class="material-icons">code</i>
							Second
						<div class="ripple-container"></div></a>
					</li>
					<li class="">
						<a href="#settings" data-toggle="tab">
							<i class="material-icons">cloud</i>
							Third
						<div class="ripple-container"></div></a>
					</li>
				</ul>
			</div>
		</div>
	</div>

	<div class="card-content">
		<div class="tab-content">
			<div class="tab-pane active" id="profile">
				First Tab
			</div>
			<div class="tab-pane" id="messages">
				Second Tab
			</div>
			<div class="tab-pane" id="settings">
				Third Tab
			</div>
		</div>
	</div>

</div>

                

Changing Colors (SASS)

You can change the default colors via variables from SASS:

1. You can find the colors in assets/sass/material-kit/_variables.scss starting with line 28 where is the primary color set: $brand-primary: $purple !default;. All the possible colors are in assets/sass/material-kit/_colors.scss
2. Add the SASS folder from assets/sass/ the project inside Koala Compiler and find the file material-dashboard.scss, it will be the one in Green.
3. Right click on that file and set the output path, it must be in assets/css/ so anything that you compile will overwrite the original material-dashboard.css
4. Press on compile and everything will be done automatically