Installation

Note

The following dependencies should be installed on your system in order to work with this Boilerplate.

You can find most installation steps within osx-bootstrap but in short:

  1. run brew install node when using Homebrew
  2. run curl -L https://npmjs.org/install.sh | sh
  3. run npm install -g bower
  4. run npm install -g gulp

At last make sure you correctly configured your paths.

Setup

Run the following commands to install all requirements from within the root of the package:

  • npm install to install the requirements from package.json
  • bower install to install the requirements from bower.json via .bowerrc

Gulp Commands

Warning

Please mind that gulp browser starts browserSync which tries to connect to a server. A Django server can be started from within tools/server. Refer the General section for additional information.

All front-end related tasks are handled via the Gulp task runner:

  • gulp runs the gulp defaults
  • gulp browser connects to a given server (django) and runs live reload on a separate IP
  • gulp lint starts all linting services using .eslintrc.json and scss-lint.json
  • gulp preprocess optimises images within /static/img and compiles YUIDoc into static/docs
  • gulp sass to compile the stylesheets
  • gulp tests runs the test suite
  • gulp watch runs the gulp watch defaults

We also offer some standalone commands:

  • gulp bower to install the bower dependencies
  • gulp images optimises images within /static/img
  • gulp icons to create a custom icon webfont
  • gulp docs compiles YUIDoc into static/docs
  • gulp lint:javascript runs JavaScript linting
  • gulp lint:sass runs Sass linting
  • gulp tests:unit runs unit tests
  • gulp tests:integration runs integration tests
  • gulp tests:watch runs tests in debugging mode

We love code over configuration.