PresentationStack

A SwiftUI library for a programmable presentation stack. Manage presenting and dismissing multiple sheets/fullScreenCover the way you use NavigationStack + NavigationPath.

Why PresentationStack?

SwiftUI’s built-in .sheet/.fullScreenCover works well for a single modal, but these cases get painful quickly:

• Programmatically present or dismiss presentation from anywhere (deep links, global routing)
• Stack presentations on top of an already presented sheet with a manageable path

PresentationStack offers a unified stack API and declarative destinations so presentation behave more like a navigation stack.

Features

• Programmable stack — present / dismiss via PresentationManager (alias PresentationPath), including dismiss-to-root, dismiss last N, and dismiss to a specific item
• Declarative destinations — presentationDestination(for:) registers sheet content by type, similar to navigationDestination
• Presentation sessions — sheetPresentation / fullScreenCoverPresentation return a PresentationSession so you can observe presentation lifecycle (.idle → .presented → .dismissed)

Requirements

• iOS 18+

Installation

Add both packages in Xcode or Package.swift:

dependencies: [
    .package(url: "https://github.com/TStrawberry/PresentationStack.git", extract: "v1.0.0"),
]

Quick start

1. Create a path and wrap the root view of the app in a PresentationStack

PresentationPath is a type alias for PresentationManager. Keep it for any further usage:

import SwiftUI
import PresentationStack

@Observable
@MainActor
final class AppRouter {
    var path = PresentationPath()
}

struct RootView: View {
  @State private var router = AppRouter()

  var body: some View {
    PresentationStack(path: router.path) {
      HomeScreen()
        .presentationDestination(for: String.self) { name in
          DetailScreen(name: name)
        }
    }
  }
}

2. Present programmatically

From any child view, call the shared path inside a Task:

Button("Open detail") {
  Task {
    await router.path.presentSheet("detail-1")
  }
}

The value passed to presentSheet must be Identifiable, and its type must be registered with presentationDestination(for:) on the root or an ancestor.

3. Track presentation lifecycle with PresentationSession

When you need to know whether a sheet is currently shown or has been dismissed (including swipe-to-dismiss), create a session first, then call present():

@State private var session: PresentationSession?

Button("Open detail") {
  Task {
    session = router.path.sheetPresentation("detail-1")
    await session?.present()
  }
}
.onChange(of: session?.status) { _, status in
  switch status {
  case .presented:
    print("Sheet is on screen")
  case .dismissed:
    print("Sheet was dismissed")
  default:
    break
  }
}

present() returns the underlying Presentation instance once the sheet is on screen. status updates to .dismissed automatically when the user swipes the sheet away or you call dismissToRoot() / dismissLast(_:).

For full-screen covers, use fullScreenCoverPresentation(_:) instead:

session = router.path.fullScreenCoverPresentation("cover-1")
await session?.present()

API	Description
sheetPresentation(_:)	Create a sheet session for an Identifiable value
fullScreenCoverPresentation(_:)	Create a full-screen cover session
PresentationSession.present()	Present and await until the session is on screen
PresentationSession.status	.idle, .presented, or .dismissed

4. Present as usual

If you want to continue using SwiftUI’s original sheet/fullScreenCover APIs, you just need to prefix the call with withPresentationStack to integrate it with the presentation stack.

var body: some View {
  SomeView()
    .withPresentationStack.fullScreenCover(item: $text) { text in
      Screen()
    }
}

5. Dismiss

// Dismiss every presentation back to the root
await router.path.dismissToRoot()

// Dismiss the top two
await router.path.dismissLast(2)

When the user swipes a sheet away, the stack updates automatically.

Demo

The Demo/ app shows:

• A TabView with a separate NavigationStack per tab
• Reading and updating @ValueEntry fields on the current screenContext
• Stack operations: presentSheet, sheetPresentation, dismissToRoot, dismissLast
• A NavigationStack inside a sheet destination, wired into the presentation stack

Open Demo/Demo.xcodeproj in Xcode and run.

The demo also demonstrates how to build a complete app framework by combining PresentationStack with techniques such as NavigationValues, and print the graph of the whole app and more. Please check out.

License

MIT