Susy is a semantic CSS grid system with a responsive twist.
The web is a responsive place, from your lithe & lively development process to your end user's super-tablet-multi-magic-lap-phone. You need grids that are powerful, but custom; reliable, but responsive.
Susy grids are fluid on the inside, ready to respond at any moment, but contained in the candy shell of your choice, so they respond how and when and where you want them to.
This isn't another one-size-fits-all grid framework that will make your sites look identical and litter your markup with meaningless "col2of5" jargon. We don't design your site or write your markup, we just do the math and get out of your way.
We love contributions,
both as ideas and pull requests.
The core of Susy is all in the /sass/ directory.
Once you make changes, you can test them by building the gem and installing it somewhere to test. We also have unit tests that you can run.
You'll need Rake and Echoe installed:
# command line
gem install rake
gem install echoeIt might be helpful to bump the version number in VERSION,
but any changes you make there
should not be committed.
Then you can build:
# command line
rake buildYour new gem will appear in
a folder called pkg.
You can install it for testing
directly from there.
# command line
gem install <path-to-file>If you are adding features or changing how a current feature works, your changes should be documented. Or you might be helping us maintain the docs. In either case, you'll need to run the docs dev server in order to see your changes.
In the docs folder:
# command line
gem install bundler
bundle installThe site is built with middleman. To run the development server:
# command line
middlemanThe server should now be running at localhost:4567.
Make any changes you need
under the source directory,
then commit your changes
and submit a pull request when you are done!
The tests we have are very basic at this point.
Simply go into the test directory
(with the latest Sass and Compass gems installed)
and run compass compile --force.
There should be no changes. If there are changes, go back and find what caused the change. If the change was intentional, simply commit the changed test files. If it was not intentional, go back and find what caused the problem.
Use git diff to see the changes.