Software

Before you can begin developing your local version of Wordpress, you'll need to install some software. The list below seems like a lot, but once you install these, you won't have to do it again. You will need to the following software installed:

Dropbox

We use Dropbox to share files. Once you have Dropbox installed, you can request access to the Bridge School shared folder from Jennifer Yeh or Pony Smith.

KeePass

KeePass is the password management software that we use. You will need to install a KeePass client. All Bridge School passwords should be stored in KeePass.

Warning

Personal passwords (e.g. your individual AWS user account) should not be stored in the Bridge School KeePass. You should use a seperate KeePass database, or some other password management service).

XCode

XCode is an OSX application. It is required for Node JS to operate as intended. You can download and install XCode from the App Store on your Mac.

Note

If you update your version of OSX, you may need to launch XCode and accept the license again or Node JS will have errors

Homebrew

Homebrew is a package manager for OSX. Installing Homebrew makes installing many of the other pieces of software much simpler. Details for installation here: http://brew.sh/

Git

Git is needed to manage the Bridge School code base. The easiest way to install Git is using Homebrew. Once you have Homebrew installed, run the following command in your terminal:

brew install git

Node JS

Node JS is necessary to run the compilers for the SASS and Javascript files. The best way to install Node JS is to use a version manager like nvm or n. That will make it much easier to switch between versions of Node.

Install nvm

You can install nvm with the command below

brew install nvm

Note that to make nvm available in your terminal sessions, you'll need to add some lines to your .bashrc or .zshrc file. There will be instructions for doing this in the final lines of the terminal after you finish installing nvm with the Homebrew command above. Specifically, you'll need to add these three lines:

export NVM_DIR="$HOME/.nvm"
[ -s "/opt/homebrew/opt/nvm/nvm.sh" ] && . "/opt/homebrew/opt/nvm/nvm.sh"  # This loads nvm
[ -s "/opt/homebrew/opt/nvm/etc/bash_completion.d/nvm" ] && . "/opt/homebrew/opt/nvm/etc/bash_completion.d/nvm"  # This loads nvm bash_completion

Install NodeJS

Once you have nvm running (you may need to exit and restart your terminal), you can install the most recent version of Node with the following.

nvm install node

Depending on how quickly scripts are updated, the version of Node required may not be the most recent. The proper version of Node will be listed in the .nvmrc file in the bs-wptheme-www repository. To install and switch to the required version of node, use the command:

nvm install <version>