How to fix “Local gulp not found” error message

When trying to run Gulp on the command line, are you getting an error saying Local gulp not found?

Even if you have installed Gulp globally, you need to install Gulp locally in the individual project directory where you want to use Gulp.

You can install Gulp in your project directory by running npm install gulp on the command line. Or running npm install gulp --save-dev to save Gulp as a devDependency in your package.json file.

Why do you need to install Gulp globally and locally?

It may seem confusing to have to install Gulp both globally and locally. Why not just install it once and be done?

What we need to install globally is the Gulp CLI (command line interface). This is what lets you type in the gulp command on the command line, from any directory on your computer.

But in each local project directory, you need to install Gulp as a local package, along with your other npm packages. The local Gulp lets you run the gulpfile.js and all the Gulp tasks and functions that you configure for that project.

The reason to have both global Gulp CLI and local Gulp install is so that you can install different versions of Gulp in different projects.

The Gulp CLI was created when Gulp v4 was released, to allow developers to run both Gulp v3 and Gulp v4 as needed. Before the Gulp CLI, you would install Gulp itself globally on your computer. This meant that you could only use one version of Gulp in all projects across your computer, which isn’t very convenient.

Enjoyed this post?
Tweet me about it! 😀
Want to learn how to build a website?

I'm making a course that will teach you how to build a real-world responsive website from a Figma design!

Learn more