# Common Problems & Debugging These are the real-world issues that only surface after integration. Read this before finishing any Spline implementation. --- ## 🚨 Critical Gotchas (Will Break Your Site) --- ### 1. Scroll Hijacking — Page Won't Scroll **What happens:** After adding Spline, the whole page stops scrolling. Users are stuck. **Why:** Spline's auto-generated vanilla JS exports inject `overflow: hidden` into `` CSS by default. This is baked into their generated code. **Fix:** ```css /* Add this to your CSS — overrides Spline's injection */ body { overflow: auto !important; } ``` Or in Play Settings (Spline editor → Export → Play Settings), **disable "Page Scroll"** before generating the URL. This removes the overflow rule from the output. **Also check:** If using the Runtime API and you embedded the generated `index.html` files, open them and manually remove the `overflow: hidden` line from the `