Skip to content
Permalink
Branch: master
Find file Copy path
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
136 lines (108 sloc) 6.32 KB

Windows

Do the following using your Command Prompt unless told otherwise.

Ruby

  1. Check whether Ruby is installed with: ruby --version
    1. If you don't see something like ruby 2.5.0p0 (2017-12-25 revision 61468), you will need to install Ruby.
    2. Once the installers have run, select Start Command Prompt with Ruby from your start menu.
    3. Verify that Ruby is now installed with: ruby --version

Node & NPM

  1. Check whether Node is installed with: node -v
    1. If you don't see something like v8.9.4, you will need to install Node and run the installer.
    2. Once the installers have run, RESTART your computer.
    3. Verify that Node is now installed with: node -v
    4. Verify that NPM is now installed with: npm -v

Git

  1. Check whether git is installed with: git --version

    1. If you don't see something like git version 2.9.2, you will need to install Git. Say yes to the defaults during the wizard installation. At the end select launch git which which should open a bash emulator app.
    2. Verify that git is now installed with: git --version
  2. Log into Github or sign up if you have not already done so.

  3. New to git?

    1. Sign up.

    2. In your bash emulator, run the following two commands to save your login information to your computer. Every time you "push" (save) code to git, these credentials will be used to identify you. (The things in caps are placeholders, please use your actual information.)

      git config --global user.email "YOUR EMAIL ADDRESS"
      git config --global user.name "YOUR GITHUB USERNAME or ACTUAL NAME"
      
    3. Run ssh-keygen -t rsa -b 4096 -C "YOUR EMAIL ADDRESS". (Hit return to any prompts until complete.)

    4. Start the SSH agent with eval "$(ssh-agent -s)". (SSH is a form of security)

    5. Add your new key to the agent: ssh-add ~/.ssh/id_rsa.

    6. Copy your the contents of ~/.ssh/id_rsa.pub to the clipboard.

    7. Login to Github in a browser. Go to Settings > SSH and GPG keys > New SSH key / Add SSH key.

    8. Fill in the form fields with a name and your copied public key and click save.

Atom

  1. If you do not already have a text editor, go to atom.io and follow installation instructions.

Command Prompt

  1. Your command prompt can be found in your start menu.

Mac

Do the following using your Terminal unless told otherwise.

Ruby

  1. Check whether Ruby is installed with: ruby --version
    1. If you don't see something like ruby 2.5.0p0 (2017-12-25 revision 61468), you will need to install Ruby.
    2. Verify that Ruby is now installed with: ruby --version

Node & NPM

  1. Check whether Node is installed with: node -v
    1. If you don't see something like v8.9.4, you will need to install Node and run the installer.
    2. Verify that Node is now installed with: node -v
    3. Verify that NPM is now installed with: npm -v

Python

If you are following the Python tutorial you can use either version 2:

  1. Check whether Python is installed with: python --version
    1. If you don't see something like Python 2.7.10, you will need to install Python with brew: brew install python.
    2. Verify that Python is now installed with: python --version
  2. Check whether pip is installed with: pip --version
    1. If you don't see something like pip 19.1 from /usr/local/lib/python2.7/site-packages/pip (python 2.7), you will need to install pip with brew: brew install pip.
    2. Verify that pip is now installed with: pip --version

Or the newer version 3:

  1. Check whether Python is installed with: python3 --version
    1. If you don't see something like Python 3.7.3, you will need to install Python with brew: brew install python3.
    2. Verify that Python is now installed with: python --version
  2. Check whether pip3 is installed with: pip3 --version
    1. If you don't see something like pip 19.0.3 from /usr/local/lib/python3.7/site-packages/pip (python 3.7), you will need to install pip with brew: brew install pip3.
    2. Verify that pip3 is now installed with: pip3 --version

Git

  1. Check whether git is installed with: git --version

    1. If you don't see something like git version 2.9.2, you will need to install Git. Say yes to the defaults during the wizard installation. At the end select launch git which which should open a bash emulator app.
    2. Verify that git is now installed with: git --version
  2. Log into Github.

  3. New to git?

    1. Sign up.

    2. In your terminal, run the following two commands to save your login information to your computer. Every time you "push" (save) code to git, these credentials will be used to identify you. (The things in caps are placeholders, please use your actual information.)

      git config --global user.email "YOUR EMAIL ADDRESS"
      git config --global user.name "YOUR GITHUB USERNAME or ACTUAL NAME"
      
    3. Run ssh-keygen -t rsa -b 4096 -C "YOUR EMAIL ADDRESS". (Hit return to any prompts until complete.)

    4. Start the SSH agent with eval "$(ssh-agent -s)". (SSH is a form of security)

    5. Add your new key to the agent: ssh-add ~/.ssh/id_rsa.

    6. Copy your public key to the clipboard:

      # either
      pbcopy < ~/.ssh/id_rsa.pub
      # or
      cat ~/.ssh/id_rsa.pub | pbcopy
      # these commands are the equivalent of looking at the file and pressing <Command-C>
      
    7. Login to Github in a browser. Go to Settings > SSH and GPG keys > New SSH key / Add SSH key.

    8. Fill in the form fields with a name and your copied public key and click save.

Atom

  1. If you do not already have a text editor, go to atom.io and follow installation instructions.

Terminal

  1. Your terminal is found in your Applications and can be opened by typing cmd+space and then typing terminal.
  2. Alternatively, you can install iTerm2, which comes with additional features.
You can’t perform that action at this time.