From d8a2b0f106e1941362dd26e966e19dd550f37c05 Mon Sep 17 00:00:00 2001
From: DIPIKA VAMAN KANTAPPA POOJARI <dipikabarkat@gmail.com>
Date: Sat, 8 Aug 2026 20:01:40 +0400
Subject: [PATCH] Enhance README with troubleshooting and FAQ

Added troubleshooting and FAQ sections to README.
---
 README.md | 26 ++++++++++++++++++++++++++
 1 file changed, 26 insertions(+)

diff --git a/README.md b/README.md
index cb867a0..5cb4f18 100644
--- a/README.md
+++ b/README.md
@@ -170,3 +170,29 @@ The 3D Rubik’s Cube model used in this project is a modified version of the or
   <br>
   Don't forget to ⭐ star the repo if you like this project!
 </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.
+