From 992d430e4c3b9d656e7f3519e554457281012e7b Mon Sep 17 00:00:00 2001
From: Rish-2006 <rishitedu5@gmail.com>
Date: Tue, 28 Jul 2026 20:54:36 +0530
Subject: [PATCH] docs: add TROUBLESHOOTING.md troubleshooting manual

---
 TROUBLESHOOTING.md | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)
 create mode 100644 TROUBLESHOOTING.md

diff --git a/TROUBLESHOOTING.md b/TROUBLESHOOTING.md
new file mode 100644
index 000000000..31823e2ef
--- /dev/null
+++ b/TROUBLESHOOTING.md
@@ -0,0 +1,21 @@
+# TermUI Troubleshooting Guide
+
+Reference index for diagnosing and fixing common local environment build issues.
+
+## 1. Node Module Version Mismatch
+* **Symptom**: Application fails to bundle with explicit missing dependency hooks.
+* **Resolution**: Wipe your active module tree and reinstall packages from scratch:
+  ```bash
+  rm -rf node_modules package-lock.json && npm install
+  ```
+
+## 2. Terminal Resizing Screen Glitches
+* **Symptom**: Interface layout blocks break when running inside small viewport sizes.
+* **Resolution**: Keep your host terminal window scale above a minimum threshold of 80x24 characters.
+
+## 3. Missing Execution Permissions
+* **Symptom**: Local shell scripts fail to run with an access denial alert.
+* **Resolution**: Explicitly grant execution rights via your local command shell:
+  ```bash
+  chmod +x ./scripts/*
+  ```