From 74961fcdeef77b793c46d7315eb70f4c491b73cf Mon Sep 17 00:00:00 2001
From: Harjun751 <Harjun751@gmail.com>
Date: Fri, 27 Mar 2026 19:34:29 +0800
Subject: [PATCH 1/2] Add basic JetBrains debug configs

---
 .gitignore                        |  1 -
 .run/cli _ test.run.xml           | 15 +++++++++++++++
 .run/core _ test.run.xml          | 12 ++++++++++++
 .run/root _ build_backend.run.xml | 15 +++++++++++++++
 .run/root _ build_docs.run.xml    | 15 +++++++++++++++
 .run/root _ dev.run.xml           | 15 +++++++++++++++
 .run/root _ test.run.xml          | 12 ++++++++++++
 .run/serve -d.run.xml             |  8 ++++++++
 .run/serve.run.xml                |  8 ++++++++
 9 files changed, 100 insertions(+), 1 deletion(-)
 create mode 100644 .run/cli _ test.run.xml
 create mode 100644 .run/core _ test.run.xml
 create mode 100644 .run/root _ build_backend.run.xml
 create mode 100644 .run/root _ build_docs.run.xml
 create mode 100644 .run/root _ dev.run.xml
 create mode 100644 .run/root _ test.run.xml
 create mode 100644 .run/serve -d.run.xml
 create mode 100644 .run/serve.run.xml

diff --git a/.gitignore b/.gitignore
index d351437352..1c7fbf4703 100644
--- a/.gitignore
+++ b/.gitignore
@@ -75,7 +75,6 @@ packages/cli/test/functional/test_site_templates/test_project/expected/diagrams/
 
 # JetBrains configurations
 .idea/
-.run/
 
 # Compiled files from TypeScript
 *.js.map
