PhpStorm 2016.3 Help

Using Stylelint Code Quality Tool

PhpStorm provides facilities to run CSS-specific code quality inspections through integration with the Stylelint code verification tool. The tool registers itself as a PhpStorm code inspection: it checks CSS code for most common mistakes and discrepancies without running the application. When a tool is activated, it launches automatically on the edited CSS file. Discrepancies are highlighted and reported in pop-up information windows, a pop-up window appears when you hover the mouse pointer over a stripe in the Validation sidebar. You can also press Alt+Enter to examine errors and apply suggested quick fixes. Learn more about inspections and intention actions at Code Inspection and Intention Actions.

On this page:

Before you start

  1. Integration with PhpStorm is supported through the CSS plugin. The plugin is bundled with PhpStorm and activated by default. If the plugin is not activated, enable it on the Plugins page of the Settings / Preferences Dialog as described in Enabling and Disabling Plugins.
  2. Stylelint is run through NodeJS, therefore make sure the NodeJS framework is downloaded and installed on your computer. The framework also contains the Node Package Manager(npm) through which Stylelint is installed.
  3. Integration with NodeJS and NPM is supported through the NodeJs plugin. The plugin is not bundled with PhpStorm, but it can be installed from the JetBrains plugin repository as described in Installing, Updating and Uninstalling Repository Plugins and Enabling and Disabling Plugins.

Installing Stylelint

  1. Open the Settings / Preferences Dialog by pressing Ctrl+Alt+S or by choosing File | Settings for Windows and Linux or PhpStorm | Preferences for OS X, and click Node.js and NPM under Languages & Frameworks.
  2. On the Node.js and NPM page that opens, the Packages area shows all the Node.js-dependent packages that are currently installed on your computer, both at the global and at the project level. Click /help/img/idea/2016.3/new.png.
  3. In the Available Packages dialog box that opens, select the stylelint package and click Install Package.

    Learn more about installing tools through NPM in Installing and Removing External Software Using Node Package Manager.

Activating and configuring Stylelint

  1. Open the Settings / Preferences Dialog by pressing Ctrl+Alt+S or by choosing File | Settings for Windows and Linux or PhpStorm | Preferences for OS X. Expand the Languages&Frameworks node, and then click Stylelint under Stylesheets. The Stylelint page opens.
  2. Select the Enable check box to activate Stylelint. After that the controls in the dialog box become available.
  3. In the Node Interpreter field, specify the NodeJS installation home. Type the path to the NodeJS executable file manually, or click the browseButton.png button and select the location in the dialog box, that opens.
  4. In the Stylelint Package field, specify the location of the stylelint package installed globally or in the current project, see Using Stylelint Code Quality Tool.

See Also

Last modified: 1 December 2016