From a49d1e4c585ac955ed7a2141d26a95cfb39a4c4e Mon Sep 17 00:00:00 2001
From: Divyanshu Bhargava <divyanshub024@gmail.com>
Date: Sat, 9 May 2026 13:34:17 +0530
Subject: [PATCH 1/3] feat: add navigation bar and related components

- Introduced the `navigation_bar` widget to the documentation and examples.
- Added `StacNavigationBarParser` and `StacNavigationViewParser` to support the new navigation structure.
- Updated existing parsers to replace deprecated bottom navigation components with the new navigation system.
- Enhanced JSON examples for the navigation bar to improve usability and clarity.
---
 docs/docs.json                                |   1 +
 docs/widgets/navigation_bar.mdx               | 317 ++++++++++++++++++
 .../stac_gallery/assets/json/home_screen.json |  22 ++
 .../assets/json/navigation_bar_example.json   |  89 +++++
 .../stac/lib/src/framework/stac_service.dart  |   3 +
 .../stac_bottom_navigation_bar_parser.dart    |   4 +-
 .../stac_bottom_navigation_view_parser.dart   |  28 +-
 ...t_bottom_navigation_controller_parser.dart | 145 ++------
 ..._default_navigation_controller_parser.dart | 140 ++++++++
 .../stac_navigation_bar_parser.dart           |  72 ++++
 .../stac_navigation_view_parser.dart          |  36 ++
 .../stac/lib/src/parsers/widgets/widgets.dart |   9 +-
 .../stac_core/lib/foundation/foundation.dart  |   3 +-
 .../stac_navigation_destination.dart          |  74 ++++
 .../stac_navigation_destination.g.dart        |  29 ++
 .../specifications/widget_type.dart           |  18 +-
 .../stac_bottom_navigation_view.dart          |   3 +
 ..._default_bottom_navigation_controller.dart |   3 +
 .../stac_default_navigation_controller.dart   |  88 +++++
 .../stac_default_navigation_controller.g.dart |  24 ++
 .../navigation_bar/stac_navigation_bar.dart   | 161 +++++++++
 .../navigation_bar/stac_navigation_bar.g.dart |  70 ++++
 .../navigation_view/stac_navigation_view.dart |  59 ++++
 .../stac_navigation_view.g.dart               |  20 ++
 packages/stac_core/lib/widgets/widgets.dart   |  11 +-
 25 files changed, 1278 insertions(+), 151 deletions(-)
 create mode 100644 docs/widgets/navigation_bar.mdx
 create mode 100644 examples/stac_gallery/assets/json/navigation_bar_example.json
 create mode 100644 packages/stac/lib/src/parsers/widgets/stac_default_navigation_controller/stac_default_navigation_controller_parser.dart
 create mode 100644 packages/stac/lib/src/parsers/widgets/stac_navigation_bar/stac_navigation_bar_parser.dart
 create mode 100644 packages/stac/lib/src/parsers/widgets/stac_navigation_view/stac_navigation_view_parser.dart
 create mode 100644 packages/stac_core/lib/foundation/navigation/stac_navigation_destination/stac_navigation_destination.dart
 create mode 100644 packages/stac_core/lib/foundation/navigation/stac_navigation_destination/stac_navigation_destination.g.dart
 create mode 100644 packages/stac_core/lib/widgets/default_navigation_controller/stac_default_navigation_controller.dart
 create mode 100644 packages/stac_core/lib/widgets/default_navigation_controller/stac_default_navigation_controller.g.dart
 create mode 100644 packages/stac_core/lib/widgets/navigation_bar/stac_navigation_bar.dart
 create mode 100644 packages/stac_core/lib/widgets/navigation_bar/stac_navigation_bar.g.dart
 create mode 100644 packages/stac_core/lib/widgets/navigation_view/stac_navigation_view.dart
 create mode 100644 packages/stac_core/lib/widgets/navigation_view/stac_navigation_view.g.dart

diff --git a/docs/docs.json b/docs/docs.json
index db3e65ab4..0475eea04 100644
--- a/docs/docs.json
+++ b/docs/docs.json
@@ -133,6 +133,7 @@
                             "widgets/linear_progress_indicator",
                             "widgets/list_tile",
                             "widgets/listview",
+                            "widgets/navigation_bar",
                             "widgets/network_widget",
                             "widgets/outlined_button",
                             "widgets/page_view",
diff --git a/docs/widgets/navigation_bar.mdx b/docs/widgets/navigation_bar.mdx
new file mode 100644
index 000000000..5272fb428
--- /dev/null
+++ b/docs/widgets/navigation_bar.mdx
@@ -0,0 +1,317 @@
+---
+title: "NavigationBar"
+description: "Documentation for NavigationBar"
+---
+
+import { PLAYGROUND_BASE_URL } from "/snippets/playground_base.mdx";
+
+export const navigationBarPreviewJson = {
+  "type": "defaultNavigationController",
+  "length": 3,
+  "child": {
+    "type": "scaffold",
+    "appBar": {
+      "type": "appBar",
+      "title": {
+        "type": "text",
+        "data": "Navigation Bar Screen"
+      }
+    },
+    "body": {
+      "type": "navigationView",
+      "children": [
+        {
+          "type": "center",
+          "child": {
+            "type": "text",
+            "data": "Home",
+            "style": {
+              "fontSize": 24
+            }
+          }
+        },
+        {
+          "type": "center",
+          "child": {
+            "type": "text",
+            "data": "Search",
+            "style": {
+              "fontSize": 24
+            }
+          }
+        },
+        {
+          "type": "center",
+          "child": {
+            "type": "text",
+            "data": "Profile",
+            "style": {
+              "fontSize": 24
+            }
+          }
+        }
+      ]
+    },
+    "bottomNavigationBar": {
+      "type": "navigationBar",
+      "destinations": [
+        {
+          "label": "Home",
+          "icon": {
+            "type": "icon",
+            "iconType": "material",
+            "icon": "home_outlined"
+          },
+          "selectedIcon": {
+            "type": "icon",
+            "iconType": "material",
+            "icon": "home"
+          }
+        },
+        {
+          "label": "Search",
+          "icon": {
+            "type": "icon",
+            "iconType": "material",
+            "icon": "search"
+          }
+        },
+        {
+          "label": "Profile",
+          "icon": {
+            "type": "icon",
+            "iconType": "material",
+            "icon": "account_circle_outlined"
+          },
+          "selectedIcon": {
+            "type": "icon",
+            "iconType": "material",
+            "icon": "account_circle"
+          }
+        }
+      ]
+    }
+  }
+};
+export const navigationBarPreviewSrc = `${PLAYGROUND_BASE_URL}/embed`;
+
+The Stac NavigationBar lets you build a Material 3 Flutter NavigationBar widget using JSON. It can be placed in the `bottomNavigationBar` slot of a `StacScaffold` and pairs with a `StacDefaultNavigationController` (with a `StacNavigationView` body) to drive selection state.
+
+To know more about the NavigationBar widget in Flutter, refer to the [official documentation](https://api.flutter.dev/flutter/material/NavigationBar-class.html).
+
+## Properties
+
+| Property                  | Type                                          | Description                                                                              |
+|---------------------------|-----------------------------------------------|------------------------------------------------------------------------------------------|
+| destinations              | `List<StacNavigationDestination>`             | The destinations shown in the navigation bar.                                            |
+| animationDuration         | `StacDuration`                                | Transition time for each destination as it goes between selected and unselected.         |
+| selectedIndex             | `int`                                         | Initial selected index. Ignored if a `StacDefaultNavigationController` is provided.      |
+| backgroundColor           | `StacColor`                                   | The color of the navigation bar itself.                                                  |
+| elevation                 | `double`                                      | The z-coordinate at which to place this navigation bar.                                  |
+| shadowColor               | `StacColor`                                   | The color used for the drop shadow to indicate elevation.                                |
+| surfaceTintColor          | `StacColor`                                   | The color used as an overlay on `backgroundColor` to indicate elevation.                 |
+| indicatorColor            | `StacColor`                                   | The color of the selected destination's indicator.                                       |
+| indicatorShape            | `StacBorder`                                  | The shape of the selected destination's indicator.                                       |
+| height                    | `double`                                      | The height of the navigation bar.                                                        |
+| labelBehavior             | `StacNavigationDestinationLabelBehavior`      | Defines how labels are laid out and when they are displayed.                             |
+| labelTextStyle            | `StacTextStyle`                               | The text style for destination labels.                                                   |
+| labelPadding              | `StacEdgeInsets`                              | The padding around each destination's label widget.                                      |
+| maintainBottomViewPadding | `bool`                                        | Whether the underlying `SafeArea` maintains the bottom `viewPadding` instead of `padding`.|
+
+## NavigationDestination
+
+The Stac NavigationDestination represents a single destination inside a NavigationBar. To know more, refer to the [official documentation](https://api.flutter.dev/flutter/material/NavigationDestination-class.html).
+
+### Properties
+
+| Property     | Type           | Description                                                       |
+|--------------|----------------|-------------------------------------------------------------------|
+| icon         | `StacWidget`   | The icon shown when this destination is unselected.               |
+| label        | `String`       | The text label for this destination.                              |
+| selectedIcon | `StacWidget`   | The icon shown when this destination is selected.                 |
+| tooltip      | `String`       | Tooltip text shown on long press.                                 |
+| enabled      | `bool`         | Whether this destination is enabled. Defaults to `true`.          |
+
+## Example
+
+<Tabs sync={false}>
+  <Tab title="Dart">
+
+```dart
+StacDefaultNavigationController(
+  length: 3,
+  child: StacScaffold(
+    appBar: StacAppBar(
+      title: StacText(data: 'Navigation Bar Screen'),
+    ),
+    body: StacNavigationView(
+      children: [
+        StacCenter(
+          child: StacText(
+            data: 'Home',
+            style: StacTextStyle(fontSize: 24),
+          ),
+        ),
+        StacCenter(
+          child: StacText(
+            data: 'Search',
+            style: StacTextStyle(fontSize: 24),
+          ),
+        ),
+        StacCenter(
+          child: StacText(
+            data: 'Profile',
+            style: StacTextStyle(fontSize: 24),
+          ),
+        ),
+      ],
+    ),
+    bottomNavigationBar: StacNavigationBar(
+      destinations: [
+        StacNavigationDestination(
+          label: 'Home',
+          icon: StacIcon(iconType: 'material', icon: 'home_outlined'),
+          selectedIcon: StacIcon(iconType: 'material', icon: 'home'),
+        ),
+        StacNavigationDestination(
+          label: 'Search',
+          icon: StacIcon(iconType: 'material', icon: 'search'),
+        ),
+        StacNavigationDestination(
+          label: 'Profile',
+          icon: StacIcon(iconType: 'material', icon: 'account_circle_outlined'),
+          selectedIcon: StacIcon(iconType: 'material', icon: 'account_circle'),
+        ),
+      ],
+    ),
+  ),
+)
+```
+
+  </Tab>
+  <Tab title="JSON">
+
+```json
+{
+  "type": "defaultNavigationController",
+  "length": 3,
+  "child": {
+    "type": "scaffold",
+    "appBar": {
+      "type": "appBar",
+      "title": {
+        "type": "text",
+        "data": "Navigation Bar Screen"
+      }
+    },
+    "body": {
+      "type": "navigationView",
+      "children": [
+        {
+          "type": "center",
+          "child": {
+            "type": "text",
+            "data": "Home",
+            "style": {
+              "fontSize": 24
+            }
+          }
+        },
+        {
+          "type": "center",
+          "child": {
+            "type": "text",
+            "data": "Search",
+            "style": {
+              "fontSize": 24
+            }
+          }
+        },
+        {
+          "type": "center",
+          "child": {
+            "type": "text",
+            "data": "Profile",
+            "style": {
+              "fontSize": 24
+            }
+          }
+        }
+      ]
+    },
+    "bottomNavigationBar": {
+      "type": "navigationBar",
+      "destinations": [
+        {
+          "label": "Home",
+          "icon": {
+            "type": "icon",
+            "iconType": "material",
+            "icon": "home_outlined"
+          },
+          "selectedIcon": {
+            "type": "icon",
+            "iconType": "material",
+            "icon": "home"
+          }
+        },
+        {
+          "label": "Search",
+          "icon": {
+            "type": "icon",
+            "iconType": "material",
+            "icon": "search"
+          }
+        },
+        {
+          "label": "Profile",
+          "icon": {
+            "type": "icon",
+            "iconType": "material",
+            "icon": "account_circle_outlined"
+          },
+          "selectedIcon": {
+            "type": "icon",
+            "iconType": "material",
+            "icon": "account_circle"
+          }
+        }
+      ]
+    }
+  }
+}
+```
+
+  </Tab>
+  <Tab title="Preview">
+    <Frame>
+      <iframe
+        id="stac"
+        src={navigationBarPreviewSrc}
+        title="Stac Playground"
+        className="w-full rounded-xl border-0"
+        style={{ height: "640px" }}
+        loading="lazy"
+        onLoad={(event) => {
+          const iframe = event.currentTarget;
+          const targetOrigin = PLAYGROUND_BASE_URL;
+          const message = {
+            type: "stac-preview-json",
+            payload: navigationBarPreviewJson
+          };
+
+          let attempts = 0;
+          const maxAttempts = 12;
+          const interval = setInterval(() => {
+            iframe.contentWindow?.postMessage(message, targetOrigin);
+            attempts += 1;
+
+            if (attempts >= maxAttempts) {
+              clearInterval(interval);
+            }
+          }, 250);
+        }}
+      />
+    </Frame>
+  </Tab>
+</Tabs>
diff --git a/examples/stac_gallery/assets/json/home_screen.json b/examples/stac_gallery/assets/json/home_screen.json
index 3a5d1470a..f8a7aafc5 100644
--- a/examples/stac_gallery/assets/json/home_screen.json
+++ b/examples/stac_gallery/assets/json/home_screen.json
@@ -531,6 +531,28 @@
       }
     }
   },
