I lowkey forgot to commit

docs/08-troubleshooting.md

@@ -0,0 +1,19 @@
+# Troubleshooting
+
+## Cannot find template or routes
+- Clear cache: `docker compose exec php php bin/console cache:clear`
+- List routes: `docker compose exec php php bin/console debug:router`
+
+## Missing vendors
+- Install: `docker compose exec php composer install --no-interaction --prefer-dist`
+
+## .env not read in container
+- Ensure we mount `.env` or set env vars in compose; we mount `.env` in `docker-compose.yml`.
+
+## Login modal shows blank
+- Make sure Bootstrap JS loads before the modal script (handled in `base.html.twig`).
+
+## Rate limits / 429
+- Client backs off using `Retry-After`. Reduce concurrent requests; increase window env vars if needed.
+
+