OSX

For Macs, I recommend using rvm. This allows you to get and upgrade your Rubies without messing with the system Ruby (which is often old and out of date).

A lot of Mac users like to use Homebrew to manage their native dependencies (e.g. cairo, pango). This is not strictly necessary, but it does allow you to upgrade/downgrade your native dependencies as issues arise. When you do change a native dependency with Homebrew, make sure you brew uninstall your older libraries so that Ruby doesn't get confused. This lesson was learned from #121.

Some users have reported that Ruby 2.1 will not work with Mac OSX 10.10.4 (see issue #88) - Ruby 2.0 and 2.2 are confirmed to work however. Note that this was an rcairo+clang issue, not a Squib issue.

We have also seen that some other build libraries are needed.