Setting up Isogenic Engine development environment on Mac Mountain Lion

Steps

1. Xcode You can install this for free through the Apple App Store. Just open App Store and search for Xcode. https://developer.apple.com/xcode/ Don’t forget to install the developer tools!

2. Terminal If you are not familiar with the Mac terminal, here is a good starting point - http://smokingapples.com/software/tutorials/mac-terminal-tips/ Launch the terminal by searching for “terminal” in spotlight or finding it in your Applications folder. You will need the terminal to complete the rest of the steps.

3. Apache, PHP, MySQL

• Follow this (http://coolestguyplanettech.com/downtown/install-and-configure-apache-mysql-php-and-phpmyadmin-osx-108-mountain-lion) guide to install and configure Apache web server, PHP and MySQL
• Mac OS X is built in Unix and it comes with the capability of quickly setting up a development environment for developing web applications such as Isogenic Engine.
• Because you’re running apache and node.js locally, you won’t need a VM or other linux server to work on multiplayer games using Isogenic’s game server.
• (I put ige and my game projects in my Sites directory since it was easier to just use the default dir that apache sets up on Mac.)

4. home brew

• Install home brew - http://mxcl.github.com/homebrew/
• Install the following formulas
  • brew install curl
  • brew install git
  • brew install imagemagick
  • brew install mongodb

5. Node.js and Modules

• You can install node with home brew but I had some issues with that version so I used the official Node installer - http://nodejs.org/
• The engine comes bundled with the node modules it needs to run.
• A useful node module that allows you to start node apps in a wrapper that will automatically restart the node server when you change js files in your project. https://github.com/remy/nodemon
  • npm install nodemon -g

6. MongoDB

• You should have been able to install mongodb with home brew. If not, you can get the installer from their website http://www.mongodb.org/downloads
• If you’re unfamiliar with mongodb, read through the tutorials. http://docs.mongodb.org/manual/tutorial/install-mongodb-on-os-x/

7. Text editor and IDEs

• You can get WebStorm for Mac. The best solution for working with Javascript and Node.js apps. http://www.jetbrains.com/webstorm/
• Alternatively, you can use something like:
  • Sublime Text 2 - http://www.sublimetext.com/2
  • Textmate - https://github.com/textmate/textmate
  • vim - http://www.vim.org/

8. Extras

• I made a bash script and alias to shortcut running games with the server. bash script: <ige.sh> nodemon /<path to your ige install directory>/ige/server/ige -g $1

• alias In order to make my terminal create the alias each time it started, I added the following line to the bottom of my .profile. (or .bashrc) file located in your home directory. If you use zsh, then put it in your .zshrc in your home directory. alias ige="sh ige.sh $1"

• Execute in terminal: ige ige/examples/107-three-startup