Branch: master
Find file History
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


Automatically generate markdown documentation of your generated asset-bundle bundles.

Table of contents


npm install --save asset-list


There are 2 different usage, directly with the asset-bundle module or as part of the asset-webpack. Both use the same options, the only difference is how you enable the plugin.

This documentation generation is a synchronous process, it will happen before the completion callback is called of asset-bundle. And we will automatically write the file to the same output directory that contains the generated bundle.

So when you generate an ./dist/assets.svgs this module will also add an ./dist/ which contains the generated documentation.


The options should be supplied as an object, the following properties are supported:

  • file Path of where the bundle and documentation should be stored. When you using the asset-webpack this will be set automatically to the output path.
  • hosted Indication that the SVG assets should reference a hosted server instead of a local, relative file path to the asset.
  • separator The separator that is used to indicate namespaces/categories in asset names. Defaults to require('path').sep so it's a folder separator.


When using asset-webpack you can use the plugins option to supply a list of plugins. The notable difference here is that you do not need to supply the file option. This is set automatically by the WebPack plugin to the specified output file.

import Pipeline from 'asset-webpack';
import List from 'asset-list';
import path from 'path';

module.exports = {
  entry: path.join(__dirname, 'index.js'),
  output: {
    path: path.resolve(__dirname, 'dist'),
    filename: 'output.js'

  module: {
    loaders: [
      { test: /\.svg$/, loaders: ['file-loader'] }

  plugins: [
    new Pipeline('bundle.svgs', {
      namespace: true,
      plugins: [
        [List, { /* asset-list options here */ }]


The asset-bundle provides a plugin method that is used to register plugins. The first argument should be the constructor, and the second argument the options that this library accepts. The file option is required.

import Bundle from 'asset-bundle';
import List from 'asset-list';
import path from 'path';
import fs from 'fs';

const bundle = new Bundle([ path.join(__dirname, 'test', 'fixtures', 'godaddy.svg'); ]);
const output = path.join(__dirname, 'bundle.svg');

// Add the plugin to the bundle process using the `.plugin` module.
bundle.plugin(List, { file: output });

// Once the bundle is done, it will generate all the things.
//, str) => {
  fs.writeFileSync(output, str);


Below is an example output of the documentation that is generated about our 3 example assets:


Table of Contents

Bundle details

  • 31.03KB compressed(gzip).
  • 81.26KB uncompressed.
  • Contains 3 assets.
  • Build according to specification: 0.1.0

The bundle can be included using the asset-provider components:

import Provider, { Asset } from "asset-parser";

<Provider uri="./bundle.svgs">
  <!-- Add the <Asset />s here -->

Learn more about asset-provider components.



name width height preview
godaddy 127 55.2
<Asset name="godaddy" width={ 127 } height={ 55.2 } />


name width height preview
tiger 493.87457275390625 509.17413330078125
<Asset name="tiger" width={ 493.87457275390625 } height={ 509.17413330078125 } />


name width height preview
homer 457.2821960449219 490.2279052734375
<Asset name="homer" width={ 457.2821960449219 } height={ 490.2279052734375 } />