ScreenNavigatorKit

Framework that provide convenient environment for manage navigation in SwiftUI.

Pros:

🤢 No boolean flag such as @State var isActive
🤮 No enum flag such as @State var route: RouteAction? with big switch-case statement
🤡 No implicit UIKit hacks with UIViewController
💩 No singleton/shared/global presenter of application

🔩 Requirements

iOS 14.0+
Xcode 12.0+
Swift 5.3+

🧐 How does it work?!

Framework has only two state object, each of which isolates "toggle-work" of @State var isActive: Bool and @State var isPresent: Bool flags.

1. `NavigationStackController`

Like UINavigationController, it store stack state and provide stack transformation using push and pop methods:

let navigationStackController = NavigationStackController()

// Standard usage

navigationStackController.push(Text("My View"))
navigationStackController.pop()
navigationStackController.popToRoot()

// Advanced usage

enum Screen: Hashable { 
    case detail
    ...
}

navigationStackController.push(tag: Screen.detail, DetailView())
navigationStackController.pop(to: Screen.detail)

Its companion is NavigationStackView – wrapper over NavigationView that bind NavigationStackController with it:

struct ContentView: View { 
    @StateObject var navigationStackController = NavigationStackController() 

    var body: some View { 
        NavigationStackView(navigationStackController) { 
            RootView(
                showDetails: { model in 
                    navigationStackController.push(DetailView(model: model))
                },
                showSettings: { 
                    navigationStackController.push(SettingsView())
                }
            )
        }
    }
}

// Another usage with automatic initialized NavigationStackController

struct ContentView: View { 
    var body: some View { 
        NavigationStackView { controller in
            RootView(
                showDetails: { model in 
                    controller.push(DetailView(model: model))
                },
                showSettings: { 
                    controller.push(SettingsView())
                }
            )
        }
    }
}

Any pushed view has access to NavigationStackController of NavigationStackView through EnvironmentObject:

struct DetailView: View { 
    let model: Model
    @EnvironmentObject var navigationStackController: NavigationStackController

    var body: some View { 
        VStack { 
            Text(model.title)
            Button("pop to root") { 
                navigationStackController.popToRoot()
            }
        }
    }
}

💫 EXTRA FEATURE: You can tag any pushed view using any Hashable type. It allow refer to specific screen on pop:

navigationStackController.push(tag: "Screen 1", Screen1()))
navigationStackController.pop(to: "Screen 1")

2. `ModalStackController`

Like NavigationStackController, the ModalStackController control modal stack hierarchy and provide stack transformation using present and dismiss methods:

let modalStackController = ModalStackController()

// Standard usage

modalStackController.present(.sheet, Text("My View"))
modalStackController.present(.fullScreenCover, Text("Another View"))
modalStackController.dismiss()
modalStackController.dismissAll()

// Advanced usage

enum Screen: Hashable { 
    case detail
    ...
}

modalStackController.present(.sheet, tag: Screen.detail, DetailView())
modalStackController.dismiss(to: Screen.detail)

🚧 NOTE: SwiftUI does not allow to dismiss multiple views at once! Therefore, methods such as dismissAll() or dismiss(to:)/dismiss(from:) will close all views sequentially.

To attach ModalStackController to a view, you need to declare a root view on top of which all views will be presented using the method definesPresentationContext(with:):

struct ExampleApp: App { 
    @StateObject var modalStackController = ModalStackController()

    var body: some Scene { 
        WindowGroup { 
            RootView()
                .definesPresentationContext(with: modalStackController)
                // or just call .definesPresentationContext()
        }
    }
}

Any presented view has access to ModalStackController through EnvironmentObject too:

struct RootView: View { 
    @EnvironmentObject var modalStackController: ModalStackController

    var body: some View { 
        VStack { 
            Text("Home screen")
            Button("FAQ") { 
                modalStackController.present(.sheet, FAQView())
            }
            Button("Authorize") { 
                modalStackController.present(.fullScreenCover, LoginView())
            }
        }
    }
}

💫 Just like in NavigationStackController you can tag presented views when present with ModalStackController

API

NavigationStackController

push
push(tag:)
pop
pop(tag:)
popLast(_ k:)
popToRoot

ModalStackController

present(_ presentationStyle:)
present(_ presentationStyle:tag:)
dismiss
dismiss(tag:)
dismissLast(_ k:)
dismissAll
PresentationStyle
- sheet
- fullScreenCover

FAQ

Can i mix this framework with existing navigation approach in my project?

Yes, you can. The framework does not affect navigation built in other ways, such as through the standard @State var isActive: Bool flags or through UIKit hacks.
NavigationStackController and ModalStackController create local state and manage only their own state.

What about `Alert`?

Unfortunately, the framework does not support such a mechanism for working with Alert, BUT you can implement it yourself by analogy with ModalStackController.
Your project can have many different custom presentations (popup, snackbar, toast, notifications) and each of them require specific logic for handle hierarchy, depending on their implementation.
So adding new presentation methods to the framework is not planned.

📦 Installation

Swift Package Manager

Create a Package.swift file.

// swift-tools-version:5.3

import PackageDescription

let package = Package(
  name: "YOUR_PROJECT_NAME",
  dependencies: [
      .package(url: "https://github.com/Ernest0-Production/ScreenNavigatorKit.git", from: "0.0.3")
  ],
  targets: [
      .target(name: "YOUR_TARGET_NAME", dependencies: ["ScreenNavigatorKit"])
  ]
)

Credits

License

ScreenNavigatorKit is released under the MIT license. See LICENSE for details.