SUMMARY:

	1. Functionality improved
	2. Access level bug fix
	3. Example app included

Author: k-arindam

Example/AwesomeNavigationExample/AwesomeNavigationExample.xcodeproj/project.pbxproj

@@ -0,0 +1,11 @@
+{
+  "colors" : [
+    {
+      "idiom" : "universal"
+    }
+  ],
+  "info" : {
+    "author" : "xcode",
+    "version" : 1
+  }
+}

Example/AwesomeNavigationExample/AwesomeNavigationExample.xcodeproj/project.xcworkspace/contents.xcworkspacedata

@@ -0,0 +1,35 @@
+{
+  "images" : [
+    {
+      "idiom" : "universal",
+      "platform" : "ios",
+      "size" : "1024x1024"
+    },
+    {
+      "appearances" : [
+        {
+          "appearance" : "luminosity",
+          "value" : "dark"
+        }
+      ],
+      "idiom" : "universal",
+      "platform" : "ios",
+      "size" : "1024x1024"
+    },
+    {
+      "appearances" : [
+        {
+          "appearance" : "luminosity",
+          "value" : "tinted"
+        }
+      ],
+      "idiom" : "universal",
+      "platform" : "ios",
+      "size" : "1024x1024"
+    }
+  ],
+  "info" : {
+    "author" : "xcode",
+    "version" : 1
+  }
+}

Example/AwesomeNavigationExample/AwesomeNavigationExample/Assets.xcassets/AccentColor.colorset/Contents.json

@@ -0,0 +1,6 @@
+{
+  "info" : {
+    "author" : "xcode",
+    "version" : 1
+  }
+}

Example/AwesomeNavigationExample/AwesomeNavigationExample/Assets.xcassets/AppIcon.appiconset/Contents.json

@@ -0,0 +1,110 @@
+//
+//  AwesomeNavigationExampleApp.swift
+//  AwesomeNavigationExample
+//
+//  Created by Arindam Karmakar on 05/06/25.
+//
+
+import SwiftUI
+import AwesomeNavigation
+
+@main
+struct AwesomeNavigationExampleApp: App {
+    var body: some Scene {
+        WindowGroup {
+            let config = ANConfig(initialRoute: AppRoute.home) { route in
+                switch route {
+                case .home:
+                    HomeView()
+                case .settings:
+                    SettingsView()
+                case .item(let id):
+                    ItemView(id: id)
+                }
+            }
+            
+            ANApplication(with: config)
+                .preferredColorScheme(.dark)
+        }
+    }
+}
+
+enum AppRoute: ANRoute {
+    case home
+    case settings
+    case item(id: String)
+}
+
+struct HomeView: View {
+    @EnvironmentObject var nav: AwesomeNavigation
+    
+    var body: some View {
+        List {
+            Section("PUSH") {
+                Button("Push Settings View") {
+                    nav.push(AppRoute.settings)
+                }
+                
+                Button("Push Home View") {
+                    nav.push(AppRoute.home)
+                }
+                
+                Button("Push Item View") {
+                    nav.push(AppRoute.item(id: UUID().uuidString))
+                }
+                
+                Button("Push Settings View Replacing Current View") {
+                    nav.pushReplacement(AppRoute.settings)
+                }
+            }
+            
+            Section("POP") {
+                Button("Pop One View") {
+                    nav.pop()
+                }
+                
+                Button("Pop All Views") {
+                    nav.popToRoot()
+                }
+            }
+        }
+        .navigationTitle("Home")
+    }
+}
+
+struct SettingsView: View {
+    @EnvironmentObject var nav: AwesomeNavigation
+    
+    var body: some View {
+        List {
+            Section("PUSH") {
+                Button("Push Home View Replacing Current View") {
+                    nav.pushReplacement(AppRoute.home)
+                }
+            }
+            
+            Section("POP") {
+                Button("Pop One View") {
+                    nav.pop()
+                }
+                
+                Button("Pop All Views") {
+                    nav.popToRoot()
+                }
+            }
+        }
+        .navigationTitle("Settings")
+    }
+}
+
+struct ItemView: View {
+    let id: String
+    
+    var body: some View {
+        VStack {
+            Text("Item ID: \(id)")
+        }
+        .padding()
+        .navigationTitle("Item")
+    }
+}

