Skip to content
This repository has been archived by the owner on Nov 21, 2022. It is now read-only.

CINBCUniversal/sassypam

Repository files navigation

SassyPAM Gem Version Bower Version

SassyPam is our distributed style toolkit for different apps. Currently you can use SassyPAM using Ruby or Bower. More integrations are coming out soon!

SassyPAM is maintained by the PAM Design Team. Please contact them if you have any questions.


Ruby Installation

Add this line to your application's Gemfile:

gem 'sassypam', git: 'git@github.com:CINBCUniversal/sassypam.git'

And then execute:

$ bundle

Or install it yourself as:

$ gem install sassypam

Node Installation

You must have Bower installed first:

$ npm install -g bower

Using sassypam as a Bower package is still being tested. It is compatible with node-sass 0.8.3+:

$ bower install sassypam

Usage

Once you've installed the SassyPAM toolkit, use it by calling the main file in your application.sass/scss: remember sassypam has a dependancy on bootstrap and your application.sass/scss must be in root/css to be able to access root/bower_components

@import "../bower_components/bootstrap-sass/assets/stylesheets/bootstrap";

@import "../bower_components/sassypam/vendor/assets/stylesheets/sassypam_bower.sass";

Contributing

  1. Create your feature branch (git checkout -b my-new-feature)
  2. Commit your changes (git commit -am 'Add some feature')
  3. Push to the branch (git push origin my-new-feature)
  4. Create new Pull Request

Setting up development dependencies

$ rvm install ruby-2.2.0
$ bundle
$ npm install
$ npm install -g grunt grunt-cli

Updating Styleguide

Make sure you can run git hooks, once you push, we'll interactively take you to through the steps of pushing to gh-pages

$ chmod +x .git/hooks/pre-push

//Old steps, will take out once script is fully complete

$ grunt sass # Only necessary if you change CSS rules
$ hologram # Regenerates styleguide when you change hologram comment docs
$ open docs/index.html

Updating Bower Registry

Bower requires a semver tagging rules (visit http://bower.io/), when pushing an update. It'll look something like this:

commit your changes

$ git commit -am "Made some awesome new changes, now its even awesomer"

tag the commit

$ git tag -a v 0.0.5 -m "Release version 0.0.5"
$ bower version patch -m "Made some awesome new changes, now its even awesomer"

push to GitHub

$ git push origin master --tags

Updating Ruby Gem

Gem versions are automatically tracked when running bundle update within a ruby app environment. But we'll from time to time change the version number when making large updates.

$ cd ./lib/sassypam
$ mvim version.rb

Then change it to the correct version