The official Broccoli plugin for the LivingStyleGuide
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.

LivingStyleGuide for Broccoli

Easily create living style guides/front-end style guides/pattern libraries by adding Markdown documentation to your Sass project. Follow @LSGorg for updates.


Warning: this is in early alpha. I’m neither a NPM nor a Broccoli expert. Let me know if you have suggestions to improve via Twitter or open an issue.


1. Setup

Make sure Ruby is installed (on Mac OS Ruby is installed by default) and create a file named Gemfile in your project’s path:

source ''
gem 'livingstyleguide'

Add to the plugin to your dependencies in your package.json:

  "dependencies": {
    "broccoli-livingstyleguide": "^0.1.0"

Install dependencies via command line:

npm install

Assuming you have a stylesheet called app/styles/app.scss (as Ember CLI does) add this your Brocfile.js:

var LivingStyleGuide = require('broccoli-livingstyleguide');
var lsg = LivingStyleGuide(['app'], 'styles/styleguide.lsg', 'assets/styleguide.html');
module.exports = lsg;

Ember CLI

For ember-cli, you have to manually install broccoli-merge-trees: npm install broccoli-merge-trees --save-dev and change your ember-cli-build.js as follows:

var EmberApp = require('ember-cli/lib/broccoli/ember-app');
var mergeTrees = require('broccoli-merge-trees');

var LivingStyleGuide = require('broccoli-livingstyleguide');
var lsg = LivingStyleGuide(['app'], 'styles/styleguide.lsg', 'assets/styleguide.html');

module.exports = function (defaults) {
    var app = new EmberApp(defaults, { });

    return mergeTrees([app.toTree(), lsg]);

2. Create a file app/styles/styleguide.lsg containing

source: 'app.scss'
title: 'My Living Style Guide'

3. Write documentation for each module app/styles/partials/ (to describe _buttons.scss in the same folder)


<button class="button">Example button</button>

<button class="button -primary">Example button</button>

4. Open the generated dist/assets/styleguide.html

Make sure to check out the documentation for writing examples and learn how to display colors from variables, use template languages, and helper functions.


  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request


Copyright 2014—2015 Nico Hagenburger. See for details. Get in touch with @hagenburger on Twitter or open an issue.