Example/AwesomeNavigationExample/AwesomeNavigationExample/Assets.xcassets/Contents.json

@@ -0,0 +1,17 @@
+//
+//  AwesomeNavigationExampleTests.swift
+//  AwesomeNavigationExampleTests
+//
+//  Created by Arindam Karmakar on 05/06/25.
+//
+
+import Testing
+@testable import AwesomeNavigationExample
+
+struct AwesomeNavigationExampleTests {
+
+    @Test func example() async throws {
+        // Write your test here and use APIs like `#expect(...)` to check expected conditions.
+    }
+
+}

Example/AwesomeNavigationExample/AwesomeNavigationExample/AwesomeNavigationExampleApp.swift

@@ -0,0 +1,41 @@
+//
+//  AwesomeNavigationExampleUITests.swift
+//  AwesomeNavigationExampleUITests
+//
+//  Created by Arindam Karmakar on 05/06/25.
+//
+
+import XCTest
+
+final class AwesomeNavigationExampleUITests: XCTestCase {
+
+    override func setUpWithError() throws {
+        // Put setup code here. This method is called before the invocation of each test method in the class.
+
+        // In UI tests it is usually best to stop immediately when a failure occurs.
+        continueAfterFailure = false
+
+        // In UI tests it’s important to set the initial state - such as interface orientation - required for your tests before they run. The setUp method is a good place to do this.
+    }
+
+    override func tearDownWithError() throws {
+        // Put teardown code here. This method is called after the invocation of each test method in the class.
+    }
+
+    @MainActor
+    func testExample() throws {
+        // UI tests must launch the application that they test.
+        let app = XCUIApplication()
+        app.launch()
+
+        // Use XCTAssert and related functions to verify your tests produce the correct results.
+    }
+
+    @MainActor
+    func testLaunchPerformance() throws {
+        // This measures how long it takes to launch your application.
+        measure(metrics: [XCTApplicationLaunchMetric()]) {
+            XCUIApplication().launch()
+        }
+    }
+}

Example/AwesomeNavigationExample/AwesomeNavigationExampleTests/AwesomeNavigationExampleTests.swift

@@ -0,0 +1,33 @@
+//
+//  AwesomeNavigationExampleUITestsLaunchTests.swift
+//  AwesomeNavigationExampleUITests
+//
+//  Created by Arindam Karmakar on 05/06/25.
+//
+
+import XCTest
+
+final class AwesomeNavigationExampleUITestsLaunchTests: XCTestCase {
+
+    override class var runsForEachTargetApplicationUIConfiguration: Bool {
+        true
+    }
+
+    override func setUpWithError() throws {
+        continueAfterFailure = false
+    }
+
+    @MainActor
+    func testLaunch() throws {
+        let app = XCUIApplication()
+        app.launch()
+
+        // Insert steps here to perform after app launch but before taking a screenshot,
+        // such as logging into a test account or navigating somewhere in the app
+
+        let attachment = XCTAttachment(screenshot: app.screenshot())
+        attachment.name = "Launch Screen"
+        attachment.lifetime = .keepAlways
+        add(attachment)
+    }
+}

Example/AwesomeNavigationExample/AwesomeNavigationExampleUITests/AwesomeNavigationExampleUITests.swift

@@ -40,8 +40,12 @@ public final class AwesomeNavigation: ObservableObject {
     /// Replaces the current route with a new one.
     /// - Parameter route: The new route to be added, conforming to `ANRoute`.
     public func pushReplacement<R>(_ route: R) -> Void where R: ANRoute {
-        self.pop(count: 1)
-        self.push(route)
+        if self.routeStack.count > 0 {
+            self.pop(count: 1)
+            self.push(route)
+        } else {
+            self.updateRoot(with: route)
+        }
     }
 
     /// Pops the topmost route from the navigation stack.