From 76a2f7dd7fa1dcc867c3e34d3f9a4cdb3320b821 Mon Sep 17 00:00:00 2001
From: KTrain <69028025+KTrain5169@users.noreply.github.com>
Date: Sat, 8 Aug 2026 03:44:30 +0000
Subject: [PATCH 1/3] chore(cli): remove .idea/.gitignore config

---
 packages/cli/src/utils/editor.ts | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/packages/cli/src/utils/editor.ts b/packages/cli/src/utils/editor.ts
index 5de892ba43..bc23d8cb99 100644
--- a/packages/cli/src/utils/editor.ts
+++ b/packages/cli/src/utils/editor.ts
@@ -130,10 +130,6 @@ const JETBRAINS_OXFMT_SETTINGS = `<?xml version="1.0" encoding="UTF-8"?>
 </project>
 `;
 
-const JETBRAINS_GITIGNORE_ADDITION = `**
-!externalDependencies.xml
-`;
-
 type EditorConfigValue = Record<string, unknown> | string;
 
 export const EDITORS = [
@@ -163,7 +159,6 @@ export const EDITORS = [
       // Placeholder; writeEditorConfig() regenerates this with the resolved package manager.
       'workspace.xml': jetbrainsWorkspaceConfig(PackageManager.pnpm),
       'OxfmtSettings.xml': JETBRAINS_OXFMT_SETTINGS,
-      '.gitignore': JETBRAINS_GITIGNORE_ADDITION,
     },
   },
 ] as const;

From bdbabdea3a42b0522242b2d5abf88c007aac867e Mon Sep 17 00:00:00 2001
From: KTrain <69028025+KTrain5169@users.noreply.github.com>
Date: Sat, 8 Aug 2026 03:44:44 +0000
Subject: [PATCH 2/3] docs: clarify .idea/.gitignore

---
 docs/guide/ide-integration.md | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/docs/guide/ide-integration.md b/docs/guide/ide-integration.md
index 4aef237b1d..07c269aeb9 100644
--- a/docs/guide/ide-integration.md
+++ b/docs/guide/ide-integration.md
@@ -151,8 +151,10 @@ You can also manually set up the IDE configuration to match your Vite+ setup:
 </project>
 ```
 
-Often, `.idea` folders are gitignored in a project, even the `externalDependencies.xml` file. Adding the `.idea/.gitignore` file with the following content will help ensure that it is present:
+Often, `.idea` folders are gitignored in a project, even the `externalDependencies.xml` file, which is used to tell your IDE what plugins should be used for the workspace.
 
-```gitignore [.idea/.gitignore]
-!externalDependencies.xml
+Please make sure to add this line to your main `.gitignore` file, to ensure that the file will be included:
+
+```gitignore [.gitignore]
+!.idea/externalDependencies.xml
 ```

From e27f58fa28724f6fa905c352bdcd567d6efa7693 Mon Sep 17 00:00:00 2001
From: KTrain <69028025+KTrain5169@users.noreply.github.com>
Date: Sat, 8 Aug 2026 03:49:24 +0000
Subject: [PATCH 3/3] chore: adjust tests

---
 packages/cli/src/utils/__tests__/editor.spec.ts | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/packages/cli/src/utils/__tests__/editor.spec.ts b/packages/cli/src/utils/__tests__/editor.spec.ts
index bf8746f06a..a3609f2349 100644
--- a/packages/cli/src/utils/__tests__/editor.spec.ts
+++ b/packages/cli/src/utils/__tests__/editor.spec.ts
@@ -665,9 +665,6 @@ describe('writeEditorConfigs', () => {
     expect(oxfmtSettingsXml).toContain(
       '<option name="preferOxfmtCodeStyleSettings" value="true" />',
     );
-
-    const gitignore = fs.readFileSync(path.join(projectRoot, '.idea', '.gitignore'), 'utf8');
-    expect(gitignore).toBe('**\n!externalDependencies.xml\n');
   });
 
   it('writes workspace.xml with the resolved package manager', async () => {
@@ -709,8 +706,5 @@ describe('writeEditorConfigs', () => {
       'utf8',
     );
     expect(oxfmtSettingsXml).toContain('<component name="OxfmtSettings">');
-
-    const gitignore = fs.readFileSync(path.join(projectRoot, '.idea', '.gitignore'), 'utf8');
-    expect(gitignore).toBe('**\n!externalDependencies.xml\n');
   });
 });