A complete CSS framework for Stylus
kouto swiss is a complete CSS framework for Stylus, inspired by great tools like nib, compass, bourbon…
$ npm install --save-dev kouto-swissFor grunt, you can use grunt-contrib-stylus, and include kouto swiss in your use option for the task.
You can also use grunt-ks-stylus, which is a fork of grunt-contrib-stylus, with kouto swiss included.
For gulp, use gulp-stylus and include kouto swiss in your use option for the task.
On some IDEs like PHPStorm and Webstorm, you can automatically compile your styles as they change, without relying on a third-party tool. In PHPStorm and Webstorm, this functionality is known as file watchers. To use with PHPStorm or WebStorm, as a file watcher, simply:
- Ensure you have added
kouto-swissas a dependency:
$ npm install --save-dev kouto-swiss
- Do an
npm install - Create a new file watcher with settings like these:
- Create an
@importin one of you.stylfiles:
@import "../../../node_modules/kouto-swiss" // import kuoto-swiss for auto-prefixing (or whatever relative path where node-modules lives
To use kouto swiss with third-party tools like Codekit or Prepros, you should include kouto swiss on your project by yourself. You can download it on github.
More information coming soon.
There's an example of how to use stylus with kouto-swiss within Connect or Express.
var connect = require( "connect" ),
stylus = require( "stylus" ),
koutoSwiss = require( "kouto-swiss" ),
server = connect();
function compile( str, path ) {
return stylus( str )
.set( "filename", path )
.set( "compress", true )
.use( koutoSwiss() );
}
server.use( stylus.middleware( {
src: __dirname,
compile: compile
} ) );
To gain access to the kouto swiss tools from your Stylus files, simply add:
@import "kouto-swiss"In lieu of a formal styleguide, take care to maintain the existing coding style.
Add unit tests and update the docs for any new or changed functionality.
More informations in the CONTRIBUTING.md file.
I am committed to improving the readability of documents with heart and soul. As you can see, I'm not a native English speaker. I need your help.
If you want to help the kouto swiss project, but don't want to write code, please consider reviewing the docs, correcting my very bad English.
Many thanks!
- 2014-08-18: version
0.10.0: some breaking changes in box-sizing mixin. - 2014-07-19: version
0.9.0: some breaking changes in media-queries management. - 2014-06-30: version
0.8.0: first stable version of the lib, including website & docs. - 2014-05-20: version
0.1.0: first version of the lib, including nearly all the basics. - 2014-05-05: version
0.0.1: first publish on npm, still in early stages of development. - 2014-05-03: starting project
- allow users to choose the vendor prefixes they want to use
- write how-to for CodeKit & Prepros
- IE 8 media queries fallback
- release 0.9
- docset for dash
- community returns
- release 1.0
- grid background helper
Copyright (c) 2014 krkn
Licensed under the MIT license.