ohrite/style-guide

A mountable Rails engine where you curate and view your site's visual elements.

Style Guide

Style Guide is a mountable Rails engine where you curate and view your site's visual elements.

Tutorials on important topics, such as creating your own Style Guide sections, writing documentation for visual elements and more can be found in the Style Guide wiki.

Features

• Simple: just directories of partials
• Responsive: see how everything looks on a mobile device
• Live: file changes are presented immediately when using LiveReload
• Documentation-aware: each partial can be documented with an i18n scope

Anti-Features

• Not a Layout Guide: visual elements should not be composed
• Not a linting tool: no warnings or errors are displayed
• Curated, not magic: providing fake data for partials is not covered

Example

You can see an example of Style Guide at swivel's automatically-deployed testing instance: http://swivel.herokuapp.com

Installation

The simplest way to install Style Guide is to use Bundler.

Add Style Guide to your Gemfile:

group :development do
  gem 'style-guide'
end

Then, use Bundler to install the gem and its dependencies:

$ bundle install

Last, run the Rails generator to configure your app:

$ rails g style_guide:install

The generator will install guard-livereload and rack-livereload.

Consult the Style Guide wiki for more information about what the generator does.

Contributing

• Fork the project.
• Make your feature addition or bug fix.
• Add tests for it. This is important because breaking your feature in a future version unintentionally is sad.
• Issue a pull request. Bonus points for topic branches.

Authors

• Doc Ritezel
• Ofri Afek

Contributors

• Rob Head
• Can Berk Güder
• Dennis Schmidt

Special Thanks

• @tildewill, @emstar and @ajmurmann for fantastic input during the initial development process
• Dmitriy Kalinin for being himself

License

See LICENSE for more information.