<div align="center"> <img width="128" height="128" src="./Sources/Afloat/Afloat.docc/Resources/Icon.png" alt="Afloat Icon"> <h1><b>Afloat</b></h1> <p> Contextual navigation titles that animate based on scroll position for SwiftUI. </p> </div> <p align="center"> <a href="https://swift.org"><img src="https://img.shields.io/badge/Swift-6.3+-F05138?logo=swift&logoColor=white" alt="Swift 6.3+"></a> <a href="https://developer.apple.com"><img src="https://img.shields.io/badge/iOS-26+-000000?logo=apple" alt="iOS 26+"></a> <a href="https://developer.apple.com"><img src="https://img.shields.io/badge/macOS-26+-000000?logo=apple" alt="macOS 26+"></a> <a href="https://developer.apple.com"><img src="https://img.shields.io/badge/visionOS-26+-000000?logo=apple" alt="visionOS 26+"></a> </p> <div align="center"> <img width="600" src="./Sources/Afloat/Afloat.docc/Resources/Demo.gif" alt="Preview"> </div>

Overview

Afloat provides dynamic navigation titles and subtitles that respond to scroll events in SwiftUI. Perfect for list-based interfaces where you want the navigation bar to display context about what the user is viewing.

Contextual Navigation — Titles and subtitles that change as users scroll
Native Look & Feel — Animations match iOS's default behavior
Cross-Platform — iOS, macOS, and visionOS
SwiftUI Native — Drop-in replacements for standard modifiers
Lightweight — No dependencies, small footprint

Installation

dependencies: [
    .package(url: "https://github.com/AdelaideSky/Afloat.git", from: "1.0.0")
]

Usage

import Afloat

NavigationStack {
    ScrollView {
        ForEach(sections) { section in
            SectionHeader(section)
                .navigationTitle(.contextual, section.name)
                .navigationSubtitle(.contextual, "\(section.items.count) items")
        }
    }
    .contextualNavigation(defaultTitle: "All Sections")
}

See RecipeBookExample.swift for a complete example.

Customization

Use .contextualNavigationTransition() to customize the animation between titles (e.g., .opacity, .numericText(), .interpolate). Defaults to .identity.

How It Works

Afloat uses SwiftUI's PreferenceKey system to track the position of views marked with contextual navigation modifiers. When a view scrolls past the top edge of the screen, its title and subtitle are collected and displayed in the navigation bar. The ContextualNavigationManager monitors these preference updates and determines which title should be active based on scroll position, creating smooth transitions between sections.

Documentation

Full API reference and guides are available in the DocC documentation.

Roadmap

[ ] Add support for Large navigation title
[x] More animation options (.numericText etc)
[ ] Toolbars support

License

MIT. See LICENSE for details.

Afloat

Install / Use

README