feat(mobile): let the workspace list scroll under a transparent header
Merged
SA
2mo ago+4+4+0123456789-0-0-0123456789
Summary
- Home's header is now transparent like the app's other glass headers, so on iOS 26 the rows that scroll under it are blurred and dimmed by the system's scroll edge effect instead of being cut off hard at an opaque bar.
- The host-offline state is padded by the measured header height so its chips stay out from under the bar.
Before/after screenshots from the simulator: https://app.superset.sh/page/mobile-home-blurred-header-with-filter-chips-7i1fw7
Why / Context
Home was the only main mobile screen with an opaque header. Everything else uses headerTransparent (via glassHeaderOptions), so scrolling the workspace list looked different from the rest of the app.
How It Works
headerTransparent: trueis set inHomeScreen's ownStack.Screenoptions. The list already usescontentInsetAdjustmentBehavior="automatic", so its resting position is unchanged.- The offline branch is a plain
View, which gets no automatic inset, so it takespaddingTop: useHeaderHeight().
Design Decisions
- HomeScreen instead of the
(home)layout: the paywall and connect-host screens render on the same index route. A transparent header in the layout would shift the paywall's centered content up. Options set from inside a page aren't reset on unmount, so a plan lapsing mid-session would carry the transparent header over to the paywall. That's rare, and the paywall is still usable. - Chips stay in the list: pinning them inside the header was built and dropped. iOS has no setting to extend its header over RN views, so it needed a custom
expo-bluroverlay, a scroll-driven fade, and a LegendList workaround.
Manual QA Checklist
iPhone 17 Pro Max simulator, iOS 26.0, against production data:
- Scrolled: rows pass under the status bar and header buttons with the edge effect
- At rest: header matches the page background (sampled RGB 10,10,10); chips and first project in the same place as before
- Host offline: chips below the header, offline message unmoved (pixel diff limited to the org button's glass)
Testing
bunx biome checkon the changed filebunx tsc --noEmitinapps/mobile: no errors in changed files (only the known local-only errors inworkspace-fs/port-scanner)
Known Limitations
- On iOS 26.0 the edge effect is mostly a dim; row text under the clock is still faintly readable. I didn't compare it side by side with the other glass-header screens.
- Not checked: other phone sizes, large Dynamic Type, Cloud scope, pull to refresh.
Summary by cubic
Updates the mobile workspace list to scroll beneath Home’s transparent header instead of being cut off by an opaque bar, matching the app’s other glass headers and enabling iOS 26’s scroll edge effect. The host-offline view now uses the measured header height for top padding so its chips stay below the header.
- Applies the header option on
HomeScreen, keeping the shared route’s paywall and connect-host screens from inheriting a layout-wide transparent header. - Leaves the list’s automatic inset behavior unchanged, so its resting position does not move.
Summary by CodeRabbit
- Bug Fixes
- Improved the home screen’s offline view layout so the scope bar and offline notice appear correctly below the transparent navigation header.