Skip to content
Material design for Aurelia
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


Aurelia wrapper for Material Design Lite.

Material Design Lite has been designed for static html sites. To use it on dynamic ones, we have to register explictly new DOM elements (see MDL)

Aurelia Material will do that for you transparently while keeping MDL flexibility.

See online Demo


We created the CustomAttribute mdl in charge of the registration of dynamic elements (all elements after index.html will be associated dynamically to the DOM with Aurelia)

So instead of writing:

<button class="mdl-button mdl-js-button mdl-button--fab mdl-button--colored">
  <i class="material-icons">add</i>

You will write in your views:

<button mdl="button" class="mdl-button--fab mdl-button--colored">
  <i class="material-icons">add</i>

And that's all...

mdl values are :

[ 'button',
  'snackbar' ]

Some MDL elements are not in the list because we don't have to register them, so we can use them as it.


  1. In your project install the plugin via jspm with following command
  $ jspm install github:redpelicans/aurelia-material
  1. Make sure you use manual bootstrapping. In order to do so open your index.html and locate the element with the attribute aurelia-app:
<body aurelia-app="main">
  1. Update main.js in your src folder with following content:
export function configure(aurelia) {
    // Install the plugin

  aurelia.start().then(a => a.setRoot());
  1. Include material design css in your index.html
    <link rel="stylesheet" href="">
  1. Use wrapped MDL components in your hml views as explained below.

See online Demo

You can’t perform that action at this time.