+  {
+    "type": "listTile",
+    "leading": {
+      "type": "icon",
+      "icon": "navigation"
+    },
+    "title": {
+      "type": "text",
+      "data": "Stac Navigation Bar"
+    },
+    "subtitle": {
+      "type": "text",
+      "data": "Material 3 navigation bar with selectable destinations"
+    },
+    "onTap": {
+      "actionType": "navigate",
+      "widgetJson": {
+        "type": "exampleScreen",
+        "assetPath": "assets/json/navigation_bar_example.json"
+      }
+    }
+  },
   {
     "type": "listTile",
     "leading": {
diff --git a/examples/stac_gallery/assets/json/navigation_bar_example.json b/examples/stac_gallery/assets/json/navigation_bar_example.json
new file mode 100644
index 000000000..b0a4a3b25
--- /dev/null
+++ b/examples/stac_gallery/assets/json/navigation_bar_example.json
@@ -0,0 +1,89 @@
+{
+  "type": "defaultNavigationController",
+  "length": 3,
+  "child": {
+    "type": "scaffold",
+    "appBar": {
+      "type": "appBar",
+      "title": {
+        "type": "text",
+        "data": "Navigation Bar Screen"
+      }
+    },
+    "body": {
+      "type": "navigationView",
+      "children": [
+        {
+          "type": "center",
+          "child": {
+            "type": "text",
+            "data": "Home",
+            "style": {
+              "fontSize": 24
+            }
+          }
+        },
+        {
+          "type": "center",
+          "child": {
+            "type": "text",
+            "data": "Search",
+            "style": {
+              "fontSize": 24
+            }
+          }
+        },
+        {
+          "type": "center",
+          "child": {
+            "type": "text",
+            "data": "Profile",
+            "style": {
+              "fontSize": 24
+            }
+          }
+        }
+      ]
+    },
+    "bottomNavigationBar": {
+      "type": "navigationBar",
+      "labelBehavior": "alwaysShow",
+      "destinations": [
+        {
+          "label": "Home",
+          "icon": {
+            "type": "icon",
+            "iconType": "material",
+            "icon": "home_outlined"
+          },
+          "selectedIcon": {
+            "type": "icon",
+            "iconType": "material",
+            "icon": "home"
+          }
+        },
+        {
+          "label": "Search",
+          "icon": {
+            "type": "icon",
+            "iconType": "material",
+            "icon": "search"
+          }
+        },
+        {
+          "label": "Profile",
+          "icon": {
+            "type": "icon",
+            "iconType": "material",
+            "icon": "account_circle_outlined"
+          },
+          "selectedIcon": {
+            "type": "icon",
+            "iconType": "material",
+            "icon": "account_circle"
+          }
+        }
+      ]
+    }
+  }
+}
\ No newline at end of file
diff --git a/packages/stac/lib/src/framework/stac_service.dart b/packages/stac/lib/src/framework/stac_service.dart
index 5a1cfbd9c..b05ff8249 100644
--- a/packages/stac/lib/src/framework/stac_service.dart
+++ b/packages/stac/lib/src/framework/stac_service.dart
@@ -75,6 +75,7 @@ class StacService {
     const StacListTileParser(),
     const StacCardParser(),
     const StacBottomNavigationBarParser(),
+    const StacNavigationBarParser(),
     const StacListViewParser(),
     const StacDefaultTabControllerParser(),
     const StacSingleChildScrollViewParser(),
@@ -96,7 +97,9 @@ class StacService {
     const StacGridViewParser(),
     const StacFilledButtonParser(),
     const StacBottomNavigationViewParser(),
+    const StacNavigationViewParser(),
     const StacDefaultBottomNavigationControllerParser(),
+    const StacDefaultNavigationControllerParser(),
     const StacWrapParser(),
     const StacAutoCompleteParser(),
     const StacBadgeParser(),
diff --git a/packages/stac/lib/src/parsers/widgets/stac_bottom_navigation_bar/stac_bottom_navigation_bar_parser.dart b/packages/stac/lib/src/parsers/widgets/stac_bottom_navigation_bar/stac_bottom_navigation_bar_parser.dart
index 63b096a67..aa2b41644 100644
--- a/packages/stac/lib/src/parsers/widgets/stac_bottom_navigation_bar/stac_bottom_navigation_bar_parser.dart
+++ b/packages/stac/lib/src/parsers/widgets/stac_bottom_navigation_bar/stac_bottom_navigation_bar_parser.dart
@@ -3,7 +3,7 @@ import 'package:stac/src/parsers/core/stac_widget_parser.dart';
 import 'package:stac/src/parsers/foundation/navigation/stac_bottom_navigation_bar_landscape_layout_parser.dart';
 import 'package:stac/src/parsers/foundation/navigation/stac_bottom_navigation_bar_type_parser.dart';
 import 'package:stac/src/parsers/foundation/text/stac_text_style_parser.dart';
-import 'package:stac/src/parsers/widgets/stac_default_bottom_navigation_controller/stac_default_bottom_navigation_controller_parser.dart';
+import 'package:stac/src/parsers/widgets/stac_default_navigation_controller/stac_default_navigation_controller_parser.dart';
 import 'package:stac/src/utils/color_utils.dart';
 import 'package:stac_core/stac_core.dart';
 import 'package:stac_framework/stac_framework.dart';
@@ -32,7 +32,7 @@ class _BottomNavigationBarWidget extends StatelessWidget {
 
   @override
   Widget build(BuildContext context) {
-    final controller = BottomNavigationScope.of(context)?.controller;
+    final controller = NavigationScope.of(context)?.controller;
 
     return BottomNavigationBar(
       items: model.items
diff --git a/packages/stac/lib/src/parsers/widgets/stac_bottom_navigation_view/stac_bottom_navigation_view_parser.dart b/packages/stac/lib/src/parsers/widgets/stac_bottom_navigation_view/stac_bottom_navigation_view_parser.dart
index 47ef71634..d17ea7528 100644
--- a/packages/stac/lib/src/parsers/widgets/stac_bottom_navigation_view/stac_bottom_navigation_view_parser.dart
+++ b/packages/stac/lib/src/parsers/widgets/stac_bottom_navigation_view/stac_bottom_navigation_view_parser.dart
@@ -1,9 +1,13 @@
+// ignore_for_file: deprecated_member_use
+
 import 'package:flutter/material.dart';
-import 'package:stac/src/parsers/core/stac_widget_parser.dart';
-import 'package:stac/src/parsers/widgets/stac_default_bottom_navigation_controller/stac_default_bottom_navigation_controller_parser.dart';
+import 'package:stac/src/parsers/widgets/stac_navigation_view/stac_navigation_view_parser.dart';
 import 'package:stac_core/stac_core.dart';
 import 'package:stac_framework/stac_framework.dart';
 
+/// Parser for the deprecated `bottomNavigationView` widget type.
+/// Delegates to [StacNavigationViewParser] so it shares behavior with the
+/// new generic `navigationView`.
 class StacBottomNavigationViewParser
     extends StacParser<StacBottomNavigationView> {
   const StacBottomNavigationViewParser();
@@ -17,21 +21,9 @@ class StacBottomNavigationViewParser
 
   @override
   Widget parse(BuildContext context, StacBottomNavigationView model) {
-    return _BottomNavigationViewWidget(model: model);
-  }
-}
-
-class _BottomNavigationViewWidget extends StatelessWidget {
-  const _BottomNavigationViewWidget({required this.model});
-
-  final StacBottomNavigationView model;
-
-  @override
-  Widget build(BuildContext context) {
-    final controller = BottomNavigationScope.of(context)?.controller;
-    if (model.children.isEmpty) return const SizedBox();
-    final index = controller?.index ?? 0;
-    final safeIndex = index.clamp(0, model.children.length - 1);
-    return model.children[safeIndex].parse(context) ?? const SizedBox();
+    return const StacNavigationViewParser().parse(
+      context,
+      StacNavigationView(children: model.children),
+    );
   }
 }
diff --git a/packages/stac/lib/src/parsers/widgets/stac_default_bottom_navigation_controller/stac_default_bottom_navigation_controller_parser.dart b/packages/stac/lib/src/parsers/widgets/stac_default_bottom_navigation_controller/stac_default_bottom_navigation_controller_parser.dart
index 8e3b46830..0c7ff8979 100644
--- a/packages/stac/lib/src/parsers/widgets/stac_default_bottom_navigation_controller/stac_default_bottom_navigation_controller_parser.dart
+++ b/packages/stac/lib/src/parsers/widgets/stac_default_bottom_navigation_controller/stac_default_bottom_navigation_controller_parser.dart
@@ -1,9 +1,24 @@
+// ignore_for_file: deprecated_member_use
+
 import 'package:flutter/material.dart';
-import 'package:stac/src/parsers/core/stac_widget_parser.dart';
+import 'package:stac/src/parsers/widgets/stac_default_navigation_controller/stac_default_navigation_controller_parser.dart';
 import 'package:stac_core/stac_core.dart';
 import 'package:stac_framework/stac_framework.dart';
-import 'package:stac_logger/stac_logger.dart';
 
+/// Deprecated. Use [NavigationScope] instead.
+@Deprecated('Use NavigationScope instead. Will be removed in a future release.')
+typedef BottomNavigationScope = NavigationScope;
+
+/// Deprecated. Use [NavigationController] instead.
+@Deprecated(
+  'Use NavigationController instead. Will be removed in a future release.',
+)
+typedef BottomNavigationController = NavigationController;
+
+/// Parser for the deprecated `defaultBottomNavigationController` widget
+/// type. Delegates to [StacDefaultNavigationControllerParser] so that the
+/// new [NavigationScope] / [NavigationController] are produced and remain
+/// interoperable with non-deprecated consumers.
 class StacDefaultBottomNavigationControllerParser
     extends StacParser<StacDefaultBottomNavigationController> {
   const StacDefaultBottomNavigationControllerParser();
@@ -20,125 +35,13 @@ class StacDefaultBottomNavigationControllerParser
     BuildContext context,
     StacDefaultBottomNavigationController model,
   ) {
-    return _DefaultBottomNavigationControllerWidget(model: model);
-  }
-}
-
-class _DefaultBottomNavigationControllerWidget extends StatefulWidget {
-  const _DefaultBottomNavigationControllerWidget({required this.model});
-
-  final StacDefaultBottomNavigationController model;
-
-  @override
-  State<_DefaultBottomNavigationControllerWidget> createState() =>
-      _DefaultBottomNavigationControllerWidgetState();
-}
-
-class _DefaultBottomNavigationControllerWidgetState
-    extends State<_DefaultBottomNavigationControllerWidget> {
-  late BottomNavigationController _controller;
-
-  @override
-  void initState() {
-    super.initState();
-
-    _controller = BottomNavigationController(
-      length: widget.model.length,
-      initialIndex: widget.model.initialIndex ?? 0,
-    );
-
-    _controller.addListener(_onIndexChange);
-  }
-
-  void _onIndexChange() {
-    setState(() {});
-  }
-
-  @override
-  Widget build(BuildContext context) {
-    return BottomNavigationScope(
-      length: widget.model.length,
-      controller: _controller,
-      child: widget.model.child.parse(context) ?? const SizedBox(),
+    return const StacDefaultNavigationControllerParser().parse(
+      context,
+      StacDefaultNavigationController(
+        length: model.length,
+        initialIndex: model.initialIndex,
+        child: model.child,
+      ),
     );
   }
 }
-
-/// An inherited widget that provides bottom navigation state to descendant widgets.
-///
-/// This widget is typically created by [StacDefaultBottomNavigationController]
-/// and provides access to the [BottomNavigationController] and navigation length
-/// to child widgets like [StacBottomNavigationBar] and [StacBottomNavigationView].
-class BottomNavigationScope extends InheritedWidget {
-  /// Creates a [BottomNavigationScope] with the specified properties.
-  const BottomNavigationScope({
-    super.key,
-    required super.child,
-    required this.length,
-    required this.controller,
-  });
-
-  /// The number of bottom navigation items.
-  final int length;
-
-  /// The controller that manages the current navigation index.
-  final BottomNavigationController controller;
-
-  /// Returns the [BottomNavigationScope] from the widget tree.
-  ///
-  /// Returns null if no [BottomNavigationScope] is found in the widget tree.
-  static BottomNavigationScope? of(BuildContext context) {
-    final BottomNavigationScope? result = context
-        .dependOnInheritedWidgetOfExactType<BottomNavigationScope>();
-
-    if (result != null) {
-      return result;
-    } else {
-      Log.e(
-        "BottomNavigationScope.of() called with a context that does not contain a BottomNavigationScope.",
-      );
-      return null;
-    }
-  }
-
-  @override
-  bool updateShouldNotify(covariant InheritedWidget oldWidget) {
-    return oldWidget.child != child;
-  }
-}
-
-/// A controller that manages the state of a bottom navigation bar.
-///
-/// This controller tracks the current selected index and notifies listeners
-/// when the index changes. It is used by [BottomNavigationScope] to coordinate
-/// between [StacBottomNavigationBar] and [StacBottomNavigationView].
-class BottomNavigationController extends ChangeNotifier {
-  /// Creates a [BottomNavigationController] with the specified properties.
-  BottomNavigationController({this.initialIndex = 0, required this.length})
-    : _index = initialIndex;
-
-  /// The initial index when the controller is created.
-  final int initialIndex;
-
-  /// The number of navigation items.
-  final int length;
-
-  int _index = 0;
-
-  /// The current selected index.
-  int get index => _index;
-
-  /// Sets the current selected index.
-  set index(int value) => _changeIndex(value);
-
-  void _changeIndex(int value) {
-    assert(value >= 0 && (value < length || length == 0));
-
-    if (value == _index || length < 2) {
-      return;
-    }
-
-    _index = value;
-    notifyListeners();
-  }
-}
diff --git a/packages/stac/lib/src/parsers/widgets/stac_default_navigation_controller/stac_default_navigation_controller_parser.dart b/packages/stac/lib/src/parsers/widgets/stac_default_navigation_controller/stac_default_navigation_controller_parser.dart
new file mode 100644
index 000000000..133e4f89f
--- /dev/null
+++ b/packages/stac/lib/src/parsers/widgets/stac_default_navigation_controller/stac_default_navigation_controller_parser.dart
@@ -0,0 +1,140 @@
+import 'package:flutter/material.dart';
+import 'package:stac/src/parsers/core/stac_widget_parser.dart';
+import 'package:stac_core/stac_core.dart';
+import 'package:stac_framework/stac_framework.dart';
+import 'package:stac_logger/stac_logger.dart';
+
+class StacDefaultNavigationControllerParser
+    extends StacParser<StacDefaultNavigationController> {
+  const StacDefaultNavigationControllerParser();
+
+  @override
+  String get type => WidgetType.defaultNavigationController.name;
+
+  @override
+  StacDefaultNavigationController getModel(Map<String, dynamic> json) =>
+      StacDefaultNavigationController.fromJson(json);
+
+  @override
+  Widget parse(BuildContext context, StacDefaultNavigationController model) {
+    return _DefaultNavigationControllerWidget(model: model);
+  }
+}
+
+class _DefaultNavigationControllerWidget extends StatefulWidget {
+  const _DefaultNavigationControllerWidget({required this.model});
+
+  final StacDefaultNavigationController model;
+
+  @override
+  State<_DefaultNavigationControllerWidget> createState() =>
+      _DefaultNavigationControllerWidgetState();
+}
+
+class _DefaultNavigationControllerWidgetState
+    extends State<_DefaultNavigationControllerWidget> {
+  late NavigationController _controller;
+
+  @override
+  void initState() {
+    super.initState();
+
+    _controller = NavigationController(
+      length: widget.model.length,
+      initialIndex: widget.model.initialIndex ?? 0,
+    );
+
+    _controller.addListener(_onIndexChange);
+  }
+
+  void _onIndexChange() {
+    setState(() {});
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    return NavigationScope(
+      length: widget.model.length,
+      controller: _controller,
+      child: widget.model.child.parse(context) ?? const SizedBox(),
+    );
+  }
+}
+
+/// An inherited widget that exposes navigation state (selected index) to
+/// descendant widgets such as [StacNavigationBar], [StacBottomNavigationBar]
+/// and [StacNavigationView].
+///
+/// Typically created by [StacDefaultNavigationController].
+class NavigationScope extends InheritedWidget {
+  /// Creates a [NavigationScope] with the specified properties.
+  const NavigationScope({
+    super.key,
+    required super.child,
+    required this.length,
+    required this.controller,
+  });
+
+  /// The number of navigation destinations.
+  final int length;
+
+  /// The controller that manages the current navigation index.
+  final NavigationController controller;
+
+  /// Returns the [NavigationScope] from the widget tree, or `null` if none
+  /// is found in scope.
+  static NavigationScope? of(BuildContext context) {
+    final NavigationScope? result = context
+        .dependOnInheritedWidgetOfExactType<NavigationScope>();
+
+    if (result != null) {
+      return result;
+    } else {
+      Log.e(
+        "NavigationScope.of() called with a context that does not contain a NavigationScope.",
+      );
+      return null;
+    }
+  }
+
+  @override
+  bool updateShouldNotify(covariant InheritedWidget oldWidget) {
+    return oldWidget.child != child;
+  }
+}
+
+/// A controller that manages the state of a navigation widget.
+///
+/// Tracks the current selected index and notifies listeners when the index
+/// changes. Used by [NavigationScope] to coordinate between navigation
+/// widgets and views.
+class NavigationController extends ChangeNotifier {
+  /// Creates a [NavigationController] with the specified properties.
+  NavigationController({this.initialIndex = 0, required this.length})
+    : _index = initialIndex;
+
+  /// The initial index when the controller is created.
+  final int initialIndex;
+
+  /// The number of navigation destinations.
+  final int length;
+
+  int _index = 0;
+
+  /// The current selected index.
+  int get index => _index;
+
+  /// Sets the current selected index.
+  set index(int value) => _changeIndex(value);
+
+  void _changeIndex(int value) {
+    assert(value >= 0 && (value < length || length == 0));
+
+    if (value == _index || length < 2) {
+      return;
+    }
+
+    _index = value;
+    notifyListeners();
+  }
+}
diff --git a/packages/stac/lib/src/parsers/widgets/stac_navigation_bar/stac_navigation_bar_parser.dart b/packages/stac/lib/src/parsers/widgets/stac_navigation_bar/stac_navigation_bar_parser.dart
new file mode 100644
index 000000000..647ed0a42
--- /dev/null
+++ b/packages/stac/lib/src/parsers/widgets/stac_navigation_bar/stac_navigation_bar_parser.dart
@@ -0,0 +1,72 @@
+import 'package:flutter/material.dart';
+import 'package:stac/src/parsers/core/stac_widget_parser.dart';
+import 'package:stac/src/parsers/foundation/animation/stac_duration_parsers.dart';
+import 'package:stac/src/parsers/foundation/borders/stac_border_parser.dart';
+import 'package:stac/src/parsers/foundation/geometry/stac_edge_insets_parser.dart';
+import 'package:stac/src/parsers/foundation/navigation/stac_navigation_destination_label_behavior_parser.dart';
+import 'package:stac/src/parsers/foundation/text/stac_text_style_parser.dart';
+import 'package:stac/src/parsers/widgets/stac_default_navigation_controller/stac_default_navigation_controller_parser.dart';
+import 'package:stac/src/utils/color_utils.dart';
+import 'package:stac_core/stac_core.dart';
+import 'package:stac_framework/stac_framework.dart';
+
+class StacNavigationBarParser extends StacParser<StacNavigationBar> {
+  const StacNavigationBarParser();
+
+  @override
+  String get type => WidgetType.navigationBar.name;
+
+  @override
+  StacNavigationBar getModel(Map<String, dynamic> json) =>
+      StacNavigationBar.fromJson(json);
+
+  @override
+  Widget parse(BuildContext context, StacNavigationBar model) {
+    return _NavigationBarWidget(model: model);
+  }
+}
+
+class _NavigationBarWidget extends StatelessWidget {
+  const _NavigationBarWidget({required this.model});
+
+  final StacNavigationBar model;
+
+  @override
+  Widget build(BuildContext context) {
+    final controller = NavigationScope.of(context)?.controller;
+
+    return NavigationBar(
+      destinations: model.destinations
+          .map(
+            (destination) => NavigationDestination(
+              icon: destination.icon.parse(context) ?? const SizedBox(),
+              selectedIcon: destination.selectedIcon?.parse(context),
+              label: destination.label,
+              tooltip: destination.tooltip,
+              enabled: destination.enabled ?? true,
+            ),
+          )
+          .toList(),
+      selectedIndex: controller?.index ?? model.selectedIndex ?? 0,
+      onDestinationSelected: (index) {
+        if (controller != null) {
+          controller.index = index;
+        }
+      },
+      animationDuration: model.animationDuration?.parse,
+      backgroundColor: model.backgroundColor?.toColor(context),
+      elevation: model.elevation,
+      shadowColor: model.shadowColor?.toColor(context),
+      surfaceTintColor: model.surfaceTintColor?.toColor(context),
+      indicatorColor: model.indicatorColor?.toColor(context),
+      indicatorShape: model.indicatorShape?.parse(context),
+      height: model.height,
+      labelBehavior: model.labelBehavior?.parse,
+      labelTextStyle: model.labelTextStyle == null
+          ? null
+          : WidgetStateProperty.all(model.labelTextStyle!.parse(context)),
+      labelPadding: model.labelPadding?.parse,
+      maintainBottomViewPadding: model.maintainBottomViewPadding ?? false,
+    );
+  }
+}
diff --git a/packages/stac/lib/src/parsers/widgets/stac_navigation_view/stac_navigation_view_parser.dart b/packages/stac/lib/src/parsers/widgets/stac_navigation_view/stac_navigation_view_parser.dart
new file mode 100644
index 000000000..9332dfffc
--- /dev/null
+++ b/packages/stac/lib/src/parsers/widgets/stac_navigation_view/stac_navigation_view_parser.dart
@@ -0,0 +1,36 @@
+import 'package:flutter/material.dart';
+import 'package:stac/src/parsers/core/stac_widget_parser.dart';
+import 'package:stac/src/parsers/widgets/stac_default_navigation_controller/stac_default_navigation_controller_parser.dart';
+import 'package:stac_core/stac_core.dart';
+import 'package:stac_framework/stac_framework.dart';
+
+class StacNavigationViewParser extends StacParser<StacNavigationView> {
+  const StacNavigationViewParser();
+
+  @override
+  String get type => WidgetType.navigationView.name;
+
+  @override
+  StacNavigationView getModel(Map<String, dynamic> json) =>
+      StacNavigationView.fromJson(json);
+
+  @override
+  Widget parse(BuildContext context, StacNavigationView model) {
+    return _NavigationViewWidget(model: model);
+  }
+}
+
+class _NavigationViewWidget extends StatelessWidget {
+  const _NavigationViewWidget({required this.model});
+
+  final StacNavigationView model;
+
+  @override
+  Widget build(BuildContext context) {
+    final controller = NavigationScope.of(context)?.controller;
+    if (model.children.isEmpty) return const SizedBox();
+    final index = controller?.index ?? 0;
+    final safeIndex = index.clamp(0, model.children.length - 1);
+    return model.children[safeIndex].parse(context) ?? const SizedBox();
+  }
+}
diff --git a/packages/stac/lib/src/parsers/widgets/widgets.dart b/packages/stac/lib/src/parsers/widgets/widgets.dart
index ab44d9fc6..7fce7f5b3 100644
--- a/packages/stac/lib/src/parsers/widgets/widgets.dart
+++ b/packages/stac/lib/src/parsers/widgets/widgets.dart
@@ -21,6 +21,7 @@ export 'package:stac/src/parsers/widgets/stac_conditional/stac_conditional_parse
 export 'package:stac/src/parsers/widgets/stac_container/stac_container_parser.dart';
 export 'package:stac/src/parsers/widgets/stac_custom_scroll_view/stac_custom_scroll_view_parser.dart';
 export 'package:stac/src/parsers/widgets/stac_default_bottom_navigation_controller/stac_default_bottom_navigation_controller_parser.dart';
+export 'package:stac/src/parsers/widgets/stac_default_navigation_controller/stac_default_navigation_controller_parser.dart';
 export 'package:stac/src/parsers/widgets/stac_default_tab_controller/stac_default_tab_controller_parser.dart';
 export 'package:stac/src/parsers/widgets/stac_divider/stac_divider_parser.dart';
 export 'package:stac/src/parsers/widgets/stac_drawer/stac_drawer_parser.dart';
@@ -45,6 +46,8 @@ export 'package:stac/src/parsers/widgets/stac_limited_box/stac_limited_box_parse
 export 'package:stac/src/parsers/widgets/stac_linear_progress_indicator/stac_linear_progress_indicator_parser.dart';
 export 'package:stac/src/parsers/widgets/stac_list_tile/stac_list_tile_parser.dart';
 export 'package:stac/src/parsers/widgets/stac_list_view/stac_list_view_parser.dart';
+export 'package:stac/src/parsers/widgets/stac_navigation_bar/stac_navigation_bar_parser.dart';
+export 'package:stac/src/parsers/widgets/stac_navigation_view/stac_navigation_view_parser.dart';
 export 'package:stac/src/parsers/widgets/stac_network_widget/stac_network_widget_parser.dart';
 export 'package:stac/src/parsers/widgets/stac_opacity/stac_opacity_parser.dart';
 export 'package:stac/src/parsers/widgets/stac_outlined_button/stac_outlined_button_parser.dart';
@@ -63,14 +66,14 @@ export 'package:stac/src/parsers/widgets/stac_single_child_scroll_view/stac_sing
 export 'package:stac/src/parsers/widgets/stac_sized_box/stac_sized_box_parser.dart';
 export 'package:stac/src/parsers/widgets/stac_slider/stac_slider_parser.dart';
 export 'package:stac/src/parsers/widgets/stac_sliver_app_bar/stac_sliver_app_bar_parser.dart';
+export 'package:stac/src/parsers/widgets/stac_sliver_fill_remaining/stac_sliver_fill_remaining_parser.dart';
 export 'package:stac/src/parsers/widgets/stac_sliver_grid/stac_sliver_grid_parser.dart';
 export 'package:stac/src/parsers/widgets/stac_sliver_list/stac_sliver_list_parser.dart';
-export 'package:stac/src/parsers/widgets/stac_sliver_visibility/stac_sliver_visibility_parser.dart';
-export 'package:stac/src/parsers/widgets/stac_sliver_fill_remaining/stac_sliver_fill_remaining_parser.dart';
 export 'package:stac/src/parsers/widgets/stac_sliver_opacity/stac_sliver_opacity_parser.dart';
-export 'package:stac/src/parsers/widgets/stac_sliver_safe_area/stac_sliver_safe_area_parser.dart';
 export 'package:stac/src/parsers/widgets/stac_sliver_padding/stac_sliver_padding_parser.dart';
+export 'package:stac/src/parsers/widgets/stac_sliver_safe_area/stac_sliver_safe_area_parser.dart';
 export 'package:stac/src/parsers/widgets/stac_sliver_to_box_adapter/stac_sliver_to_box_adapter_parser.dart';
+export 'package:stac/src/parsers/widgets/stac_sliver_visibility/stac_sliver_visibility_parser.dart';
 export 'package:stac/src/parsers/widgets/stac_spacer/stac_spacer_parser.dart';
 export 'package:stac/src/parsers/widgets/stac_stack/stac_stack_parser.dart';
 export 'package:stac/src/parsers/widgets/stac_switch/stac_switch_parser.dart';
diff --git a/packages/stac_core/lib/foundation/foundation.dart b/packages/stac_core/lib/foundation/foundation.dart
index f40df37cb..599bb8a82 100644
--- a/packages/stac_core/lib/foundation/foundation.dart
+++ b/packages/stac_core/lib/foundation/foundation.dart
@@ -69,6 +69,7 @@ export 'layout/stac_wrap_cross_alignment.dart';
 export 'navigation/stac_bottom_navigation_bar_item/stac_bottom_navigation_bar_item.dart';
 export 'navigation/stac_floating_action_button_location.dart';
 export 'navigation/stac_floating_action_button_type.dart';
+export 'navigation/stac_navigation_destination/stac_navigation_destination.dart';
 export 'navigation/stac_navigation_destination_label_behavior.dart';
 export 'navigation/stac_tab_alignment.dart';
 export 'navigation/stac_tab_bar_indicator_size.dart';
@@ -105,5 +106,5 @@ export 'ui_components/stac_snack_bar_behavior.dart';
 export 'ui_components/stac_switch_type.dart';
 export 'ui_components/stac_system_ui_overlay_style/stac_system_ui_overlay_style.dart';
 export 'ui_components/stac_table_column_width/stac_table_column_width.dart';
-export 'ui_components/stac_traversal_edge_behavior.dart';
 export 'ui_components/stac_tool_tip_trigger_mode.dart';
+export 'ui_components/stac_traversal_edge_behavior.dart';
diff --git a/packages/stac_core/lib/foundation/navigation/stac_navigation_destination/stac_navigation_destination.dart b/packages/stac_core/lib/foundation/navigation/stac_navigation_destination/stac_navigation_destination.dart
new file mode 100644
index 000000000..e70594aa0
--- /dev/null
+++ b/packages/stac_core/lib/foundation/navigation/stac_navigation_destination/stac_navigation_destination.dart
@@ -0,0 +1,74 @@
+import 'package:json_annotation/json_annotation.dart';
+import 'package:stac_core/core/stac_widget.dart';
+
+part 'stac_navigation_destination.g.dart';
+
+/// A Stac model representing Flutter's [NavigationDestination].
+///
+/// Used as a child of [StacNavigationBar] to define a single
+/// destination (icon, optional selected icon, label and tooltip).
+///
+/// Dart example:
+/// ```dart
+/// StacNavigationDestination(
+///   icon: StacIcon(icon: 'home_outlined'),
+///   selectedIcon: StacIcon(icon: 'home'),
+///   label: 'Home',
+/// )
+/// ```
+///
+/// JSON example:
+/// ```json
+/// {
+///   "icon": {"type": "icon", "icon": "home_outlined"},
+///   "selectedIcon": {"type": "icon", "icon": "home"},
+///   "label": "Home"
+/// }
+/// ```
+///
+/// See also:
+///  * Flutter's NavigationDestination docs (`https://api.flutter.dev/flutter/material/NavigationDestination-class.html`)
+@JsonSerializable(explicitToJson: true)
+class StacNavigationDestination extends StacElement {
+  /// Creates a [StacNavigationDestination].
+  const StacNavigationDestination({
+    required this.icon,
+    required this.label,
+    this.selectedIcon,
+    this.tooltip,
+    this.enabled,
+  });
+
+  /// The icon shown when this destination is unselected.
+  ///
+  /// Type: [StacWidget]
+  final StacWidget icon;
+
+  /// The text label for this destination.
+  ///
+  /// Type: [String]
+  final String label;
+
+  /// The icon shown when this destination is selected.
+  ///
+  /// Type: [StacWidget]
+  final StacWidget? selectedIcon;
+
+  /// Tooltip text shown on long press.
+  ///
+  /// Type: [String]
+  final String? tooltip;
+
+  /// Whether this destination is enabled. Defaults to `true`.
+  ///
+  /// Type: [bool]
+  final bool? enabled;
+
+  /// Creates a [StacNavigationDestination] from JSON.
+  factory StacNavigationDestination.fromJson(Map<String, dynamic> json) =>
+      _$StacNavigationDestinationFromJson(json);
+
+  /// Converts this [StacNavigationDestination] to JSON.
+  @override
+  Map<String, dynamic> toJson() => _$StacNavigationDestinationToJson(this);
+}
diff --git a/packages/stac_core/lib/foundation/navigation/stac_navigation_destination/stac_navigation_destination.g.dart b/packages/stac_core/lib/foundation/navigation/stac_navigation_destination/stac_navigation_destination.g.dart
new file mode 100644
index 000000000..eab8b1ce7
--- /dev/null
+++ b/packages/stac_core/lib/foundation/navigation/stac_navigation_destination/stac_navigation_destination.g.dart
@@ -0,0 +1,29 @@
+// GENERATED CODE - DO NOT MODIFY BY HAND
+
+part of 'stac_navigation_destination.dart';
+
+// **************************************************************************
+// JsonSerializableGenerator
+// **************************************************************************
+
+StacNavigationDestination _$StacNavigationDestinationFromJson(
+  Map<String, dynamic> json,
+) => StacNavigationDestination(
+  icon: StacWidget.fromJson(json['icon'] as Map<String, dynamic>),
+  label: json['label'] as String,
+  selectedIcon: json['selectedIcon'] == null
+      ? null
+      : StacWidget.fromJson(json['selectedIcon'] as Map<String, dynamic>),
+  tooltip: json['tooltip'] as String?,
+  enabled: json['enabled'] as bool?,
+);
+
+Map<String, dynamic> _$StacNavigationDestinationToJson(
+  StacNavigationDestination instance,
+) => <String, dynamic>{
+  'icon': instance.icon.toJson(),
+  'label': instance.label,
+  'selectedIcon': instance.selectedIcon?.toJson(),
+  'tooltip': instance.tooltip,
+  'enabled': instance.enabled,
+};
diff --git a/packages/stac_core/lib/foundation/specifications/widget_type.dart b/packages/stac_core/lib/foundation/specifications/widget_type.dart
index 4688463ce..2503b3389 100644
--- a/packages/stac_core/lib/foundation/specifications/widget_type.dart
+++ b/packages/stac_core/lib/foundation/specifications/widget_type.dart
@@ -27,7 +27,7 @@ enum WidgetType {
   /// Bottom navigation bar widget
   bottomNavigationBar,
 
-  /// Bottom navigation view widget
+  /// Bottom navigation view widget.
   bottomNavigationView,
 
   /// Card widget
@@ -78,9 +78,13 @@ enum WidgetType {
   /// Custom scroll view widget
   customScrollView,
 
-  /// Default bottom navigation controller widget
+  /// Default bottom navigation controller widget.
   defaultBottomNavigationController,
 
+  /// Default navigation controller widget. Drives selection state for
+  /// any navigation widget (`bottomNavigationBar`, `navigationBar`, etc.).
+  defaultNavigationController,
+
   /// Default tab controller widget
   defaultTabController,
 
@@ -150,6 +154,16 @@ enum WidgetType {
   /// List view widget
   listView,
 
+  /// Navigation bar widget (Material 3)
+  navigationBar,
+
+  /// Navigation destination widget (Material 3 navigation bar item)
+  navigationDestination,
+
+  /// Navigation view widget. Displays one of its children based on the
+  /// current index from a `defaultNavigationController`.
+  navigationView,
+
   /// Network widget
   networkWidget,
 
diff --git a/packages/stac_core/lib/widgets/bottom_navigation_view/stac_bottom_navigation_view.dart b/packages/stac_core/lib/widgets/bottom_navigation_view/stac_bottom_navigation_view.dart
index 1b56af7ec..de86185c3 100644
--- a/packages/stac_core/lib/widgets/bottom_navigation_view/stac_bottom_navigation_view.dart
+++ b/packages/stac_core/lib/widgets/bottom_navigation_view/stac_bottom_navigation_view.dart
@@ -85,6 +85,9 @@ part 'stac_bottom_navigation_view.g.dart';
 ///
 /// See also:
 ///  * Flutter's `BottomNavigationBar` docs (`https://api.flutter.dev/flutter/material/BottomNavigationBar-class.html`)
+@Deprecated(
+  'Use StacNavigationView (type: "navigationView") instead. Will be removed in a future release.',
+)
 @JsonSerializable()
 class StacBottomNavigationView extends StacWidget {
   /// Creates a [StacBottomNavigationView].
diff --git a/packages/stac_core/lib/widgets/default_bottom_navigation_controller/stac_default_bottom_navigation_controller.dart b/packages/stac_core/lib/widgets/default_bottom_navigation_controller/stac_default_bottom_navigation_controller.dart
index 110449498..13c5e5c7b 100644
--- a/packages/stac_core/lib/widgets/default_bottom_navigation_controller/stac_default_bottom_navigation_controller.dart
+++ b/packages/stac_core/lib/widgets/default_bottom_navigation_controller/stac_default_bottom_navigation_controller.dart
@@ -96,6 +96,9 @@ part 'stac_default_bottom_navigation_controller.g.dart';
 ///
 /// See also:
 ///  * Flutter's DefaultTabController docs (https://api.flutter.dev/flutter/material/DefaultTabController-class.html)
+@Deprecated(
+  'Use StacDefaultNavigationController (type: "defaultNavigationController") instead. Will be removed in a future release.',
+)
 @JsonSerializable()
 class StacDefaultBottomNavigationController extends StacWidget {
   /// Creates a [StacDefaultBottomNavigationController] with the specified properties.
diff --git a/packages/stac_core/lib/widgets/default_navigation_controller/stac_default_navigation_controller.dart b/packages/stac_core/lib/widgets/default_navigation_controller/stac_default_navigation_controller.dart
new file mode 100644
index 000000000..f7c5a21ed
--- /dev/null
+++ b/packages/stac_core/lib/widgets/default_navigation_controller/stac_default_navigation_controller.dart
@@ -0,0 +1,88 @@
+import 'package:json_annotation/json_annotation.dart';
+import 'package:stac_core/core/stac_widget.dart';
+import 'package:stac_core/foundation/specifications/widget_type.dart';
+
+part 'stac_default_navigation_controller.g.dart';
+
+/// A Stac widget that provides a controller for managing navigation state
+/// (current selected index) and exposes a `NavigationScope` to descendants.
+///
+/// This is the generic replacement for [StacDefaultBottomNavigationController]
+/// and works with any navigation widget — `bottomNavigationBar`,
+/// `navigationBar`, etc. — combined with [StacNavigationView] for the body.
+///
+/// {@tool snippet}
+/// Dart Example:
+/// ```dart
+/// StacDefaultNavigationController(
+///   length: 3,
+///   initialIndex: 0,
+///   child: StacScaffold(
+///     appBar: StacAppBar(title: StacText('Navigation')),
+///     body: StacNavigationView(
+///       children: const [
+///         StacCenter(child: StacText('Home')),
+///         StacCenter(child: StacText('Search')),
+///         StacCenter(child: StacText('Profile')),
+///       ],
+///     ),
+///     bottomNavigationBar: StacNavigationBar(
+///       destinations: [
+///         StacNavigationDestination(icon: StacIcon(icon: 'home'), label: 'Home'),
+///         StacNavigationDestination(icon: StacIcon(icon: 'search'), label: 'Search'),
+///         StacNavigationDestination(icon: StacIcon(icon: 'account_circle'), label: 'Profile'),
+///       ],
+///     ),
+///   ),
+/// )
+/// ```
+/// {@end-tool}
+///
+/// {@tool snippet}
+/// JSON Example:
+/// ```json
+/// {
+///   "type": "defaultNavigationController",
+///   "length": 3,
+///   "initialIndex": 0,
+///   "child": { "type": "scaffold", ... }
+/// }
+/// ```
+/// {@end-tool}
+@JsonSerializable()
+class StacDefaultNavigationController extends StacWidget {
+  /// Creates a [StacDefaultNavigationController] with the specified properties.
+  const StacDefaultNavigationController({
+    required this.length,
+    this.initialIndex,
+    required this.child,
+  });
+
+  /// The number of navigation destinations.
+  ///
+  /// Type: int
+  final int length;
+
+  /// The initial index of the selected destination.
+  ///
+  /// Type: int?
+  final int? initialIndex;
+
+  /// The child widget that will be wrapped by this controller.
+  ///
+  /// Type: StacWidget
+  final StacWidget child;
+
+  /// Widget type identifier.
+  @override
+  String get type => WidgetType.defaultNavigationController.name;
+
+  /// Creates a [StacDefaultNavigationController] from JSON.
+  factory StacDefaultNavigationController.fromJson(Map<String, dynamic> json) =>
+      _$StacDefaultNavigationControllerFromJson(json);
+
+  /// Converts this widget to JSON.
+  @override
+  Map<String, dynamic> toJson() =>
+      _$StacDefaultNavigationControllerToJson(this);
+}
diff --git a/packages/stac_core/lib/widgets/default_navigation_controller/stac_default_navigation_controller.g.dart b/packages/stac_core/lib/widgets/default_navigation_controller/stac_default_navigation_controller.g.dart
new file mode 100644
index 000000000..7e917581f
--- /dev/null
+++ b/packages/stac_core/lib/widgets/default_navigation_controller/stac_default_navigation_controller.g.dart
@@ -0,0 +1,24 @@
+// GENERATED CODE - DO NOT MODIFY BY HAND
+
+part of 'stac_default_navigation_controller.dart';
+
+// **************************************************************************
+// JsonSerializableGenerator
+// **************************************************************************
+
+StacDefaultNavigationController _$StacDefaultNavigationControllerFromJson(
+  Map<String, dynamic> json,
+) => StacDefaultNavigationController(
+  length: (json['length'] as num).toInt(),
+  initialIndex: (json['initialIndex'] as num?)?.toInt(),
+  child: StacWidget.fromJson(json['child'] as Map<String, dynamic>),
+);
+
+Map<String, dynamic> _$StacDefaultNavigationControllerToJson(
+  StacDefaultNavigationController instance,
+) => <String, dynamic>{
+  'length': instance.length,
+  'initialIndex': instance.initialIndex,
+  'child': instance.child.toJson(),
+  'type': instance.type,
+};
diff --git a/packages/stac_core/lib/widgets/navigation_bar/stac_navigation_bar.dart b/packages/stac_core/lib/widgets/navigation_bar/stac_navigation_bar.dart
new file mode 100644
index 000000000..c3e97c7e2
--- /dev/null
+++ b/packages/stac_core/lib/widgets/navigation_bar/stac_navigation_bar.dart
@@ -0,0 +1,161 @@
+import 'package:json_annotation/json_annotation.dart';
+import 'package:stac_core/core/converters/double_converter.dart';
+import 'package:stac_core/core/stac_widget.dart';
+import 'package:stac_core/foundation/foundation.dart';
+
+part 'stac_navigation_bar.g.dart';
+
+/// A Stac model representing Flutter's Material 3 [NavigationBar].
+///
+/// Displays a horizontal bar of [StacNavigationDestination]s, typically
+/// placed in [StacScaffold]'s `bottomNavigationBar` slot. Pair with a
+/// [StacDefaultBottomNavigationController] to drive selection state.
+///
+/// Dart example:
+/// ```dart
+/// StacNavigationBar(
+///   destinations: [
+///     StacNavigationDestination(
+///       icon: StacIcon(icon: 'home_outlined'),
+///       selectedIcon: StacIcon(icon: 'home'),
+///       label: 'Home',
+///     ),
+///     StacNavigationDestination(
+///       icon: StacIcon(icon: 'settings_outlined'),
+///       selectedIcon: StacIcon(icon: 'settings'),
+///       label: 'Settings',
+///     ),
+///   ],
+/// )
+/// ```
+///
+/// JSON example:
+/// ```json
+/// {
+///   "type": "navigationBar",
+///   "destinations": [
+///     {
+///       "icon": {"type": "icon", "icon": "home_outlined"},
+///       "selectedIcon": {"type": "icon", "icon": "home"},
+///       "label": "Home"
+///     },
+///     {
+///       "icon": {"type": "icon", "icon": "settings_outlined"},
+///       "selectedIcon": {"type": "icon", "icon": "settings"},
+///       "label": "Settings"
+///     }
+///   ]
+/// }
+/// ```
+///
+/// See also:
+///  * Flutter's NavigationBar docs (`https://api.flutter.dev/flutter/material/NavigationBar-class.html`)
+@JsonSerializable(explicitToJson: true)
+class StacNavigationBar extends StacWidget {
+  /// Creates a navigation bar with the specified properties.
+  const StacNavigationBar({
+    required this.destinations,
+    this.animationDuration,
+    this.selectedIndex,
+    this.backgroundColor,
+    this.elevation,
+    this.shadowColor,
+    this.surfaceTintColor,
+    this.indicatorColor,
+    this.indicatorShape,
+    this.height,
+    this.labelBehavior,
+    this.labelTextStyle,
+    this.labelPadding,
+    this.maintainBottomViewPadding,
+  });
+
+  /// The destinations shown in the navigation bar.
+  ///
+  /// Type: [StacNavigationDestination]
+  final List<StacNavigationDestination> destinations;
+
+  /// Transition time for each destination as it goes between selected
+  /// and unselected.
+  ///
+  /// Type: [StacDuration]
+  final StacDuration? animationDuration;
+
+  /// The initial selected destination index. Ignored when a
+  /// [StacDefaultBottomNavigationController] is provided.
+  ///
+  /// Type: [int]
+  final int? selectedIndex;
+
+  /// The color of the [NavigationBar] itself.
+  ///
+  /// Type: [String] (hex color)
+  final String? backgroundColor;
+
+  /// The elevation of the navigation bar.
+  ///
+  /// Type: [double]
+  @DoubleConverter()
+  final double? elevation;
+
+  /// The color used for the drop shadow to indicate elevation.
+  ///
+  /// Type: [String] (hex color)
+  final String? shadowColor;
+
+  /// The color used as an overlay on [backgroundColor] to indicate
+  /// elevation.
+  ///
+  /// Type: [String] (hex color)
+  final String? surfaceTintColor;
+
+  /// The color of the selected destination's indicator.
+  ///
+  /// Type: [String] (hex color)
+  final String? indicatorColor;
+
+  /// The shape of the selected destination's indicator.
+  ///
+  /// Type: [StacBorder]
+  final StacBorder? indicatorShape;
+
+  /// The height of the navigation bar.
+  ///
+  /// Type: [double]
+  @DoubleConverter()
+  final double? height;
+
+  /// Defines how destination labels are laid out and when they are
+  /// displayed.
+  ///
+  /// Type: [StacNavigationDestinationLabelBehavior]
+  final StacNavigationDestinationLabelBehavior? labelBehavior;
+
+  /// The text style for destination labels.
+  ///
+  /// Type: [StacTextStyle]
+  final StacTextStyle? labelTextStyle;
+
+  /// The padding around each destination's label widget.
+  ///
+  /// Type: [StacEdgeInsets]
+  final StacEdgeInsets? labelPadding;
+
+  /// Whether the underlying [SafeArea] should maintain the bottom
+  /// `viewPadding` instead of the bottom `padding`.
+  ///
+  /// Type: [bool]
+  final bool? maintainBottomViewPadding;
+
+  /// Widget type identifier.
+  @override
+  String get type => WidgetType.navigationBar.name;
+
+  /// Creates a [StacNavigationBar] from a JSON map.
+  factory StacNavigationBar.fromJson(Map<String, dynamic> json) =>
+      _$StacNavigationBarFromJson(json);
+
+  /// Converts this [StacNavigationBar] instance to a JSON map.
+  @override
+  Map<String, dynamic> toJson() => _$StacNavigationBarToJson(this);
+}
diff --git a/packages/stac_core/lib/widgets/navigation_bar/stac_navigation_bar.g.dart b/packages/stac_core/lib/widgets/navigation_bar/stac_navigation_bar.g.dart
new file mode 100644
index 000000000..599464c16
--- /dev/null
+++ b/packages/stac_core/lib/widgets/navigation_bar/stac_navigation_bar.g.dart
@@ -0,0 +1,70 @@
+// GENERATED CODE - DO NOT MODIFY BY HAND
+
+part of 'stac_navigation_bar.dart';
+
+// **************************************************************************
+// JsonSerializableGenerator
+// **************************************************************************
+
+StacNavigationBar _$StacNavigationBarFromJson(Map<String, dynamic> json) =>
+    StacNavigationBar(
+      destinations: (json['destinations'] as List<dynamic>)
+          .map(
+            (e) =>
+                StacNavigationDestination.fromJson(e as Map<String, dynamic>),
+          )
+          .toList(),
+      animationDuration: json['animationDuration'] == null
+          ? null
+          : StacDuration.fromJson(
+              json['animationDuration'] as Map<String, dynamic>,
+            ),
+      selectedIndex: (json['selectedIndex'] as num?)?.toInt(),
+      backgroundColor: json['backgroundColor'] as String?,
+      elevation: const DoubleConverter().fromJson(json['elevation']),
+      shadowColor: json['shadowColor'] as String?,
+      surfaceTintColor: json['surfaceTintColor'] as String?,
+      indicatorColor: json['indicatorColor'] as String?,
+      indicatorShape: json['indicatorShape'] == null
+          ? null
+          : StacBorder.fromJson(json['indicatorShape'] as Map<String, dynamic>),
+      height: const DoubleConverter().fromJson(json['height']),
+      labelBehavior: $enumDecodeNullable(
+        _$StacNavigationDestinationLabelBehaviorEnumMap,
+        json['labelBehavior'],
+      ),
+      labelTextStyle: json['labelTextStyle'] == null
+          ? null
+          : StacTextStyle.fromJson(json['labelTextStyle']),
+      labelPadding: json['labelPadding'] == null
+          ? null
+          : StacEdgeInsets.fromJson(json['labelPadding']),
+      maintainBottomViewPadding: json['maintainBottomViewPadding'] as bool?,
+    );
+
+Map<String, dynamic> _$StacNavigationBarToJson(
+  StacNavigationBar instance,
+) => <String, dynamic>{
+  'destinations': instance.destinations.map((e) => e.toJson()).toList(),
+  'animationDuration': instance.animationDuration?.toJson(),
+  'selectedIndex': instance.selectedIndex,
+  'backgroundColor': instance.backgroundColor,
+  'elevation': const DoubleConverter().toJson(instance.elevation),
+  'shadowColor': instance.shadowColor,
+  'surfaceTintColor': instance.surfaceTintColor,
+  'indicatorColor': instance.indicatorColor,
+  'indicatorShape': instance.indicatorShape?.toJson(),
+  'height': const DoubleConverter().toJson(instance.height),
+  'labelBehavior':
+      _$StacNavigationDestinationLabelBehaviorEnumMap[instance.labelBehavior],
+  'labelTextStyle': instance.labelTextStyle?.toJson(),
+  'labelPadding': instance.labelPadding?.toJson(),
+  'maintainBottomViewPadding': instance.maintainBottomViewPadding,
+  'type': instance.type,
+};
+
+const _$StacNavigationDestinationLabelBehaviorEnumMap = {
+  StacNavigationDestinationLabelBehavior.alwaysShow: 'alwaysShow',
+  StacNavigationDestinationLabelBehavior.alwaysHide: 'alwaysHide',
+  StacNavigationDestinationLabelBehavior.onlyShowSelected: 'onlyShowSelected',
+};
diff --git a/packages/stac_core/lib/widgets/navigation_view/stac_navigation_view.dart b/packages/stac_core/lib/widgets/navigation_view/stac_navigation_view.dart
new file mode 100644
index 000000000..cb2585f75
--- /dev/null
+++ b/packages/stac_core/lib/widgets/navigation_view/stac_navigation_view.dart
@@ -0,0 +1,59 @@
+import 'package:json_annotation/json_annotation.dart';
+import 'package:stac_core/core/stac_widget.dart';
+import 'package:stac_core/foundation/specifications/widget_type.dart';
+
+part 'stac_navigation_view.g.dart';
+
+/// A Stac widget that displays one of its `children` based on the active
+/// index provided by a `NavigationScope` (established by a
+/// [StacDefaultNavigationController]).
+///
+/// Generic replacement for [StacBottomNavigationView] — works with any
+/// navigation widget (`bottomNavigationBar`, `navigationBar`, etc.).
+///
+/// {@tool snippet}
+/// Dart Example:
+/// ```dart
+/// StacDefaultNavigationController(
+///   length: 3,
+///   child: StacScaffold(
+///     body: StacNavigationView(
+///       children: const [
+///         StacCenter(child: StacText('Home')),
+///         StacCenter(child: StacText('Search')),
+///         StacCenter(child: StacText('Profile')),
+///       ],
+///     ),
+///     bottomNavigationBar: StacNavigationBar(
+///       destinations: [
+///         StacNavigationDestination(icon: StacIcon(icon: 'home'), label: 'Home'),
+///         StacNavigationDestination(icon: StacIcon(icon: 'search'), label: 'Search'),
+///         StacNavigationDestination(icon: StacIcon(icon: 'account_circle'), label: 'Profile'),
+///       ],
+///     ),
+///   ),
+/// )
+/// ```
+/// {@end-tool}
+@JsonSerializable()
+class StacNavigationView extends StacWidget {
+  /// Creates a [StacNavigationView].
+  const StacNavigationView({required this.children});
+
+  /// The list of pages that can be displayed.
+  ///
+  /// Type: [List] of [StacWidget]
+  final List<StacWidget> children;
+
+  /// Widget type identifier.
+  @override
+  String get type => WidgetType.navigationView.name;
+
+  /// Creates a [StacNavigationView] from a JSON map.
+  factory StacNavigationView.fromJson(Map<String, dynamic> json) =>
+      _$StacNavigationViewFromJson(json);
+
+  /// Converts this [StacNavigationView] instance to a JSON map.
+  @override
+  Map<String, dynamic> toJson() => _$StacNavigationViewToJson(this);
+}
diff --git a/packages/stac_core/lib/widgets/navigation_view/stac_navigation_view.g.dart b/packages/stac_core/lib/widgets/navigation_view/stac_navigation_view.g.dart
new file mode 100644
index 000000000..8d2e9b2e5
--- /dev/null
+++ b/packages/stac_core/lib/widgets/navigation_view/stac_navigation_view.g.dart
@@ -0,0 +1,20 @@
+// GENERATED CODE - DO NOT MODIFY BY HAND
+
+part of 'stac_navigation_view.dart';
+
+// **************************************************************************
+// JsonSerializableGenerator
+// **************************************************************************
+
+StacNavigationView _$StacNavigationViewFromJson(Map<String, dynamic> json) =>
+    StacNavigationView(
+      children: (json['children'] as List<dynamic>)
+          .map((e) => StacWidget.fromJson(e as Map<String, dynamic>))
+          .toList(),
+    );
+
+Map<String, dynamic> _$StacNavigationViewToJson(StacNavigationView instance) =>
+    <String, dynamic>{
+      'children': instance.children.map((e) => e.toJson()).toList(),
+      'type': instance.type,
+    };
diff --git a/packages/stac_core/lib/widgets/widgets.dart b/packages/stac_core/lib/widgets/widgets.dart
index a44733e82..fe4061ee3 100644
--- a/packages/stac_core/lib/widgets/widgets.dart
+++ b/packages/stac_core/lib/widgets/widgets.dart
@@ -23,6 +23,8 @@ export 'column/stac_column.dart';
 export 'conditional/stac_conditional.dart';
 export 'container/stac_container.dart';
 export 'custom_scroll_view/stac_custom_scroll_view.dart';
+export 'default_bottom_navigation_controller/stac_default_bottom_navigation_controller.dart';
+export 'default_navigation_controller/stac_default_navigation_controller.dart';
 export 'default_tab_controller/stac_default_tab_controller.dart';
 export 'divider/stac_divider.dart';
 export 'drawer/stac_drawer.dart';
@@ -48,6 +50,8 @@ export 'limited_box/stac_limited_box.dart';
 export 'linear_progress_indicator/stac_linear_progress_indicator.dart';
 export 'list_tile/stac_list_tile.dart';
 export 'list_view/stac_list_view.dart';
+export 'navigation_bar/stac_navigation_bar.dart';
+export 'navigation_view/stac_navigation_view.dart';
 export 'network_widget/stac_network_widget.dart';
 export 'opacity/stac_opacity.dart';
 export 'outlined_button/stac_outlined_button.dart';
@@ -67,14 +71,14 @@ export 'single_child_scroll_view/stac_single_child_scroll_view.dart';
 export 'sized_box/stac_sized_box.dart';
 export 'slider/stac_slider.dart';
 export 'sliver_app_bar/stac_sliver_app_bar.dart';
-export 'sliver_grid/stac_sliver_grid.dart';
 export 'sliver_fill_remaining/stac_sliver_fill_remaining.dart';
-export 'sliver_visibility/stac_sliver_visibility.dart';
+export 'sliver_grid/stac_sliver_grid.dart';
 export 'sliver_list/stac_sliver_list.dart';
 export 'sliver_opacity/stac_sliver_opacity.dart';
-export 'sliver_safe_area/stac_sliver_safe_area.dart';
 export 'sliver_padding/stac_sliver_padding.dart';
+export 'sliver_safe_area/stac_sliver_safe_area.dart';
 export 'sliver_to_box_adapter/stac_sliver_to_box_adapter.dart';
+export 'sliver_visibility/stac_sliver_visibility.dart';
 export 'spacer/stac_spacer.dart';
 export 'stack/stac_stack.dart';
 export 'switch/stac_switch.dart';
@@ -92,4 +96,3 @@ export 'tool_tip/stac_tool_tip.dart';
 export 'vertical_divider/stac_vertical_divider.dart';
 export 'visibility/stac_visibility.dart';
 export 'wrap/stac_wrap.dart';
-export 'default_bottom_navigation_controller/stac_default_bottom_navigation_controller.dart';

From 5358298a399a3a5279582b4db273804aaac4c27b Mon Sep 17 00:00:00 2001
From: Divyanshu Bhargava <divyanshub024@gmail.com>
Date: Tue, 12 May 2026 22:57:26 +0530
Subject: [PATCH 2/3] refactor: update navigation components for improved state
 management

- Removed the MinimumOSVersion key from AppFrameworkInfo.plist.
- Added a _clampIndex method to ensure valid index values in the DefaultNavigationController.
- Enhanced the didUpdateWidget method to handle index changes more effectively.
- Updated NavigationScope to include the current index and improved its update logic.
- Refactored the NavigationBar widget to utilize the new NavigationScope methods for better index handling.
---
 .../ios/Flutter/AppFrameworkInfo.plist        |  2 -
 ..._default_navigation_controller_parser.dart | 57 +++++++++++++++++--
 .../stac_navigation_bar_parser.dart           | 39 ++++++++-----
 .../navigation_bar/stac_navigation_bar.dart   |  4 +-
 4 files changed, 81 insertions(+), 21 deletions(-)

diff --git a/examples/stac_gallery/ios/Flutter/AppFrameworkInfo.plist b/examples/stac_gallery/ios/Flutter/AppFrameworkInfo.plist
index 1dc6cf765..391a902b2 100644
--- a/examples/stac_gallery/ios/Flutter/AppFrameworkInfo.plist
+++ b/examples/stac_gallery/ios/Flutter/AppFrameworkInfo.plist
@@ -20,7 +20,5 @@
   <string>????</string>
   <key>CFBundleVersion</key>
   <string>1.0</string>
-  <key>MinimumOSVersion</key>
-  <string>13.0</string>
 </dict>
 </plist>
diff --git a/packages/stac/lib/src/parsers/widgets/stac_default_navigation_controller/stac_default_navigation_controller_parser.dart b/packages/stac/lib/src/parsers/widgets/stac_default_navigation_controller/stac_default_navigation_controller_parser.dart
index 133e4f89f..ff6f4b9cd 100644
--- a/packages/stac/lib/src/parsers/widgets/stac_default_navigation_controller/stac_default_navigation_controller_parser.dart
+++ b/packages/stac/lib/src/parsers/widgets/stac_default_navigation_controller/stac_default_navigation_controller_parser.dart
@@ -35,6 +35,14 @@ class _DefaultNavigationControllerWidgetState
     extends State<_DefaultNavigationControllerWidget> {
   late NavigationController _controller;
 
+  int _clampIndex(int index, int length) {
+    if (length <= 0) {
+      return 0;
+    }
+
+    return index.clamp(0, length - 1);
+  }
+
   @override
   void initState() {
     super.initState();
@@ -47,15 +55,45 @@ class _DefaultNavigationControllerWidgetState
     _controller.addListener(_onIndexChange);
   }
 
+  @override
+  void didUpdateWidget(covariant _DefaultNavigationControllerWidget oldWidget) {
+    super.didUpdateWidget(oldWidget);
+
+    if (oldWidget.model.length == widget.model.length &&
+        oldWidget.model.initialIndex == widget.model.initialIndex) {
+      return;
+    }
+
+    final nextIndex = oldWidget.model.initialIndex == widget.model.initialIndex
+        ? _clampIndex(_controller.index, widget.model.length)
+        : widget.model.initialIndex ?? 0;
+
+    _controller.removeListener(_onIndexChange);
+    _controller.dispose();
+    _controller = NavigationController(
+      length: widget.model.length,
+      initialIndex: nextIndex,
+    );
+    _controller.addListener(_onIndexChange);
+  }
+
   void _onIndexChange() {
     setState(() {});
   }
 
+  @override
+  void dispose() {
+    _controller.removeListener(_onIndexChange);
+    _controller.dispose();
+    super.dispose();
+  }
+
   @override
   Widget build(BuildContext context) {
     return NavigationScope(
       length: widget.model.length,
       controller: _controller,
+      index: _controller.index,
       child: widget.model.child.parse(context) ?? const SizedBox(),
     );
   }
@@ -73,6 +111,7 @@ class NavigationScope extends InheritedWidget {
     required super.child,
     required this.length,
     required this.controller,
+    required this.index,
   });
 
   /// The number of navigation destinations.
@@ -81,11 +120,19 @@ class NavigationScope extends InheritedWidget {
   /// The controller that manages the current navigation index.
   final NavigationController controller;
 
+  /// The current navigation index.
+  final int index;
+
+  /// Returns the [NavigationScope] from the widget tree, or `null` if none
+  /// is found in scope.
+  static NavigationScope? maybeOf(BuildContext context) {
+    return context.dependOnInheritedWidgetOfExactType<NavigationScope>();
+  }
+
   /// Returns the [NavigationScope] from the widget tree, or `null` if none
   /// is found in scope.
   static NavigationScope? of(BuildContext context) {
-    final NavigationScope? result = context
-        .dependOnInheritedWidgetOfExactType<NavigationScope>();
+    final NavigationScope? result = maybeOf(context);
 
     if (result != null) {
       return result;
@@ -98,8 +145,10 @@ class NavigationScope extends InheritedWidget {
   }
 
   @override
-  bool updateShouldNotify(covariant InheritedWidget oldWidget) {
-    return oldWidget.child != child;
+  bool updateShouldNotify(covariant NavigationScope oldWidget) {
+    return oldWidget.length != length ||
+        oldWidget.controller != controller ||
+        oldWidget.index != index;
   }
 }
 
diff --git a/packages/stac/lib/src/parsers/widgets/stac_navigation_bar/stac_navigation_bar_parser.dart b/packages/stac/lib/src/parsers/widgets/stac_navigation_bar/stac_navigation_bar_parser.dart
index 647ed0a42..1b6a662b9 100644
--- a/packages/stac/lib/src/parsers/widgets/stac_navigation_bar/stac_navigation_bar_parser.dart
+++ b/packages/stac/lib/src/parsers/widgets/stac_navigation_bar/stac_navigation_bar_parser.dart
@@ -31,23 +31,36 @@ class _NavigationBarWidget extends StatelessWidget {
 
   final StacNavigationBar model;
 
+  int _clampIndex(int index, int length) {
+    if (length <= 0) {
+      return 0;
+    }
+
+    return index.clamp(0, length - 1);
+  }
+
   @override
   Widget build(BuildContext context) {
-    final controller = NavigationScope.of(context)?.controller;
+    final controller = NavigationScope.maybeOf(context)?.controller;
+    final destinations = model.destinations
+        .map(
+          (destination) => NavigationDestination(
+            icon: destination.icon.parse(context) ?? const SizedBox(),
+            selectedIcon: destination.selectedIcon?.parse(context),
+            label: destination.label,
+            tooltip: destination.tooltip,
+            enabled: destination.enabled ?? true,
+          ),
+        )
+        .toList();
+    final selectedIndex = _clampIndex(
+      controller?.index ?? model.selectedIndex ?? 0,
+      destinations.length,
+    );
 
     return NavigationBar(
-      destinations: model.destinations
-          .map(
-            (destination) => NavigationDestination(
-              icon: destination.icon.parse(context) ?? const SizedBox(),
-              selectedIcon: destination.selectedIcon?.parse(context),
-              label: destination.label,
-              tooltip: destination.tooltip,
-              enabled: destination.enabled ?? true,
-            ),
-          )
-          .toList(),
-      selectedIndex: controller?.index ?? model.selectedIndex ?? 0,
+      destinations: destinations,
+      selectedIndex: selectedIndex,
       onDestinationSelected: (index) {
         if (controller != null) {
           controller.index = index;
diff --git a/packages/stac_core/lib/widgets/navigation_bar/stac_navigation_bar.dart b/packages/stac_core/lib/widgets/navigation_bar/stac_navigation_bar.dart
index c3e97c7e2..28ad92c32 100644
--- a/packages/stac_core/lib/widgets/navigation_bar/stac_navigation_bar.dart
+++ b/packages/stac_core/lib/widgets/navigation_bar/stac_navigation_bar.dart
@@ -9,7 +9,7 @@ part 'stac_navigation_bar.g.dart';
 ///
 /// Displays a horizontal bar of [StacNavigationDestination]s, typically
 /// placed in [StacScaffold]'s `bottomNavigationBar` slot. Pair with a
-/// [StacDefaultBottomNavigationController] to drive selection state.
+/// [StacDefaultNavigationController] to drive selection state.
 ///
 /// Dart example:
 /// ```dart
@@ -82,7 +82,7 @@ class StacNavigationBar extends StacWidget {
   final StacDuration? animationDuration;
 
   /// The initial selected destination index. Ignored when a
-  /// [StacDefaultBottomNavigationController] is provided.
+  /// [StacDefaultNavigationController] is provided.
   ///
   /// Type: [int]
   final int? selectedIndex;

From 594d7db08e2d026c138300aa10640c5806ed7775 Mon Sep 17 00:00:00 2001
From: Divyanshu Bhargava <divyanshub024@gmail.com>
Date: Tue, 12 May 2026 23:15:11 +0530
Subject: [PATCH 3/3] refactor: enhance index handling in NavigationController

- Introduced a _clampIndex method to ensure valid index values during initialization and updates.
- Updated the NavigationController constructor to use clamped initial index values.
- Improved index validation logic to prevent out-of-bounds errors when changing the index.
---
 ..._default_navigation_controller_parser.dart | 36 ++++++++++++++++---
 1 file changed, 31 insertions(+), 5 deletions(-)

diff --git a/packages/stac/lib/src/parsers/widgets/stac_default_navigation_controller/stac_default_navigation_controller_parser.dart b/packages/stac/lib/src/parsers/widgets/stac_default_navigation_controller/stac_default_navigation_controller_parser.dart
index ff6f4b9cd..1d91ebc48 100644
--- a/packages/stac/lib/src/parsers/widgets/stac_default_navigation_controller/stac_default_navigation_controller_parser.dart
+++ b/packages/stac/lib/src/parsers/widgets/stac_default_navigation_controller/stac_default_navigation_controller_parser.dart
@@ -49,7 +49,10 @@ class _DefaultNavigationControllerWidgetState
 
     _controller = NavigationController(
       length: widget.model.length,
-      initialIndex: widget.model.initialIndex ?? 0,
+      initialIndex: _clampIndex(
+        widget.model.initialIndex ?? 0,
+        widget.model.length,
+      ),
     );
 
     _controller.addListener(_onIndexChange);
@@ -66,7 +69,7 @@ class _DefaultNavigationControllerWidgetState
 
     final nextIndex = oldWidget.model.initialIndex == widget.model.initialIndex
         ? _clampIndex(_controller.index, widget.model.length)
-        : widget.model.initialIndex ?? 0;
+        : _clampIndex(widget.model.initialIndex ?? 0, widget.model.length);
 
     _controller.removeListener(_onIndexChange);
     _controller.dispose();
@@ -159,8 +162,9 @@ class NavigationScope extends InheritedWidget {
 /// widgets and views.
 class NavigationController extends ChangeNotifier {
   /// Creates a [NavigationController] with the specified properties.
-  NavigationController({this.initialIndex = 0, required this.length})
-    : _index = initialIndex;
+  NavigationController({int initialIndex = 0, required this.length})
+    : initialIndex = _clampIndex(initialIndex, length),
+      _index = _clampIndex(initialIndex, length);
 
   /// The initial index when the controller is created.
   final int initialIndex;
@@ -176,8 +180,30 @@ class NavigationController extends ChangeNotifier {
   /// Sets the current selected index.
   set index(int value) => _changeIndex(value);
 
+  static int _clampIndex(int index, int length) {
+    if (length <= 0) {
+      return 0;
+    }
+
+    return index.clamp(0, length - 1);
+  }
+
+  void _validateIndex(int value) {
+    if (length <= 0) {
+      if (value == 0) {
+        return;
+      }
+
+      throw RangeError.range(value, 0, 0, 'value');
+    }
+
+    if (value < 0 || value >= length) {
+      throw RangeError.range(value, 0, length - 1, 'value');
+    }
+  }
+
   void _changeIndex(int value) {
-    assert(value >= 0 && (value < length || length == 0));
+    _validateIndex(value);
 
     if (value == _index || length < 2) {
       return;