Create a Style Guide
To add a style guide, use the style guide generator.
Run the generator without arguments to view help:
cd path/to/your_app bin/rails g workarea:style_guide
Your results will look something like this:
Usage: rails generate workarea:style_guide ENGINE SECTION NAME [options] Runtime options: -f, [--force] # Overwrite files that already exist -p, [--pretend], [--no-pretend] # Run but do not make any changes -q, [--quiet], [--no-quiet] # Suppress status output -s, [--skip], [--no-skip] # Skip files that already exist Options: ENGINE is either: - admin - storefront SECTION is an existing section, the workarea gem offers these sections out of the box: - settings - base - typography - objects - components - trumps NAME is the name of your partial, separated with dashes: - button - button--large - table--prices Description: Creates a new Style Guide entry for your application. Examples: rails g workarea:style_guide storefront components button rails g workarea:style_guide admin components button--large
Style Guide Partial Paths
The style guide generator creates a new style guide partial at the correct path in your app (corresponding to the arguments you pass it).
For example, the partial for an Admin component goes here:
The contents of that partial are viewable in the browser at the following paths: