Skip to content

An open source design system that's fully customizable and agent ready

TypeScript

fix(docsite): restore pull-to-refresh on mobile, scope the overscroll suppression to desktop (#5415)

Ojas Mutrejaf2eec711572b
diff --git a/apps/docsite/src/app/(site)/_landing/hero/HeroThemeReel.tsx b/apps/docsite/src/app/(site)/_landing/hero/HeroThemeReel.tsx
index 92383e32ae..0390215cbc 100644
--- a/apps/docsite/src/app/(site)/_landing/hero/HeroThemeReel.tsx
+++ b/apps/docsite/src/app/(site)/_landing/hero/HeroThemeReel.tsx
@@ -172,8 +172,23 @@ const styles = stylex.create({
// and cards stay aligned. Capped to 100vw to avoid horizontal scroll. Blob
// centers sit under the card clusters; colors come from --aurora-* per slide.
backdropGlow: {
- position: 'fixed',
- top: 'var(--appshell-header-height, 0px)',
+ // Desktop: fixed, part of the pin-and-cover effect alongside heroContent
+ // and the cards stage. Narrow: absolute within heroScope (position:
+ // relative), so it scrolls away with the hero instead of staying pinned
+ // for the whole page — a fixed glow below 1024px reached past the
+ // footer into the bottom-overscroll gap, which blocked pull-to-refresh
+ // from ever registering a release (#5392).
+ position: {
+ default: 'absolute',
+ '@media (min-width: 1024px)': 'fixed',
+ },
+ // heroScope already starts below the header (it's the sibling after
+ // navBackdrop in document flow), so the absolute case needs no offset;
+ // only the fixed case has to clear the header itself.
+ top: {
+ default: 0,
+ '@media (min-width: 1024px)': 'var(--appshell-header-height, 0px)',
+ },
left: '50%',
transform: 'translateX(-50%)',
width: 'min(1200px, 100vw)',
diff --git a/apps/docsite/src/app/globals.css b/apps/docsite/src/app/globals.css
index eaa6545e15..ce55a055e9 100644
--- a/apps/docsite/src/app/globals.css
+++ b/apps/docsite/src/app/globals.css
@@ -12,10 +12,16 @@
reset, astryx-base, astryx-theme so product styles always win. */
@stylex;
-/* Disable overscroll bounce so the home hero's position:fixed layers can't
- show through past the top/bottom of the page. */
-html {
- overscroll-behavior-y: none;
+/* Disable overscroll bounce so the home hero's still-fixed (>=1024px) layers
+ can't show through past the top/bottom of the page. Below 1024px the hero
+ no longer pins anything past the fold (see HeroThemeReel's backdropGlow),
+ so this rule only needs to apply at desktop widths — leaving it unscoped
+ also silently disabled pull-to-refresh on every route, everywhere on
+ mobile, which is not what it was written for (#5392). */
+@media (min-width: 1024px) {
+ html {
+ overscroll-behavior-y: none;
+ }
}
/* Marketing-only custom properties for the docsite home page. These are