A Stylesguide parser (and example generator) for creating living styleguides, based on kss - http://github.com/kneath/kss.
JSS currently conforms exactly to the KSS spec - found here:
You can get started quickly by copying the example:
The methodology and ideas behind Knyle Style Sheets are contained in SPEC.md. At it's core, KSS is a documenting syntax for CSS. JSS conforms exactly to those ideas. Here's an example:
/*A button suitable for giving stars to someone.:hover - Subtle hover highlight..stars-given - A highlight indicating you've already given a star..stars-given:hover - Subtle hover highlight on top of stars-given styling..disabled - Dims the button to indicate it cannot be used.Styleguide 2.1.3.*/
This repository is also the npm package, and should not be used as a substitute for it. Someone already had "jss" on npm (disputing, we'll see.), so as of speaking, you can install jss by doing a simple:
npm install jss-styles, or add it to your package.json file and do an
npm install .
Once you have jss as a dependency, you can use the example folder either found here in this repo or at
node_modules/jss-style/example once you've installed jss as a starting point.
Currently I wouldn't recommend playing with the logic in app.js, but I'm not making any rules. The quickest way to get started is to copy the example folder, edit the stylesheets, index.html, styleguide.html, and layout.html files.
- kss.js (compiled js, directly pulled from kss)
For an example of how to generate a styleguide, check out the
example express application.
To hack on JSS - fork away, go crazy. JSS has no dependencies except underscore, which is currently packaged with it. (Probably will change that in the future.)
Unfortunately no unit tests are in yet - this is the next step, so expect them in soon.