From 297c8c0c6d0fa2522ff73934d403fdd2b9b7ca4f Mon Sep 17 00:00:00 2001
From: Reid Barber <reid@reidbarber.com>
Date: Mon, 23 Mar 2026 10:39:34 -0500
Subject: [PATCH 1/2] docs: remove smooth behavior from SideNav autoscroll

---
 packages/dev/s2-docs/src/Nav.tsx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/dev/s2-docs/src/Nav.tsx b/packages/dev/s2-docs/src/Nav.tsx
index 59318a15c4d..3ab27f2d17f 100644
--- a/packages/dev/s2-docs/src/Nav.tsx
+++ b/packages/dev/s2-docs/src/Nav.tsx
@@ -265,7 +265,7 @@ export function SideNavLink(props) {
       return;
     }
 
-    link.scrollIntoView({block: 'start', behavior: 'smooth'});
+    link.scrollIntoView({block: 'start'});
   }, [props.isSelected]);
 
   return (

From c4ca87e1c6c150051c48c5c245df1c304bbcb7ab Mon Sep 17 00:00:00 2001
From: Reid Barber <reid@reidbarber.com>
Date: Fri, 27 Mar 2026 16:20:03 -0500
Subject: [PATCH 2/2] only scroll on mount

---
 packages/dev/s2-docs/src/Nav.tsx | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/dev/s2-docs/src/Nav.tsx b/packages/dev/s2-docs/src/Nav.tsx
index 3ab27f2d17f..b2ea6eb0b72 100644
--- a/packages/dev/s2-docs/src/Nav.tsx
+++ b/packages/dev/s2-docs/src/Nav.tsx
@@ -256,15 +256,17 @@ export function SideNavItem(props) {
 
 export function SideNavLink(props) {
   let linkRef = useRef<HTMLAnchorElement | null>(null);
+  let shouldAutoScrollOnMount = useRef(props.isSelected);
   let selected = useContext(SideNavContext);
   let {isExternal, ...linkProps} = props;
 
   useEffect(() => {
     let link = linkRef.current;
-    if (!link || !props.isSelected) {
+    if (!link || !props.isSelected || !shouldAutoScrollOnMount.current) {
       return;
     }
 
+    shouldAutoScrollOnMount.current = false;
     link.scrollIntoView({block: 'start'});
   }, [props.isSelected]);