diff --git a/.run/cli _ test.run.xml b/.run/cli _ test.run.xml
new file mode 100644
index 0000000000..709d6fa964
--- /dev/null
+++ b/.run/cli _ test.run.xml	
@@ -0,0 +1,15 @@
+<component name="ProjectRunConfigurationManager">
+  <configuration default="false" name="cli &gt; test" type="js.build_tools.npm">
+    <package-json value="$PROJECT_DIR$/packages/cli/package.json" />
+    <command value="run" />
+    <scripts>
+      <script value="test" />
+    </scripts>
+    <node-interpreter value="project" />
+    <envs />
+    <EXTENSION ID="com.intellij.javascript.debugger.execution.StartBrowserRunConfigurationExtension">
+      <browser with-js-debugger="true" />
+    </EXTENSION>
+    <method v="2" />
+  </configuration>
+</component>
\ No newline at end of file
diff --git a/.run/core _ test.run.xml b/.run/core _ test.run.xml
new file mode 100644
index 0000000000..f7b7d90160
--- /dev/null
+++ b/.run/core _ test.run.xml	
@@ -0,0 +1,12 @@
+<component name="ProjectRunConfigurationManager">
+  <configuration default="false" name="core &gt; test" type="js.build_tools.npm" nameIsGenerated="true">
+    <package-json value="$PROJECT_DIR$/packages/core/package.json" />
+    <command value="test" />
+    <node-interpreter value="project" />
+    <envs />
+    <EXTENSION ID="com.intellij.javascript.debugger.execution.StartBrowserRunConfigurationExtension">
+      <browser with-js-debugger="true" />
+    </EXTENSION>
+    <method v="2" />
+  </configuration>
+</component>
\ No newline at end of file
diff --git a/.run/root _ build_backend.run.xml b/.run/root _ build_backend.run.xml
new file mode 100644
index 0000000000..1312992ed2
--- /dev/null
+++ b/.run/root _ build_backend.run.xml	
@@ -0,0 +1,15 @@
+<component name="ProjectRunConfigurationManager">
+  <configuration default="false" name="root &gt; build:backend" type="js.build_tools.npm">
+    <package-json value="$PROJECT_DIR$/package.json" />
+    <command value="run" />
+    <scripts>
+      <script value="build:backend" />
+    </scripts>
+    <node-interpreter value="project" />
+    <envs />
+    <EXTENSION ID="com.intellij.javascript.debugger.execution.StartBrowserRunConfigurationExtension">
+      <browser with-js-debugger="true" />
+    </EXTENSION>
+    <method v="2" />
+  </configuration>
+</component>
\ No newline at end of file
diff --git a/.run/root _ build_docs.run.xml b/.run/root _ build_docs.run.xml
new file mode 100644
index 0000000000..1b0129e464
--- /dev/null
+++ b/.run/root _ build_docs.run.xml	
@@ -0,0 +1,15 @@
+<component name="ProjectRunConfigurationManager">
+  <configuration default="false" name="root &gt; build:docs" type="js.build_tools.npm">
+    <package-json value="$PROJECT_DIR$/package.json" />
+    <command value="run" />
+    <scripts>
+      <script value="build:docs" />
+    </scripts>
+    <node-interpreter value="project" />
+    <envs />
+    <EXTENSION ID="com.intellij.javascript.debugger.execution.StartBrowserRunConfigurationExtension">
+      <browser with-js-debugger="true" />
+    </EXTENSION>
+    <method v="2" />
+  </configuration>
+</component>
\ No newline at end of file
diff --git a/.run/root _ dev.run.xml b/.run/root _ dev.run.xml
new file mode 100644
index 0000000000..541ee5f3f6
--- /dev/null
+++ b/.run/root _ dev.run.xml	
@@ -0,0 +1,15 @@
+<component name="ProjectRunConfigurationManager">
+  <configuration default="false" name="root &gt; dev" type="js.build_tools.npm">
+    <package-json value="$PROJECT_DIR$/package.json" />
+    <command value="run" />
+    <scripts>
+      <script value="dev" />
+    </scripts>
+    <node-interpreter value="project" />
+    <envs />
+    <EXTENSION ID="com.intellij.javascript.debugger.execution.StartBrowserRunConfigurationExtension">
+      <browser with-js-debugger="true" />
+    </EXTENSION>
+    <method v="2" />
+  </configuration>
+</component>
\ No newline at end of file
diff --git a/.run/root _ test.run.xml b/.run/root _ test.run.xml
new file mode 100644
index 0000000000..81ea40ab27
--- /dev/null
+++ b/.run/root _ test.run.xml	
@@ -0,0 +1,12 @@
+<component name="ProjectRunConfigurationManager">
+  <configuration default="false" name="root &gt; test" type="js.build_tools.npm">
+    <package-json value="$PROJECT_DIR$/package.json" />
+    <command value="test" />
+    <node-interpreter value="project" />
+    <envs />
+    <EXTENSION ID="com.intellij.javascript.debugger.execution.StartBrowserRunConfigurationExtension">
+      <browser with-js-debugger="true" />
+    </EXTENSION>
+    <method v="2" />
+  </configuration>
+</component>
\ No newline at end of file
diff --git a/.run/serve -d.run.xml b/.run/serve -d.run.xml
new file mode 100644
index 0000000000..af551880ff
--- /dev/null
+++ b/.run/serve -d.run.xml	
@@ -0,0 +1,8 @@
+<component name="ProjectRunConfigurationManager">
+  <configuration default="false" name="serve -d" type="NodeJSConfigurationType" application-parameters="serve -d" path-to-js-file="$PROJECT_DIR$/packages/cli/dist/index.js" working-dir="$PROJECT_DIR$/docs">
+    <EXTENSION ID="com.intellij.javascript.debugger.execution.StartBrowserRunConfigurationExtension">
+      <browser with-js-debugger="true" />
+    </EXTENSION>
+    <method v="2" />
+  </configuration>
+</component>
\ No newline at end of file
diff --git a/.run/serve.run.xml b/.run/serve.run.xml
new file mode 100644
index 0000000000..603198bced
--- /dev/null
+++ b/.run/serve.run.xml
@@ -0,0 +1,8 @@
+<component name="ProjectRunConfigurationManager">
+  <configuration default="false" name="serve" type="NodeJSConfigurationType" application-parameters="serve" path-to-js-file="$PROJECT_DIR$/packages/cli/dist/index.js" working-dir="$PROJECT_DIR$/docs">
+    <EXTENSION ID="com.intellij.javascript.debugger.execution.StartBrowserRunConfigurationExtension">
+      <browser with-js-debugger="true" />
+    </EXTENSION>
+    <method v="2" />
+  </configuration>
+</component>
\ No newline at end of file

From 0ca0466eefd9ccc0832461202f23115cb3b1fc2d Mon Sep 17 00:00:00 2001
From: Harjun751 <Harjun751@gmail.com>
Date: Fri, 27 Mar 2026 19:48:06 +0800
Subject: [PATCH 2/2] Add comment on debug configs in docs

---
 docs/devGuide/development/settingUp.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/docs/devGuide/development/settingUp.md b/docs/devGuide/development/settingUp.md
index 1696b4c129..1c4266364a 100644
--- a/docs/devGuide/development/settingUp.md
+++ b/docs/devGuide/development/settingUp.md
@@ -35,6 +35,12 @@ This page explains how to set up your development environment to start contribut
 <box type="tip" seamless>
 
 We recommend the **WebStorm IDE** or **VS Code** for working with MarkBind code.
+
+**JetBrains users:** Run configurations are included in the repository under `.run/`. After cloning, WebStorm (and other JetBrains IDEs) will pick these up automatically. The configurations cover:
+- `root | test`, `cli | test`, `core | test` — run the test suites
+- `root | build_backend`, `root | build_docs` — build targets
+- `root | dev` — starts the dev watcher
+- `serve`, `serve -d` — serves the docs site, with and without debug mode
 </box>
 
 ## Setting up the dev environment