diff --git a/README.md b/README.md
index 456f07d..e06cc0c 100644
--- a/README.md
+++ b/README.md
@@ -210,3 +210,29 @@ Made with ❤️ for the open-source community · GSSoC 2026
 **[⭐ Star this repo](https://github.com/sunilkumar2170/Auto-Fill-Tool)** if you find it useful — it helps more contributors discover the project.
 
 </div>
+
+## Troubleshooting
+
+### Installation fails
+- Ensure you are using the supported Node.js version.
+- Run `npm install` or `npm ci`.
+- Delete `node_modules` and reinstall dependencies if necessary.
+
+### Environment variables not loading
+- Verify that a `.env` file exists.
+- Ensure all required variables are defined.
+- Restart the development server after making changes.
+
+## FAQ
+
+### How do I start the project?
+Run:
+
+```bash
+npm install
+npm run dev
+```
+
+### How do I report a bug?
+Please open a GitHub issue with reproduction steps and relevant logs.
+