> For the complete documentation index, see [llms.txt](https://aurelia-ui-toolkits-1.gitbook.io/materialize-bridge-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://aurelia-ui-toolkits-1.gitbook.io/materialize-bridge-docs/master/2.-installation/fuse-box-2.x.md).

# Fuse-box 2.x

## Getting the plugin

In your project install the plugin via npm with the following command:

```
  $ npm install --save aurelia-materialize-bridge materialize-css
```

You will also need a fuse-box loader. At the moment, there are two that I know of:

* <https://github.com/fuse-box/fuse-box-aurelia-loader>:

  `npm install --save git://github.com/fuse-box/fuse-box-aurelia-loader`
* <https://github.com/arabsight/aurelia-loader-fusebox>

  `npm install --save aurelia-loader-fusebox`

This document will use the first since it's the official loader. But the second by arabsight is a good one as well. :-)

## Configure your app

1. Make sure you use [manual bootstrapping](http://aurelia.io/hub.html#/doc/article/aurelia/framework/latest/app-configuration-and-startup/4). In order to do so open your `index.html` and locate the element with the attribute aurelia-app:

   ```markup
   <body aurelia-app="main">
   ```

   For Material Design icons include this in your `index.html` head section:

   ```markup
    <link href="https://fonts.googleapis.com/icon?family=Material+Icons" rel="stylesheet">
   ```
2. Update `main.js` in your `src` folder with following content:

   ```javascript
   import {Aurelia} from 'aurelia-framework';
   import 'fuse-box-aurelia-loader';
   import 'aurelia-bootstrapper';

   export async function configure(aurelia: Aurelia) {
    aurelia.use
      .standardConfiguration()
      .developmentLogging();

    aurelia.use.plugin('aurelia-materialize-bridge', b => b.useAll().preventWavesAttach());

    await aurelia.start();
    await aurelia.setRoot('app');
   }
   ```

   **Note:** The above shows how to use all available controls at once. If you choose to pick which you'd like to use, you can `use` single components like this:

   ```javascript
   .plugin('aurelia-materialize-bridge', bridge => {
    bridge
      .useButton()
      .useCollapsible()
      .useModal()
      .useTabs();
   });
   ```

   At the end of this page is a full list of currently available options.
3. Import css:

   ```markup
   <require from="materialize-css-styles/bin/materialize.css"></require>
   ```
4. Configure Fuse-box:

   ```javascript
   const { RawPlugin, FuseBox, HTMLPlugin, CSSPlugin } = require("fuse-box");

   const fuse = FuseBox.init({
      homeDir: './src',
      output: './dist/$name.js',
      plugins: [
        CSSPlugin(),
        HTMLPlugin(),
        RawPlugin(['.css'])
      ],
      alias: {
        'jQuery': 'jquery',
      },
      shim: {
        jquery: {
            source: 'node_modules/jquery/dist/jquery.js',
            exports: '$'
        },
        // Materialize needs a shim here to be placed at the top of the bundle.
        // It's necessary because loading the module introduces side-effects
        // and it exports globals.
        'materialize-css': {
          source: 'node_modules/materialize-css/bin/materialize.js',
          exports: 'Materialize'
        }
      }
   });

   // Because we created a shim above, we need to bundle Materialize's CSS
   // with a different name. Otherwise fuse-box will not bundle the CSS.
   // So we trick fuse-box to load a css-only module by giving meaningless (space) instructions.
   fuse.register('materialize-css-styles', {
    homeDir: 'node_modules/materialize-css',
    main: 'bin/materialize.css',
    instructions: ' '
   });

   // Register the bridge and its contents.
   fuse.register('aurelia-materialize-bridge', {
    homeDir: 'node_modules/aurelia-materialize-bridge/dist/commonjs',
    main: 'index.js',
    instructions: '**/*.{html,css,js}'
   });

   fuse.bundle('app')
    .watch().cache(false)
    .instructions(`
      > main.ts
      + **/*.{ts,html,css}
      + aurelia-pal
      + aurelia-pal-browser
      + aurelia-framework 
      + aurelia-logging-console 
      + aurelia-templating-binding 
      + aurelia-templating-resources 
      + aurelia-event-aggregator 
      + aurelia-history-browser 
      + aurelia-templating-router
      + aurelia-materialize-bridge
      + materialize-css-styles
    `);

   fuse.dev({ port: 4445, root: './' });
   fuse.run();
   ```
5. Add the bundle result to `index.html`

   ```markup
    <!DOCTYPE html>
    <html>
    <head>
        <meta charset="utf-8">
        <meta name="viewport" content="width=device-width, initial-scale=1">
        <title>Welcome to Aurelia with FuseBox</title>
        <link href="https://fonts.googleapis.com/icon?family=Material+Icons" rel="stylesheet">
    </head>

    <body aurelia-app="main">
        <script type="text/javascript" charset="utf-8" src="./dist/app.js"></script>
    </body>
    </html>
   ```

## You are done!

It is now possible to drop some custom-elements into your DOM. See the other pages on this website for detailed information on how to do this.

**Now you might want to do our** [**app developers tutorial**](https://aurelia-ui-toolkits.gitbooks.io/materialize-bridge-docs/content/app_developers_tutorial/introduction.html)**, based on Aurelia Skeleton navigation.**

As described above, here is a full list of currently available options:

```javascript
aurelia.use.plugin('aurelia-materialize-bridge', bridge => {
  bridge
    .useAutoComplete()
    .useBadge()
    .useBreadcrumbs()
    .useBox()
    .useButton()
    .useCard()
    .useCarousel()
    .useCharacterCounter()
    .useCheckbox()
    .useChip()
    .useCollapsible()
    .useCollection()
    .useColors()
    .useDatePicker()
    .useDropdown()
    .useFab()
    .useFile()
    .useFooter()
    .useInput()
    .useModal()
    .useNavbar()
    .usePagination()
    .useParallax()
    .useProgress()
    .usePushpin()
    .useRadio()
    .useRange()
    .useScrollfire()
    .useScrollSpy()
    .useSelect()
    .useSidenav()
    .useSlider()
    .useSwitch()
    .useTabs()
    .useTooltip()
    .useTransitions()
    .useWaves()
    .useWell();
});
```