diff --git a/README.md b/README.md
index cb0a809..89878ed 100644
--- a/README.md
+++ b/README.md
@@ -364,3 +364,29 @@ Run the Jest test suite to validate login, refresh, and logout flows:
 
 ```bash
 npm test
+
+## 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.
+