Skip to content

Installation

Sam Richard edited this page Apr 22, 2017 · 21 revisions

Singularity is a next generation grid framework built from the ground up to be responsive built for use with Sass and Compass. Below are instructions for setting up Singularity.

Installation

The preferred way to install and use Singularity is through NPM as an Eyeglass module or through Bower. You can install Breakpoint if you're using responsive grids by adding breakpoint-sass after singularity in the following command:

$ npm install singularitygs --save-dev
$ bower install singularity --save

You can also install Singularity as a Compass extension. If you do, the the preferred way to do so is via Bundler. To do so, add the following to your Gemfile (Sass and Compass are provided to ensure the correct versions are used):

gem "sass", "~>3.3"
gem "compass", "~>1.0"
gem "singularitygs", "~>1.4"

Once you have done so, run bundle install to install your dependencies, and remember to run all of your compilation through bundle exec.

Using

If you already have a project made and you'd like to use Singularity with it, add the following to your config.rb file:

require 'singularitygs'

Then, add the following to your Sass file towards the top:

@import "singularitygs";