D 01. Cloning and installing

Prerequisites

Please install the following:

• node.js - v. 6.x or above
• npm v. 3.x or above
  • $ npm install npm@latest -g
  • npm comes bundled with node.js, but it is an earlier version, so upgrading it is required
• gulp, hexo-cli
  • $ npm install gulp hexo-cli -g

Installing

• Clone or fork the repo
• From the project root run the following to install dependencies:
  • $ npm install
• Set up Git Flow:
  • $ git flow init
  • Chose all the defaults

Running the site locally

You can run the site locally and have it reload as you update files with either of the following commands:

• $ npm run theme
• $ npm run write

currently there is no difference in the two tasks, but later updates to the tooling will change this

GOTCHA: Disable Caching in Chrome

We cache the hell out of the site, which can be pretty annoying when working locally. We are looking into a viable fix for this, but for now you can disable the caching through Chrome's dev-tools:

• Open dev-tools
• Go to the Application tab
• Select Service Workers
• Enable Bypass for network