From 23b42de17a6d8b1545699c2e3f95d6ad60ff532f Mon Sep 17 00:00:00 2001
From: Rabia Sarfaraz <sarfarazrabi021@gmail.com>
Date: Fri, 6 Feb 2026 20:13:59 +0500
Subject: [PATCH] docs: add troubleshooting section to README

---
 README.md | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/README.md b/README.md
index b5fbb3d..6656dd4 100644
--- a/README.md
+++ b/README.md
@@ -174,3 +174,13 @@ We welcome you to submit Issues and Pull Requests!
   <img src="https://contrib.rocks/image?repo=jemishavasoya/dev-cleaner&preview=false&max=&columns=" />
 </a>
 <br /><br />
+
+## Common Issues
+
+### Permission Errors
+- If you encounter permission errors while running scripts, try running with `sudo` (Linux/macOS) or as Administrator (Windows).
+
+### Tool Not Found
+- Make sure tools like `flutter` or `brew` are installed and added to your system PATH.
+- On macOS/Linux, check PATH with `echo $PATH`.
+- On Windows, check Environment Variables in System Settings.
\ No newline at end of file