Develop on OSX

Develop on OSX

To get RapidFTR running on your machine while its in a dev environment, you'll need to install the following:

• Install XCode from the Mac App Store
• Install Homebrew
• Make sure Homebrew is configured properly: brew doctor
• CouchDB: brew install couchdb
• LibXML2: brew install libxml2
• ImageMagick: brew install imagemagick
• NodeJS: brew install node
• JDK 1.7 or higher

Ruby 2.1.2 via RVM

• Follow RVM install instructions to install RVM

• You need Apple GCC to compile Ruby, otherwise you'll face many weird errors when doing bundle install.

    brew tap homebrew/dupes
    brew install apple-gcc42
  

• Install Ruby 2.1.2 by running the following command. The last --patch railsexpress will speed up Ruby a lot, but it is optional. You can safely omit the railsexpress patch if its not working in your machine.

    CC=/usr/local/bin/gcc-4.2 rvm install 2.1.2 --with-gcc=gcc-4.2 --patch railsexpress
    (OR)
    CC=/usr/local/bin/gcc-4.2 rvm install 2.1.2 --with-gcc=gcc-4.2
  

• Clone the RapidFTR codebase:

    git clone git://github.com/rapidftr/RapidFTR.git
    (or clone your fork)
    cd RapidFTR
  

• Run: rvm --create use .

• Run: bundle install

• Follow Running Tests and Default Seed Data