WebStorm 2020.3 Help

Opening, reopening, and closing projects

Open a project

  1. Click Open on the Welcome screen or select File | Open from the main menu.

  2. In the Select Path dialog, select the directory that contains the project to open.

  3. Specify whether you want to open the project in a new window, or close the current project and reuse the existing window.

    See Opening multiple projects for details.

Open a project from the command line

  • In the command prompt, type:

    webstorm <path_to_the_project_folder>

Reopening recent projects

When WebStorm starts, the most recent project reopens by default (unless this option is disabled on the System Settings page of the Settings/Preferences dialog Ctrl+Alt+S.

  • Call File | Open Recent from the main menu and select the desired project from the list.

    Specify whether you want to open the project in a new window or reuse the current window.

  • On the Welcome screen, click Projects n the left-hand pane and then select the project of interest in the right-hand pane where the list of your recent projects is shown. Start typing in the Search projects field to filter the list of recent projects.

Reopen a project with Run Anything

  • Press Ctrl twice or click the Run Anything button on the Navigation bar and type open in the search field of the Run Anything popup that opens. Then select the required project from the list, and press Enter.

    Run Anything: Opening a recent project
  • Run Anything is also a quick way to launch applications and to run npm or yarn scripts, learn more from Running applications and Running npm and yarn scripts.

    To see all available commands, type ?.

Remove a project from the list of recent projects

  • Click Open Recent on the File menu, then click Manage Projects at the very bottom of the recent project list.

  • Click the closing icon for the project to remove. The selected project will be removed from the list of the recent project in the Project window and on the Welcome screen.

To remove a project only from the list on the Welcome Screen, right-click the target project and select Remove Selected from Welcome Screen.

Closing projects

When you have only one open project and you close it, WebStorm displays the Welcome screen. In case of multiple projects, each one is closed with its window.

  • From the main menu, select File | Close Project.

Opening multiple projects

WebStorm suggests the following options to work with several projects simultaneously:

  • Each project is opened in its own window. The projects are independent and cannot share information, except for the Clipboard operations. All the projects run in the same instance of WebStorm and use the same memory space.

  • A newly opened project shares the window with the already opened project, which is considered the main project and is always shown first in the Project tool window. All the newly opened projects are attached to this main project.

  1. Select File | Open from the main menu and then in the Select Path dialog, select the directory that contains the project to open.

  2. By default, WebStorm displays a dialog prompting you to select whether you want to open the project in a new window (New Window ), reuse the existing window (This Window ), or add the new project to the currently opened one (Attach ).

    Opening multiple projects: confirmation dialog

    You can change or restore this behavior on the System Settings page of the Settings dialog as described in Change the project opening policy below.

Change the project opening policy

  1. In the Settings/Preferences dialog Ctrl+Alt+S, go to Appearance and Behavior | System Settings.

  2. In the Project opening area, specify the default location for your projects in the Default directory field. WebStorm will start with this folder when you open projects. This default location will be also suggested every time you create a new project.

  3. Select the project opening policy:

    • Confirm window to open project in: This option is selected by default. WebStorm displays a dialog where you can choose to open the project in a new window, reuse the existing window, or add the new project to the currently opened one.

    • Open project in new window: Select this option to silently open each new project in a new window.

      With this option selected, use File | Attach Project to add a new project to the currently opened one in the same window.

    • Open project in the same window: Select this option to silently close the project opened in the current window and open a new project in it.

      With this option selected, use File | Attach Project to add a new project in the same window without closing the currently opened project.

Detach projects from a shared window

  • In the Project tool window, select the project to detach and click Remove from Project View on its context menu.

    Detaching a project from a shared window

Some known limitations

  • Symbols from the attached projects are visible from the main one, but not vice versa.

  • WebStorm will keep using the project settings (for example code style or inspections profile) of the main project.

  • The run configuration from the attached project will be ignored and new configurations will be saved in the .idea folder of the main project.

  • If you use TypeScript, the same version will be used in all the attached projects.

  • You can’t close the main project while keeping the attached project opened.

Last modified: 08 March 2021