IntelliJ IDEA 2021.3 Help

Add frameworks (facets)

For developing framework-specific applications, IntelliJ IDEA features facets. Facets contain libraries, dependencies, and technologies, and they provide you with additional UI elements for configuring framework-specific settings.

Note that not all facets are available out of the box. To be able to use some of them, you need to install a plugin for the necessary framework first. Refer to JetBrains Plugin Repository for more information on existing plugins.

IntelliJ IDEA can identify a file or a directory that is typical for a certain framework, and add the necessary facet for you. Once the facet is detected and added, IntelliJ IDEA will inform you about the missing configuration and will suggest the necessary actions.

If a facet is not detected automatically, you can add it manually. You can add more than one facet to a module.

Manually add a facet to a module

  1. In the Project tool window Alt+1, right-click the module to which you want to add a facet, and select Add Framework Support.

    Adding a framework support
  2. Select the necessary framework from the list.

    Depending on your choice, you might be prompted to configure additional settings (for example, to configure a library).

  3. Apply the changes and close the dialog.

Adding a new facet manually

Disable framework auto-detection

By default, auto-detection is enabled for all the supported frameworks. You can disable framework auto-detection completely, or exclude individual frameworks from auto-detection.

  1. From the main menu, select File | Project Structure the Project Structure button (Ctrl+Alt+Shift+S) and select Facets.

  2. Select Detection and click the Add button Alt+Insert.

  3. From the Framework to Exclude list, select the necessary option.

    You can disable auto-detection of a specific framework only in one directory or in the whole project. The list also allows you to disable auto-detection of all frameworks in a specific directory.

  4. If you want to disable auto-detection of all frameworks in the whole project, deselect the Enable framework detection checkbox.

    To re-enable auto-detection everywhere, select the Enable framework detection checkbox and remove all entries from the Exclude from detection list.

Excluding a framework from auto-detection
Last modified: 01 August 2022