diff --git a/js/fixToc.js b/js/fixToc.js
new file mode 100644
index 000000000..70e08bcf2
--- /dev/null
+++ b/js/fixToc.js
@@ -0,0 +1,64 @@
+document.addEventListener('DOMContentLoaded', () => {
+  const SCROLL_OFFSET = 70; // Adjust based on your header height
+  const TOC_SELECTOR_RIGHT = '.md-nav--right .md-nav__link'; // Right nav links (update selector as needed)
+
+  // Smooth scroll with offset
+  function scrollToHash(hash) {
+    const target = document.querySelector(hash);
+    if (!target) return;
+
+    const targetPosition =
+      target.getBoundingClientRect().top + window.pageYOffset - SCROLL_OFFSET;
+
+    window.scrollTo({
+      top: targetPosition,
+      behavior: 'auto',
+    });
+  }
+
+  // Update right TOC only (left nav will not change)
+  function updateTOC() {
+    const headings = document.querySelectorAll(
+      '.md-content__inner h1, .md-content__inner h2, .md-content__inner h3',
+    );
+    if (headings.length === 0) return;
+
+    const scrollPosition = window.scrollY + SCROLL_OFFSET + 5; // small buffer
+    let activeHeading = headings[0];
+
+    for (const heading of headings) {
+      if (heading.offsetTop <= scrollPosition) {
+        activeHeading = heading;
+      } else {
+        break;
+      }
+    }
+
+    // Right nav only
+    document.querySelectorAll(TOC_SELECTOR_RIGHT).forEach((link) => {
+      link.classList.remove('md-nav__link--active');
+      if (link.getAttribute('href') === `#${activeHeading.id}`) {
+        link.classList.add('md-nav__link--active');
+      }
+    });
+  }
+
+  // On page load, scroll to hash correctly
+  if (window.location.hash) {
+    scrollToHash(window.location.hash);
+  }
+
+  // Handle clicks on anchor links
+  document.querySelectorAll('a[href^="#"]').forEach((anchor) => {
+    anchor.addEventListener('click', function (e) {
+      e.preventDefault();
+      const hash = this.getAttribute('href');
+      history.pushState(null, null, hash);
+      scrollToHash(hash);
+      updateTOC();
+    });
+  });
+
+  // Update TOC on scroll (only right nav)
+  window.addEventListener('scroll', updateTOC);
+});