From 53f0404a319248ac591530a076f13f1e6cb02c47 Mon Sep 17 00:00:00 2001
From: Jake Taylor <147415933+jrtaylorJH@users.noreply.github.com>
Date: Tue, 16 Jan 2024 15:44:40 -0600
Subject: [PATCH] Update debugging.md to include debugging information for
 webstorm

Signed-off-by: Jake Taylor <147415933+jrtaylorJH@users.noreply.github.com>
---
 docs/local-dev/debugging.md | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/docs/local-dev/debugging.md b/docs/local-dev/debugging.md
index 17a98b1c1c..3de09b0108 100644
--- a/docs/local-dev/debugging.md
+++ b/docs/local-dev/debugging.md
@@ -71,3 +71,20 @@ In your `launch.json`, add a new entry with the following,
     "console": "integratedTerminal"
 },
 ```
+
+### WebStorm
+
+This section describes the process for enabling run configurations for Backstage in WebStorm.
+Run configurations enable the use of debugging functionality such as steppers and breakpoints.
+
+1. Select `Edit Configurations` in the `Run` dropdown menu. Click the plus sign to add a new
+   configuration, then select `Node.js`.
+3. In `Working directory`, input `{PROJECT_DIR}/packages/backend`.
+   Replace `{PROJECT_DIR}` with the path to your Backstage repo.
+4. In `JavaScript file`, input `{PROJECT_DIR}/node_modules/@backstage/cli/bin/backstage-cli`.
+   Replace `{PROJECT_DIR}` with the path to your Backstage repo.
+5. In `Application parameters`, input `package start`.
+6. Optionally, for `Environment Variables`, input `LOG_LEVEL=debug`.
+7. Click `Apply` to save the changes.
+8. With the newly-created configuration selected, use the `Run` or `Debug` icons on the
+   toolbar to execute the newly created configuration.