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
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