Installation

For compiling Sass and using Nunjucks templating language we need Node.js (cross-platform runtime environment) and NPM installed on our machine. If you're not familiar with Node.js don't worry - you don't need to be a Node.js developer. Basically there are just a few commands you will use in AppUI template. You will type commands in command line interface (CLI) rather than using a GUI, but there's nothing complex.

Step 1: Install Node.js

You can download Node.js for Windows, Mac and Linux at nodejs.org. Install it.

Please refer to official Node documentation if you need more information about Node.js.
For begginers this tutorial may be helpful: An Absolute Beginner's Guide to Node.js.

Step 2: Install Gulp and required dependencies

Once you have Node.js installed, open a command prompt and navigate to your project folder, e.g.:

cd ~/projects/appui/src

The actual location of project folder will differ across systems - ensure you're in the correct directory by typing dir on Windows or ls on Mac/Linux.

Then, we must install all dependencies defined in package.json (gulp, gulp plugins and other node modules) with npm install command (add prefix sudo in Mac, if necessary), so type this:

npm install

Wait till installation will be completed - you will know it when your CLI will return your project folder.

If dependencies and plugins were installed without errors you can step forward to customizing Gulpfile.js which will help you with the customization process.