diff --git a/README.md b/README.md
index 4919f0a..ab3536b 100644
--- a/README.md
+++ b/README.md
@@ -199,3 +199,29 @@ This project is licensed under the MIT License - see the [LICENSE](https://githu
     width="100%" 
   />
 </p>
+
+## 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.
+