Swiftbrowser uses Zurb Foundation as an alternative to Twitter Bootstrap. Foundation is an instance of a Compass project. Compass projects come with a convenient tool that compiles Sass and concatenates it into one file.
- Ruby version 2.0 or greater
-
Install Compass.
sudo gem install compass -v 1.0.3
-
Install Foundation. Currently we are using Foundation 5. Foundation 6 is available but we haven't had time to upgrade to it yet. As you can see, the instructions below specifies installing foundation 1.0.4. This refers to the Foundation CLI. Version 1.0.4 of the Foundation CLI 1.0.4 is linked to Foundation 5.
sudo gem install foundation -v 1.0.4
-
From the django-swiftbrowser repository root, change into the compass project directory.
cd swiftbrowser/static/foundation
-
Run Compass.
compass watch
Now anytime you save files within swiftbrowser/static/foundation/scss/
, Compass will compile it into swiftbrowser/static/foundation/stylesheets/app.css
which is used on every page in swiftbrowser.