Skip to main content

Quick Start

If you've previously installed gulp globally, run npm rm --global gulp before following these instructions. For more information, read this Sip.

Check for node, npm, and npx

node --version

Output: v8.11.1

npm --version

Output: 5.6.0

npx --version

Output: 9.7.1

If they are not installed, follow the instructions here.

Install the gulp command line utility

npm install --global gulp-cli

Create a project directory and navigate into it

npx mkdirp my-project
cd my-project

Create a package.json file in your project directory

npm init

This will guide you through giving your project a name, version, description, etc.

Install the gulp package in your devDependencies

npm install --save-dev gulp

Verify your gulp versions

gulp --version

Ensure the output matches the screenshot below or you might need to restart the steps in this guide.

Output: CLI version 2.0.1 & Local version 4.0.0

Create a gulpfile

Using your text editor, create a file named gulpfile.js in your project root with these contents:

function defaultTask(cb) {
// place code for your default task here

exports.default = defaultTask

Test it

Run the gulp command in your project directory:


To run multiple tasks, you can use gulp <task> <othertask>.


The default task will run and do nothing. Output: Starting default & Finished default