feat(mobile): scroll-away inline screen titles on iOS #129

Merged
joshuafhiggins merged 2 commits from t3/ios-header-title-style into main 2026-11-20 00:13:16 -05:00
Owner

iOS screens used native large titles, which collapse into a small title in the nav bar when you scroll. We want titles like Apple Music's: no large header title, the same size and weight, scrolling away with the content and staying put when you pull down.

How

  • headerLargeTitle is now false everywhere. On iOS, tab stacks hide the bar's title with inlineTitleOptions, which makes it transparent. The title is still set, so the back-button long-press menu keeps its labels.
  • The new ScreenTitle component renders a title matching the native large title's metrics (34pt bold, 52pt tall) as the first scroll item. useScreenTitleScroll tracks the scroll offset with Reanimated. The title cancels pull-down overscroll, so it stays pinned while the content stretches. On Android it renders nothing.
  • Used on Home, Library, Search, Albums, Artists, Songs, Playlists, Recently Added, Recently Played, Downloads and Other Downloaded Songs. MediaGridList and the tablet grid take a title prop. Skeletons show the same title, so nothing jumps when data loads.
  • Search results now always render their list, so the title shows before you type.

Not yet verified on device: the title spacing, and pinning on iPhone and iPad.

Made by Claude Opus 5.5 (claude-opus-5-5) in Claude Code, running in T3 Code.

🤖 Generated with Claude Code

iOS screens used native large titles, which collapse into a small title in the nav bar when you scroll. We want titles like Apple Music's: no large header title, the same size and weight, scrolling away with the content and staying put when you pull down. **How** - `headerLargeTitle` is now `false` everywhere. On iOS, tab stacks hide the bar's title with `inlineTitleOptions`, which makes it transparent. The title is still set, so the back-button long-press menu keeps its labels. - The new `ScreenTitle` component renders a title matching the native large title's metrics (34pt bold, 52pt tall) as the first scroll item. `useScreenTitleScroll` tracks the scroll offset with Reanimated. The title cancels pull-down overscroll, so it stays pinned while the content stretches. On Android it renders nothing. - Used on Home, Library, Search, Albums, Artists, Songs, Playlists, Recently Added, Recently Played, Downloads and Other Downloaded Songs. `MediaGridList` and the tablet grid take a `title` prop. Skeletons show the same title, so nothing jumps when data loads. - Search results now always render their list, so the title shows before you type. **Not yet verified on device:** the title spacing, and pinning on iPhone and iPad. Made by Claude Opus 5.5 (`claude-opus-5-5`) in Claude Code, running in T3 Code. 🤖 Generated with [Claude Code](https://claude.com/claude-code)
joshuafhiggins added 1 commit 2026-11-20 00:10:04 -05:00
joshuafhiggins added 1 commit 2026-11-20 00:12:59 -05:00
joshuafhiggins merged commit 249def86a0 into main 2026-11-20 00:13:16 -05:00
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: joshuafhiggins/otunes#129