Comments on Style Guide Generator Roundup

8 Reader Comments

Back to the Post
  1. It’s awesome how many initiatives arises around Living Style Guides topic, in fact, yesterday I also presented an in-depth overview of Style Guide tools. I covered almost all the tools mentioned in this post, but I also grouped them by type and defined which projects they will fit most.


    Here’s the recording of my talk - Maintaining Own Components Library with Living Style Guides (slides).


    I am the founder of SourceJS Living Style Guide platform. Let me correct you on this one, SourceJS is not a generator, and it is not Grunt based (we only use it to build Less and minify JS). In fact, we call it a Platform, since it supports plugins and render documentation pages in runtime with NodeJS.


    SourceJS follow the similar file structure as in Pattern Lab, Fabricator or Living Style Guide gem, but by default uses EJS and follow the best component organization structure (when all resources are stored in one folder). It’a already available to use Jade plugin as an alternative, and Markdown in special tag. SourceJS engine during the next month will get full support of the features that other tools have and you will be able to use Markdown as a main spec description format.


    I am preparing a blog article about the evolution of Front-end Style Guides, where I will cover some additional practices that we use in SourceJS. We treat components library as a communication platform for the team, using some commenting plugins and also as a development platform, following the Style Guide driven development.


    Also, I would highly recommend to check out DSS, a standalone CSS Documentation parser.

    Copy & paste the code below to embed this comment.
  2. Really timely article—have been researching recently. This is a related article about creating a living style guide and application architecture: http://ianfeather.co.uk/a-maintainable-style-guide/

    Copy & paste the code below to embed this comment.
  3. Thank you for a better look at some of the options, Susan. Thankfully interest in Styleguides is growing and there are a lot of generators to choose from today. Articles like this help us pick an appropriate tool.

    Tip: I love styleguides.io but for another simple(!) overview of tools there’s also github.com/davidhund/styleguide-generators

    Copy & paste the code below to embed this comment.
  4. Good stuff here, very useful.
    Thanks for a great article

    Copy & paste the code below to embed this comment.
  5. Thanks for sharing Fabricator, that looks very cool. I use Grunt already so that’s going to be my generator of choice if I choose to go down that route.

    Copy & paste the code below to embed this comment.
  6. Thanks for mentioning Fabricator. Glad you dig it.

    Just moved the project, so the link in the article no longer works. Here’s the new home: http://fbrctr.github.io/ and link to sample UI toolkit

    Copy & paste the code below to embed this comment.
  7. a very good idea.. piastra per capelli

    Copy & paste the code below to embed this comment.
  8. a very good idea.. piastra per capelli

    Copy & paste the code below to embed this comment.