setup-instructions.md

Setup instructions

Before coming to the workshop, I recommend having the following tools installed on your computer:

• A terminal
• Git
• Node & NPM

Then please follow the Getting started instructions for Vue Enterprise Boilerplate.

Installing a Terminal

If you're on macOS or Ubuntu, then congrats! You have a suitable terminal already installed. Find the program called "Terminal" and open it up.

If you're on Windows, download Git Bash, go through the install (choose the default option at every step), then run the program.

Installing Git

• macOS

  1. Install Homebrew
  2. Install Git with brew install git in the terminal

• Windows

  1. Git is already included with Git Bash! Nothing to do here. 🤘

• Ubuntu

  1. Install Git with sudo apt-get install git in the terminal

Installing Node and NPM

• macOS

  1. In the terminal, install XCode (developer tools built by Apple) with xcode-select --install
  2. In the terminal, install Node and NPM with brew install node

• Windows

  1. Download the installer for the "current" version of Node from their downloads page
  2. Follow the instructions in the installer, without changing any options (unless you really know what you're doing)
  3. Restart your computer

• Ubuntu

  1. In the terminal, install some extra devtools with sudo apt-get install build-essential curl m4 ruby texinfo libbz2-dev libcurl4-openssl-dev libexpat-dev libncurses-dev zlib1g-dev
  2. In the terminal, install Linuxbrew (a package manager for more developers tools on Linux) with these instructions
  3. In the terminal, install Node and NPM with brew install node

Once you're done, open the terminal and confirm that Node and NPM have installed correctly with these commands:

# Should return the version of node installed (e.g. 8.8.0).
# As long as the first number is greater than or equal to 6,
# everything has gone well!
node -v

# Should return the version of npm installed (e.g. 5.6.0).
# As long as the first number is greater than or equal to 3,
# everything has gone well!
npm -v