feat(mobile): let the workspace list scroll under a transparent header

Merged
SA
2mo ago
+4-0

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: true is set in HomeScreen's own Stack.Screen options. The list already uses contentInsetAdjustmentBehavior="automatic", so its resting position is unchanged.
  • The offline branch is a plain View, which gets no automatic inset, so it takes paddingTop: 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-blur overlay, 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 check on the changed file
  • bunx tsc --noEmit in apps/mobile: no errors in changed files (only the known local-only errors in workspace-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.