Existing .idea folder prevents IntelliJ from displaying project structure correctly

[salman-]

Problem
When cloning the allure3 repository into IntelliJ IDEA (Ultimate 2024.3.2.2), the project structure does not display correctly.

In the Project view, only package.json and a few files from the project root are visible.

Important folders such as packages/ and .github/ are missing.

In File → Project Structure → Modules, no modules are defined.

Cause
The repository contains a preconfigured .idea/ directory. IntelliJ automatically loads this configuration, but it appears to be either outdated or misconfigured, resulting in an empty project/module setup. Please find the attached screenshot. As you can see sub-directories such as packages, .github are not showing up in the view.

Workaround
Deleting the cloned .idea/ folder (and reopening the project in IntelliJ) fixes the issue — IntelliJ regenerates its own configuration and correctly detects the TypeScript project (all directories and modules become visible).

Suggested Fix
The .idea/ folder should not be committed to version control (Let's delete it). JetBrains recommends excluding it from repositories, since it contains local IDE-specific settings that often break across different IntelliJ versions.

[baev]

It is not about the .idea folder. You can check its contents at https://github.com/allure-framework/allure3/tree/main/.idea. Only the necessary components are included (config to display the project logo and correct links to issues in comments).

We use the same approach across all projects, e.g., see https://github.com/allure-framework/allure-java/tree/main/.idea.

This is a bug that began appearing in JS projects some time ago. Don't know why, sometimes, IDEA occasionally fails to create a module from the source files.

To resolve this issue, simply create a new module from existing sources (File → New → Module from Existing Sources).