diff --git a/README.md b/README.md
index 8412aee..dbabe1b 100644
--- a/README.md
+++ b/README.md
@@ -68,3 +68,28 @@ We love contributions! Whether it's fixing a bug, adding a feature, or improving
 
 This project is licensed under the **MIT License**. Feel free to use, modify, and distribute it. See the [LICENSE](LICENSE) file for the full text.
 
+## 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.
+