Academy of Natural Sciences

System Requirements

• Node LTS v12.x or above download
• NPM v6.12.0 or above

Global NPM Packages

• Gulp CLI npm install -g gulp-cli
• Browsersync npm install -g browser-sync

Installation

Open a terminal window and go to the project root. Run:

$ npm install

This should install all neccessary packages to get you up and running.

Starting Local Development

In terminal, go to the root of the project and run:

gulp fractal

This will:

• fire up fractal
• start a browsersync instance
• watch for js/scss/twig changes (and livereload/inject as needed)

Static Build

To create a static build of fractal, go to the root of the project in terminal and run:

gulp build

IMPORTANT NOTE: This will delete the contents of assets/dist/css and assets/dist/js, then run scss, js, and image tasks in production mode, which will minify all files. As such, place files that should not be deleted in the outside of those directories, i.e. assets/dist/vendor, etc.