IntelliJ IDEA 15.0.0 Help

Gulp Tool Window

On this page:

Accessing the Gulp Tool Window

Context menu of a Gulpfile.js - Show Gulp Tasks
View | Tool Windows | Gulp - the tool window can be accessed this way only after you have opened it using the Show Gulp Tasks command or after you have run tasks through the Gulp.js run configuration.

The tool window is available only when:

  1. The Node.js framework is installed on your computer.
  2. The NodeJS repository plugin is installed and enabled.

    The plugin is not bundled with IntelliJ IDEA, but it can be installed from the JetBrains plugin repository as described in Installing, Updating and Uninstalling Repository Plugins and Enabling and Disabling Plugins. Once enabled, the plugin is available at the IDE level, that is, you can use it in all your IntelliJ IDEA projects.

  3. The gulp package is installed in the current project, see Installing Gulp for details.
  4. At least one Gulpfile.js file is available in the current project.

The tool window opens when you invoke Gulp.js by choosing Show Gulp Tasks on the context menu of a Gulpfile.js in the Project tool window or of a Gulpfile.js opened in the editor. The tree is built according to the Gulpfile.js file on which Gulp.js was invoked. If you have several Gulpfile.js files in your project, you can build a separate tasks tree for each of them and run tasks without abandoning the previously built tasks trees. Each tree is shown in a separate tab. Use the tool window to run Gulp.js tasks.

Gulp.js Tasks Tree

The tool window shows a tree of Gulp.js tasks. The tree is built according to the Gulpfile.js on which Gulp.js was invoked.

If you have several Gulpfile.js files in your project, you can build a separate tasks tree for each of them and run tasks without abandoning the previously built tasks trees. Each tree is shown under a separate node.

Running Gulp Tasks

To run a task, do one of the following:

  • Double click the required task in the tree.
  • Select the required task and choose Run <task name> on the context menu of the selection.
  • Select the required task and press Enter.
  • To run the default task, select the root node in the tree and choose Run default on the context menu of the selection.
  • To navigate to the definition of a task, select the required task in the tree and choose Jump to source on the context menu of the selection.

The task execution output will be displayed in the Run tool window.

To run several tasks, use the multiselect mode: hold Shift (for adjacent items) or Ctrl (for non-adjacent items) keys and select the required tasks, then choose Run on the context menu of the selection.

Toolbar

ItemTooltipDescription
add_black Add Gulpfile Click this button to have a tasks tree for another Gulpfile.js file built. Choose the required Gulpfile.js file from the pop-up list. IntelliJ IDEA builds a tasks tree and shows it under a separate node.
minusSign.png Remove Gulpfile Click this button to remove the tasks tree under the selected node.
icon_reload_grunt.png Reload tasks Click this button to have the tasks tree under the selected node re-built. You may need a tree re-built after updating the corresponding Gulpfile.js file because Gulp.js does not apply changes to trees on the fly.

See Also

Last modified: 22 September 2015