diff --git a/docs/index.html b/docs/index.html
index cceb9994..61aaba3a 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -379,6 +379,9 @@
       font-size: var(--ease-text-sm);
       line-height: 1.7;
       border-radius: 0;
+      max-width: 100%;
+      overflow-x: auto;
+      -webkit-overflow-scrolling: touch;
     }
 
     .docs-code-lang {
@@ -887,16 +890,8 @@ <h3 class="docs-h3">Spacing Scale</h3>
         <p class="docs-p">Based on a 4px base unit: <code>--ease-space-1</code> (4px) → <code>--ease-space-16</code>
           (64px).</p>
       </section>
-<section id="variables" class="docs-section">
-  <h2 class="docs-h2">Variables</h2>
-
-  <p class="docs-p">
-    All values are defined as CSS custom properties in <code>:root</code>.
-    Override any token to customize colors, spacing, typography, shadows,
-    animations, and component behavior across the framework.
-  </p>
-
-  <h3 class="docs-h3">CSS Custom Properties Reference</h3>
+<section id="custom-properties" class="docs-section">
+  <h2 class="docs-h2">CSS Custom Properties Reference</h2>
 
   <p class="docs-p">
     Every <code>--ease-*</code> token can be overridden globally:
@@ -1508,16 +1503,15 @@ <h3 class="docs-h3">Hover Animations</h3>
         <h3 class="docs-h3">Delay Helpers</h3>
         <div class="docs-code">
           <span class="docs-code-lang">html</span>
-          <pre><code>&lt;!-- Staggered entrance sequence --&gt;
-
+          <pre><code>&lt;!-- Staggered entrance sequence --&gt;</code></pre>
             </div>
           </section>
 
           <hr class="docs-divider" />
 
           <!-- ══════════════ ANIMATIONS ══════════════ -->
-          <section id="animations" class="docs-section">
-            <h2 class="docs-h2">Animations</h2>
+          <section id="animations-reference" class="docs-section">
+            <h2 class="docs-h2">Animations Reference</h2>
             <p class="docs-p">Add any entrance class to trigger the animation on page load. Combine with delay classes
               for staggered sequences.</p>