From e1b0b5bb6256badd24343c48bb59803e56a0c9be Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 8 Feb 2024 18:00:18 +0100
Subject: [PATCH 01/24] Add HydeKernel property for the main NavigationMenu

---
 packages/framework/src/Foundation/HydeKernel.php | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/packages/framework/src/Foundation/HydeKernel.php b/packages/framework/src/Foundation/HydeKernel.php
index a476090bfc5..1104d216067 100644
--- a/packages/framework/src/Foundation/HydeKernel.php
+++ b/packages/framework/src/Foundation/HydeKernel.php
@@ -13,6 +13,7 @@
 use Hyde\Support\Contracts\SerializableContract;
 use Hyde\Support\Concerns\Serializable;
 use Illuminate\Support\Traits\Macroable;
+use Hyde\Framework\Features\Navigation\NavigationMenu;
 
 /**
  * Encapsulates a HydePHP project, providing helpful methods for interacting with it.
@@ -65,6 +66,8 @@ class HydeKernel implements SerializableContract
     protected PageCollection $pages;
     protected RouteCollection $routes;
 
+    protected NavigationMenu $navigation;
+
     protected bool $booted = false;
 
     /** @var array<class-string<\Hyde\Foundation\Concerns\HydeExtension>, \Hyde\Foundation\Concerns\HydeExtension> */

From 1b577c98b17d1706d6af720a40383b476c0e2561 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 8 Feb 2024 18:01:05 +0100
Subject: [PATCH 02/24] Create navigation menu on kernel boot

---
 packages/framework/src/Foundation/Concerns/BootsHydeKernel.php | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/packages/framework/src/Foundation/Concerns/BootsHydeKernel.php b/packages/framework/src/Foundation/Concerns/BootsHydeKernel.php
index c680133cc9f..76ded9e4742 100644
--- a/packages/framework/src/Foundation/Concerns/BootsHydeKernel.php
+++ b/packages/framework/src/Foundation/Concerns/BootsHydeKernel.php
@@ -7,6 +7,7 @@
 use Hyde\Foundation\Kernel\FileCollection;
 use Hyde\Foundation\Kernel\PageCollection;
 use Hyde\Foundation\Kernel\RouteCollection;
+use Hyde\Framework\Features\Navigation\NavigationMenu;
 
 /**
  * @internal Single-use trait for the HydeKernel class.
@@ -58,6 +59,8 @@ public function boot(): void
             $callback($this);
         }
 
+        $this->navigation = NavigationMenu::create();
+
         $this->booting = false;
         $this->booted = true;
     }

From ad16097f4a8bcaa8976b51de179ec9f30e5695d7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 8 Feb 2024 18:05:37 +0100
Subject: [PATCH 03/24] Add kernel navigation accessor

---
 packages/framework/src/Foundation/HydeKernel.php | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/packages/framework/src/Foundation/HydeKernel.php b/packages/framework/src/Foundation/HydeKernel.php
index 1104d216067..cb6097a30cf 100644
--- a/packages/framework/src/Foundation/HydeKernel.php
+++ b/packages/framework/src/Foundation/HydeKernel.php
@@ -112,4 +112,9 @@ public function toArray(): array
             'routes' => $this->routes(),
         ];
     }
+
+    public function navigation(): NavigationMenu
+    {
+        return $this->navigation;
+    }
 }

From a5ed6cb0aaddedf3ac04cf1e2f0c349e9abdbd1b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 8 Feb 2024 18:05:56 +0100
Subject: [PATCH 04/24] Get navigation from kernel

---
 packages/framework/resources/views/layouts/navigation.blade.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/resources/views/layouts/navigation.blade.php b/packages/framework/resources/views/layouts/navigation.blade.php
index 17707d5e10a..cf8c2954bab 100644
--- a/packages/framework/resources/views/layouts/navigation.blade.php
+++ b/packages/framework/resources/views/layouts/navigation.blade.php
@@ -1,5 +1,5 @@
 @php
-    $navigation = \Hyde\Framework\Features\Navigation\NavigationMenu::create();
+    $navigation = \Hyde\Hyde::navigation();
 @endphp
 
 <nav aria-label="Main navigation" id="main-navigation" class="flex flex-wrap items-center justify-between p-4 shadow-lg sm:shadow-xl md:shadow-none dark:bg-gray-800">

From 89730aea0b9fe862f0a2115d5672691114c34920 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 8 Feb 2024 19:09:16 +0100
Subject: [PATCH 05/24] Boot the kernel

Now needed in unit tests to get the navigation. Not an issue for actual sites.
---
 packages/framework/tests/Feature/DarkmodeFeatureTest.php       | 3 +++
 packages/framework/tests/Unit/Views/NavigationMenuViewTest.php | 2 ++
 2 files changed, 5 insertions(+)

diff --git a/packages/framework/tests/Feature/DarkmodeFeatureTest.php b/packages/framework/tests/Feature/DarkmodeFeatureTest.php
index d1f16c24903..e8a8d5baa16 100644
--- a/packages/framework/tests/Feature/DarkmodeFeatureTest.php
+++ b/packages/framework/tests/Feature/DarkmodeFeatureTest.php
@@ -4,6 +4,7 @@
 
 namespace Hyde\Framework\Testing\Feature;
 
+use Hyde\Hyde;
 use Hyde\Facades\Features;
 use Hyde\Pages\DocumentationPage;
 use Hyde\Testing\TestCase;
@@ -21,6 +22,8 @@ protected function setUp(): void
 
         $this->mockRoute();
         $this->mockPage();
+
+        Hyde::boot();
     }
 
     public function test_has_darkmode()
diff --git a/packages/framework/tests/Unit/Views/NavigationMenuViewTest.php b/packages/framework/tests/Unit/Views/NavigationMenuViewTest.php
index ba8eb89393f..41f13a493de 100644
--- a/packages/framework/tests/Unit/Views/NavigationMenuViewTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationMenuViewTest.php
@@ -18,6 +18,8 @@ protected function setUp(): void
         parent::setUp();
         $this->mockRoute();
         $this->mockPage();
+
+        Hyde::boot();
     }
 
     protected function render(): string

From fdf73674187c08598d6b1edc8a0c451c93ee4eb0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 8 Feb 2024 18:54:54 +0100
Subject: [PATCH 06/24] Update internal destination state to support route
 instances

---
 .../framework/src/Framework/Features/Navigation/NavItem.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 7a57b554282..b78e7858502 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -20,7 +20,7 @@
  */
 class NavItem implements Stringable
 {
-    public readonly string $destination;
+    public readonly Route|string $destination;
     public readonly string $label;
     public readonly int $priority;
     public readonly ?string $group;

From 36f692d9305ca85cdbb61dd6196de41ae0e4f8a0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 8 Feb 2024 18:55:07 +0100
Subject: [PATCH 07/24] Remove string cast forcing early evaluation

---
 .../framework/src/Framework/Features/Navigation/NavItem.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index b78e7858502..3bc79da925a 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -30,7 +30,7 @@ class NavItem implements Stringable
      */
     public function __construct(Route|string $destination, string $label, int $priority = 500, ?string $group = null)
     {
-        $this->destination = (string) $destination;
+        $this->destination = $destination;
         $this->label = $label;
         $this->priority = $priority;
         $this->group = $group;

From 29f29777f0245906880247e3c269bf0ef89fd989 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 8 Feb 2024 18:55:26 +0100
Subject: [PATCH 08/24] Remove early route resolver

---
 .../framework/src/Framework/Features/Navigation/NavItem.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 3bc79da925a..b3f85f5f09c 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -42,7 +42,7 @@ public function __construct(Route|string $destination, string $label, int $prior
     public static function fromRoute(Route $route, ?string $label = null, ?int $priority = null, ?string $group = null): static
     {
         return new static(
-            $route->getLink(),
+            $route,
             $label ?? $route->getPage()->navigationMenuLabel(),
             $priority ?? $route->getPage()->navigationMenuPriority(),
             $group ?? static::getRouteGroup($route),

From 384a8228c014e72f7353411e32e7051c4263fc77 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 8 Feb 2024 18:56:09 +0100
Subject: [PATCH 09/24] Add string cast to string resolver

---
 .../framework/src/Framework/Features/Navigation/NavItem.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index b3f85f5f09c..aa37636499a 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -75,7 +75,7 @@ public static function forRoute(Route|string $route, ?string $label = null, ?int
      */
     public function __toString(): string
     {
-        return $this->destination;
+        return (string) $this->destination;
     }
 
     /**

From 43d4aa2d4a7c27602d9d696b7f9c21932f5592b2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 8 Feb 2024 18:58:53 +0100
Subject: [PATCH 10/24] Compare current state as string

---
 .../framework/src/Framework/Features/Navigation/NavItem.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index aa37636499a..a0a4e0d3237 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -120,7 +120,7 @@ public function getGroup(): ?string
      */
     public function isCurrent(): bool
     {
-        return Hyde::currentRoute()->getLink() === $this->destination;
+        return Hyde::currentRoute()->getLink() === (string) $this->destination;
     }
 
     protected static function getRouteGroup(Route $route): ?string

From 600c0e86bf3919154943c13fce5dc2aaf169d495 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 8 Feb 2024 19:01:13 +0100
Subject: [PATCH 11/24] Union return type

---
 .../framework/src/Framework/Features/Navigation/NavItem.php   | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index a0a4e0d3237..4c13e78d17e 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -82,9 +82,9 @@ public function __toString(): string
      * Get the destination link of the navigation item.
      *
      * If the navigation item is an external link, this will return the link as is,
-     * if it's for a route, a resolved relative link will be returned.
+     * if it's for a route, the route instance will be returned.
      */
-    public function getDestination(): string
+    public function getDestination(): Route|string
     {
         return $this->destination;
     }

From 94c1f37eb61d48792916fb762ac619b42a43063f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 8 Feb 2024 19:06:54 +0100
Subject: [PATCH 12/24] Merge pull request #1539 from
 hydephp/update-navitem-class-to-support-deferring-route-resolves

Update NavItem class to support deferring route resolves
---
 RELEASE_NOTES.md                               | 10 ++++++++++
 .../Framework/Features/Navigation/NavItem.php  | 13 ++++++++++++-
 packages/framework/tests/Unit/NavItemTest.php  | 18 +++++++++++++-----
 3 files changed, 35 insertions(+), 6 deletions(-)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 42b678e6888..e457cd069bd 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -11,10 +11,12 @@ This serves two purposes:
 
 ### Added
 - Added a new `\Hyde\Framework\Actions\PreBuildTasks\TransferMediaAssets` build task handle media assets transfers for site builds.
+- Added a new `NavItem::getLink()` method contain the previous `NavItem::getDestination()` logic, to return the link URL.
 
 ### Changed
 - Changed how the documentation search is generated, to be an `InMemoryPage` instead of a post-build task.
 - Media asset files are now copied using the new build task instead of the deprecated `BuildService::transferMediaAssets()` method.
+- The `NavItem::getDestination()` method now returns its `Route` instance if that is the destination type.
 
 ### Deprecated
 - for soon-to-be removed features.
@@ -54,6 +56,14 @@ For more information, see https://github.com/hydephp/develop/pull/1498.
 
 ## Low impact
 
+### Navigation item changes
+
+The `NavItem::getDestination()` method now returns its `Route` instance if that is the destination type. This allows for deferring the route evaluation.
+
+If you have previously used this method directly and expected a string to be returned, you may need to adapt your code to handle the new return type.
+
+If you want to retain the previous state where a string is always returned, you can use the new `NavItem::getLink()` method instead, which will resolve the route immediately.
+
 ### New documentation search implementation
 
 As the new documentation search implementation brings changes to their code API you may need to adapt your code
diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 4c13e78d17e..063b5e66035 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -79,7 +79,7 @@ public function __toString(): string
     }
 
     /**
-     * Get the destination link of the navigation item.
+     * Get the destination of the navigation item.
      *
      * If the navigation item is an external link, this will return the link as is,
      * if it's for a route, the route instance will be returned.
@@ -89,6 +89,17 @@ public function getDestination(): Route|string
         return $this->destination;
     }
 
+    /**
+     * Get the destination link of the navigation item.
+     *
+     * If the navigation item is an external link, this will return the link as is,
+     * if it's for a route, the route's resolved link will be returned.
+     */
+    public function getLink(): string
+    {
+        return (string) $this->destination;
+    }
+
     /**
      * Get the label of the navigation item.
      */
diff --git a/packages/framework/tests/Unit/NavItemTest.php b/packages/framework/tests/Unit/NavItemTest.php
index 2976278c85f..ec17247b674 100644
--- a/packages/framework/tests/Unit/NavItemTest.php
+++ b/packages/framework/tests/Unit/NavItemTest.php
@@ -43,13 +43,21 @@ public function test__construct()
         $route = new Route(new MarkdownPage());
         $item = new NavItem($route, 'Test', 500);
 
-        $this->assertSame($route->getLink(), $item->destination);
+        $this->assertSame($route, $item->destination);
     }
 
     public function testGetDestination()
+    {
+        $route = new Route(new MarkdownPage());
+        $item = new NavItem($route, 'Test', 500);
+
+        $this->assertSame($route, $item->getDestination());
+    }
+
+    public function testGetLink()
     {
         $navItem = new NavItem(new Route(new InMemoryPage('foo')), 'Page', 500);
-        $this->assertSame('foo.html', $navItem->getDestination());
+        $this->assertSame('foo.html', $navItem->getLink());
     }
 
     public function testGetLabel()
@@ -75,7 +83,7 @@ public function testFromRoute()
         $route = new Route(new MarkdownPage());
         $item = NavItem::fromRoute($route);
 
-        $this->assertSame($route->getLink(), $item->destination);
+        $this->assertSame($route, $item->destination);
     }
 
     public function test__toString()
@@ -104,7 +112,7 @@ public function testForRoute()
         $route = Routes::get('404');
         $item = NavItem::forRoute($route, 'foo');
 
-        $this->assertSame($route->getLink(), $item->destination);
+        $this->assertSame($route, $item->destination);
         $this->assertSame('foo', $item->label);
         $this->assertSame(999, $item->priority);
     }
@@ -114,7 +122,7 @@ public function testForIndexRoute()
         $route = Routes::get('index');
         $item = NavItem::forRoute($route, 'foo');
 
-        $this->assertSame($route->getLink(), $item->destination);
+        $this->assertSame($route, $item->destination);
         $this->assertSame('foo', $item->label);
         $this->assertSame(0, $item->priority);
     }

From 9a3136d63ecc740df5e679f6b0ddeb346eea0e74 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 8 Feb 2024 21:17:07 +0100
Subject: [PATCH 13/24] Add navigation helper method annotation

---
 packages/framework/src/Hyde.php | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Hyde.php b/packages/framework/src/Hyde.php
index e6e65246d25..7ee2fb81aea 100644
--- a/packages/framework/src/Hyde.php
+++ b/packages/framework/src/Hyde.php
@@ -10,6 +10,7 @@
 use Hyde\Foundation\Kernel\Filesystem;
 use Hyde\Foundation\Kernel\PageCollection;
 use Hyde\Foundation\Kernel\RouteCollection;
+use Hyde\Framework\Features\Navigation\NavigationMenu;
 use Hyde\Pages\Concerns\HydePage;
 use Hyde\Support\Models\Route;
 use Hyde\Support\Filesystem\SourceFile;
@@ -50,6 +51,7 @@
  * @method static string getMediaDirectory()
  * @method static string getMediaOutputDirectory()
  * @method static Features features()
+ * @method static NavigationMenu navigation()
  * @method static FileCollection<SourceFile> files()
  * @method static PageCollection<HydePage> pages()
  * @method static RouteCollection<Route> routes()

From af133ba9886747dd14a4ce6318764196e487ee8c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 8 Feb 2024 21:19:01 +0100
Subject: [PATCH 14/24] Test navigation accessor

---
 packages/framework/tests/Feature/HydeKernelTest.php | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/packages/framework/tests/Feature/HydeKernelTest.php b/packages/framework/tests/Feature/HydeKernelTest.php
index f497b9aa087..a6c0c912d83 100644
--- a/packages/framework/tests/Feature/HydeKernelTest.php
+++ b/packages/framework/tests/Feature/HydeKernelTest.php
@@ -24,6 +24,7 @@
 use Hyde\Testing\TestCase;
 use Illuminate\Support\Facades\Config;
 use Illuminate\Support\HtmlString;
+use Hyde\Framework\Features\Navigation\NavigationMenu;
 
 /**
  * This test class runs high-level tests on the HydeKernel class,
@@ -79,6 +80,13 @@ public function test_has_feature_helper_calls_method_on_features_class()
         $this->assertSame(Features::enabled('foo'), Hyde::hasFeature('foo'));
     }
 
+    public function test_has_navigation_helper_returns_site_navigation_instance()
+    {
+        Hyde::boot();
+
+        $this->assertInstanceOf(NavigationMenu::class, Hyde::navigation());
+    }
+
     public function test_current_page_helper_returns_current_page_name()
     {
         Render::share('routeKey', 'foo');

From 5ed4d6a4ede0325dfd0fa23470f9cdad44e1b4e2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 8 Feb 2024 21:20:36 +0100
Subject: [PATCH 15/24] Boot kernel when trying to get navigation

---
 packages/framework/src/Foundation/HydeKernel.php    | 2 ++
 packages/framework/tests/Feature/HydeKernelTest.php | 2 --
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Foundation/HydeKernel.php b/packages/framework/src/Foundation/HydeKernel.php
index cb6097a30cf..5eaf6dea0dd 100644
--- a/packages/framework/src/Foundation/HydeKernel.php
+++ b/packages/framework/src/Foundation/HydeKernel.php
@@ -115,6 +115,8 @@ public function toArray(): array
 
     public function navigation(): NavigationMenu
     {
+        $this->needsToBeBooted();
+
         return $this->navigation;
     }
 }
diff --git a/packages/framework/tests/Feature/HydeKernelTest.php b/packages/framework/tests/Feature/HydeKernelTest.php
index a6c0c912d83..229c2a553ba 100644
--- a/packages/framework/tests/Feature/HydeKernelTest.php
+++ b/packages/framework/tests/Feature/HydeKernelTest.php
@@ -82,8 +82,6 @@ public function test_has_feature_helper_calls_method_on_features_class()
 
     public function test_has_navigation_helper_returns_site_navigation_instance()
     {
-        Hyde::boot();
-
         $this->assertInstanceOf(NavigationMenu::class, Hyde::navigation());
     }
 

From ed6c6a74d3d6e57ed51531ccadb6bffc03d0e388 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 8 Feb 2024 21:20:41 +0100
Subject: [PATCH 16/24] Revert "Boot the kernel"

This reverts commit 89730aea0b9fe862f0a2115d5672691114c34920.
---
 packages/framework/tests/Feature/DarkmodeFeatureTest.php       | 3 ---
 packages/framework/tests/Unit/Views/NavigationMenuViewTest.php | 2 --
 2 files changed, 5 deletions(-)

diff --git a/packages/framework/tests/Feature/DarkmodeFeatureTest.php b/packages/framework/tests/Feature/DarkmodeFeatureTest.php
index e8a8d5baa16..d1f16c24903 100644
--- a/packages/framework/tests/Feature/DarkmodeFeatureTest.php
+++ b/packages/framework/tests/Feature/DarkmodeFeatureTest.php
@@ -4,7 +4,6 @@
 
 namespace Hyde\Framework\Testing\Feature;
 
-use Hyde\Hyde;
 use Hyde\Facades\Features;
 use Hyde\Pages\DocumentationPage;
 use Hyde\Testing\TestCase;
@@ -22,8 +21,6 @@ protected function setUp(): void
 
         $this->mockRoute();
         $this->mockPage();
-
-        Hyde::boot();
     }
 
     public function test_has_darkmode()
diff --git a/packages/framework/tests/Unit/Views/NavigationMenuViewTest.php b/packages/framework/tests/Unit/Views/NavigationMenuViewTest.php
index 41f13a493de..ba8eb89393f 100644
--- a/packages/framework/tests/Unit/Views/NavigationMenuViewTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationMenuViewTest.php
@@ -18,8 +18,6 @@ protected function setUp(): void
         parent::setUp();
         $this->mockRoute();
         $this->mockPage();
-
-        Hyde::boot();
     }
 
     protected function render(): string

From 01b1ce1b4341da3cad4e8b2f9daf06add6a38cf5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 8 Feb 2024 21:25:41 +0100
Subject: [PATCH 17/24] Move navigation accessor to helper trait

---
 .../src/Foundation/Concerns/ManagesHydeKernel.php         | 8 ++++++++
 packages/framework/src/Foundation/HydeKernel.php          | 7 -------
 2 files changed, 8 insertions(+), 7 deletions(-)

diff --git a/packages/framework/src/Foundation/Concerns/ManagesHydeKernel.php b/packages/framework/src/Foundation/Concerns/ManagesHydeKernel.php
index eb63fe767b8..0eb429061f2 100644
--- a/packages/framework/src/Foundation/Concerns/ManagesHydeKernel.php
+++ b/packages/framework/src/Foundation/Concerns/ManagesHydeKernel.php
@@ -5,6 +5,7 @@
 namespace Hyde\Foundation\Concerns;
 
 use Hyde\Foundation\HydeKernel;
+use Hyde\Framework\Features\Navigation\NavigationMenu;
 
 use function ltrim;
 use function rtrim;
@@ -71,6 +72,13 @@ public function getMediaOutputDirectory(): string
         return ltrim($this->getMediaDirectory(), '_');
     }
 
+    public function navigation(): NavigationMenu
+    {
+        $this->needsToBeBooted();
+
+        return $this->navigation;
+    }
+
     protected function normalizeSourcePath(string $outputDirectory): string
     {
         return $this->pathToRelative(rtrim($outputDirectory, '/\\'));
diff --git a/packages/framework/src/Foundation/HydeKernel.php b/packages/framework/src/Foundation/HydeKernel.php
index 5eaf6dea0dd..1104d216067 100644
--- a/packages/framework/src/Foundation/HydeKernel.php
+++ b/packages/framework/src/Foundation/HydeKernel.php
@@ -112,11 +112,4 @@ public function toArray(): array
             'routes' => $this->routes(),
         ];
     }
-
-    public function navigation(): NavigationMenu
-    {
-        $this->needsToBeBooted();
-
-        return $this->navigation;
-    }
 }

From e4270be03ed272e3719efd25c4744d47867ab17d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 8 Feb 2024 21:25:59 +0100
Subject: [PATCH 18/24] Sort imports

---
 packages/framework/src/Foundation/HydeKernel.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Foundation/HydeKernel.php b/packages/framework/src/Foundation/HydeKernel.php
index 1104d216067..fdd5c788639 100644
--- a/packages/framework/src/Foundation/HydeKernel.php
+++ b/packages/framework/src/Foundation/HydeKernel.php
@@ -11,9 +11,9 @@
 use Hyde\Foundation\Kernel\PageCollection;
 use Hyde\Foundation\Kernel\RouteCollection;
 use Hyde\Support\Contracts\SerializableContract;
+use Hyde\Framework\Features\Navigation\NavigationMenu;
 use Hyde\Support\Concerns\Serializable;
 use Illuminate\Support\Traits\Macroable;
-use Hyde\Framework\Features\Navigation\NavigationMenu;
 
 /**
  * Encapsulates a HydePHP project, providing helpful methods for interacting with it.

From a246c6ea15d183bbf6294a6fb677517c827dc088 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 8 Feb 2024 21:40:26 +0100
Subject: [PATCH 19/24] Revert "Boot kernel when trying to get navigation"

This reverts commit 5ed4d6a4ede0325dfd0fa23470f9cdad44e1b4e2. See https://github.com/hydephp/develop/pull/1538/files#r1483561606
---
 .../framework/src/Foundation/Concerns/ManagesHydeKernel.php     | 2 --
 packages/framework/tests/Feature/HydeKernelTest.php             | 2 ++
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Foundation/Concerns/ManagesHydeKernel.php b/packages/framework/src/Foundation/Concerns/ManagesHydeKernel.php
index 0eb429061f2..4ea50e5eb6e 100644
--- a/packages/framework/src/Foundation/Concerns/ManagesHydeKernel.php
+++ b/packages/framework/src/Foundation/Concerns/ManagesHydeKernel.php
@@ -74,8 +74,6 @@ public function getMediaOutputDirectory(): string
 
     public function navigation(): NavigationMenu
     {
-        $this->needsToBeBooted();
-
         return $this->navigation;
     }
 
diff --git a/packages/framework/tests/Feature/HydeKernelTest.php b/packages/framework/tests/Feature/HydeKernelTest.php
index 229c2a553ba..a6c0c912d83 100644
--- a/packages/framework/tests/Feature/HydeKernelTest.php
+++ b/packages/framework/tests/Feature/HydeKernelTest.php
@@ -82,6 +82,8 @@ public function test_has_feature_helper_calls_method_on_features_class()
 
     public function test_has_navigation_helper_returns_site_navigation_instance()
     {
+        Hyde::boot();
+
         $this->assertInstanceOf(NavigationMenu::class, Hyde::navigation());
     }
 

From 6d6951e71f574d9f96bd3fbcd8e396b03dc98e40 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 8 Feb 2024 21:41:01 +0100
Subject: [PATCH 20/24] Revert "Revert "Boot the kernel""

This reverts commit ed6c6a74d3d6e57ed51531ccadb6bffc03d0e388.
---
 packages/framework/tests/Feature/DarkmodeFeatureTest.php       | 3 +++
 packages/framework/tests/Unit/Views/NavigationMenuViewTest.php | 2 ++
 2 files changed, 5 insertions(+)

diff --git a/packages/framework/tests/Feature/DarkmodeFeatureTest.php b/packages/framework/tests/Feature/DarkmodeFeatureTest.php
index d1f16c24903..e8a8d5baa16 100644
--- a/packages/framework/tests/Feature/DarkmodeFeatureTest.php
+++ b/packages/framework/tests/Feature/DarkmodeFeatureTest.php
@@ -4,6 +4,7 @@
 
 namespace Hyde\Framework\Testing\Feature;
 
+use Hyde\Hyde;
 use Hyde\Facades\Features;
 use Hyde\Pages\DocumentationPage;
 use Hyde\Testing\TestCase;
@@ -21,6 +22,8 @@ protected function setUp(): void
 
         $this->mockRoute();
         $this->mockPage();
+
+        Hyde::boot();
     }
 
     public function test_has_darkmode()
diff --git a/packages/framework/tests/Unit/Views/NavigationMenuViewTest.php b/packages/framework/tests/Unit/Views/NavigationMenuViewTest.php
index ba8eb89393f..41f13a493de 100644
--- a/packages/framework/tests/Unit/Views/NavigationMenuViewTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationMenuViewTest.php
@@ -18,6 +18,8 @@ protected function setUp(): void
         parent::setUp();
         $this->mockRoute();
         $this->mockPage();
+
+        Hyde::boot();
     }
 
     protected function render(): string

From 6e9517eec8297cd2c91a8716c8344d55b0958145 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 10 Feb 2024 20:14:59 +0100
Subject: [PATCH 21/24] Revert "Merge branch 'master' into
 refactor-navigation-internals"

This reverts commit 3fbce9430d3e1de56e0800ff03c6aa267eb3be89, reversing
changes made to 6d6951e71f574d9f96bd3fbcd8e396b03dc98e40.
---
 .../deploy-documentation-preview.yml          |  68 ++--
 .github/workflows/hyde-stan.yml               |   1 +
 docs/architecture-concepts/the-hydekernel.md  |   3 +-
 docs/creating-content/documentation-pages.md  |  16 +-
 docs/digging-deeper/advanced-markdown.md      |   2 +-
 docs/digging-deeper/customization.md          | 151 ++++++++-
 docs/digging-deeper/navigation.md             | 319 ------------------
 docs/digging-deeper/updating-hyde.md          |   4 +-
 docs/extensions/extensions.md                 |   1 -
 docs/extensions/ui-kit.md                     |   3 -
 docs/redirects/configuration.md               |  10 -
 11 files changed, 197 insertions(+), 381 deletions(-)
 delete mode 100644 docs/digging-deeper/navigation.md
 delete mode 100644 docs/redirects/configuration.md

diff --git a/.github/workflows/deploy-documentation-preview.yml b/.github/workflows/deploy-documentation-preview.yml
index cb118a7665a..97566040352 100644
--- a/.github/workflows/deploy-documentation-preview.yml
+++ b/.github/workflows/deploy-documentation-preview.yml
@@ -5,21 +5,25 @@ on:
     branches: [ "master" ]
     paths:
       - 'docs/**'
-      - '.github/workflows/deploy-documentation-preview.yml'
 
 jobs:
 
-  build-and-deploy-documentation-preview:
+  build-documentation-preview:
+    # We could add a check to only rerun if docs have changed since last run on the PR
+    # But this would require a state storage, and the current version is good enough.
     if: "! contains(github.event.pull_request.labels.*.name, 'pause-pages')"
 
     environment:
       name: pr-documentation-${{ github.event.pull_request.number }}
-      url: https://ci.hydephp.com/previews/develop/${{ github.event.pull_request.number }}
+      url: https://hydephp.github.io/develop/pr-${{ github.event.pull_request.number }}/dev-docs-preview
 
     runs-on: ubuntu-latest
 
     steps:
       - uses: actions/checkout@v3
+      - uses: shivammathur/setup-php@v2
+        with:
+          php-version: "8.1"
 
       - name: Cache Composer packages
         id: composer-cache
@@ -45,7 +49,7 @@ jobs:
       - name: Update configuration files
         run: |
           echo "output_directories:" >> hyde.yml
-          echo "  Hyde\Pages\DocumentationPage: ''" >> hyde.yml
+          echo "  Hyde\Pages\DocumentationPage: dev-docs-preview" >> hyde.yml
           sed -i "s/'header' => env('SITE_NAME', 'HydePHP').' Docs'/'header' => 'PR #${{ github.event.pull_request.number }} - Docs'/g" config/docs.php
 
       - name: Remove published article component
@@ -83,7 +87,7 @@ jobs:
       - name: Configure environment variables
         run: |
           echo 'SITE_NAME="HydePHP Documentation Preview"' >> .env
-          echo 'SITE_URL="https://ci.hydephp.com/previews/develop/${{ github.event.pull_request.number }}"' >> .env
+          echo 'SITE_URL="https://hydephp.github.io/develop/pr-${{ github.event.pull_request.number }}/dev-docs-preview"' >> .env
 
       - name: Move documentation files
         run: rm -rf _docs && mv -f docs _docs
@@ -91,28 +95,38 @@ jobs:
       - name: Compile the static site
         run: php hyde build
 
-      - name: Package the static site
-        run: zip -r site.zip _site
+      - name: Upload artifacts
+        uses: actions/upload-artifact@v1
+        with:
+          name: 'preview-docs'
+          path: '_site/dev-docs-preview'
+
 
-      - name: Sign the artifact
-        run: |
-          echo '${{ secrets.CI_PREVIEW_SIGNING_RSA_PRIVATE_KEY }}' > private.pem
-          openssl dgst -sha256 -sign private.pem -out signature.bin site.zip
-          unlink private.pem
+  upload-generated-site:
+
+    runs-on: ubuntu-latest
+    needs:
+      - build-documentation-preview
+
+    steps:
+      - uses: actions/checkout@v3
+        with:
+          ref: 'gh-pages'
 
-      - name: Upload the artifact
+      - name: Reset output directories
         run: |
-            repository="develop"
-            bearerToken="${{ secrets.CI_SERVER_TOKEN }}"
-            pullRequest="${{ github.event.pull_request.number }}"
-            signature="$(openssl base64 -in signature.bin)"
-            artifact="site.zip"
-
-            curl -X POST --fail-with-body \
-              -H "Content-Type: multipart/form-data" \
-              -H "Authorization: Bearer $bearerToken" \
-              -F "repository=$repository" \
-              -F "pullRequest=$pullRequest" \
-              -F "artifact=@$artifact" \
-              -F "signature=$signature" \
-              https://ci.hydephp.com/api/deployment-previews
+          rm -rf pr-${{ github.event.pull_request.number }}/dev-docs-preview
+          mkdir -p pr-${{ github.event.pull_request.number }}/dev-docs-preview
+
+      - name: Download documentation artifact
+        uses: actions/download-artifact@v3
+        with:
+          name: preview-docs
+          path: pr-${{ github.event.pull_request.number }}/dev-docs-preview
+
+      - name: Commit changes
+        uses: EndBug/add-and-commit@v9
+        with:
+          pull: 'origin gh-pages'
+          add: 'pr-${{ github.event.pull_request.number }}/dev-docs-preview'
+          message: 'Upload documentation preview for PR ${{ github.event.pull_request.number }}'
diff --git a/.github/workflows/hyde-stan.yml b/.github/workflows/hyde-stan.yml
index 34f4b1bcfda..fcb4b436964 100644
--- a/.github/workflows/hyde-stan.yml
+++ b/.github/workflows/hyde-stan.yml
@@ -21,3 +21,4 @@ jobs:
 
       - name: Run HydeFront linter
         run: php packages/hydefront/.github/scripts/post-build.php
+
diff --git a/docs/architecture-concepts/the-hydekernel.md b/docs/architecture-concepts/the-hydekernel.md
index 55d2c494c2d..0bb6b2d4c63 100644
--- a/docs/architecture-concepts/the-hydekernel.md
+++ b/docs/architecture-concepts/the-hydekernel.md
@@ -26,7 +26,7 @@ The HydeKernel is stored as a singleton in a static property in its own class an
 Commonly, you'll use the `Hyde` facade which forwards calls to the singleton instance.
 You can also use the `hyde()` function to get the Kernel, and call methods on it.
 
-Since the instance is also bound into the Laravel Application Service Container you can also use Dependency Injection by type-hinting the `HydeKernel::class`.
+Since the instance is also bound into the Laravel Application Service Container you can also use Dependency Injection by type-hinting the `HydeKernel::class`. 
 
 Here are some examples of how you can call methods on the Kernel. All methods call the same method on the same instance, so it's just a matter of preference.
 
@@ -43,7 +43,6 @@ hyde()->version();
 
 The Kernel instance is constructed in `bootstrap.php`, and is available globally as `$hyde`.
 
-
 ## The kernel lifecycle
 
 Whenever we talk about the kernel being "booted" we are talking about the kernel's role in the autodiscovery process.
diff --git a/docs/creating-content/documentation-pages.md b/docs/creating-content/documentation-pages.md
index a1ff0967fba..f3ab7ce538a 100644
--- a/docs/creating-content/documentation-pages.md
+++ b/docs/creating-content/documentation-pages.md
@@ -100,8 +100,12 @@ and where the data is from as well as where it can be overridden.
 The sidebar is automatically generated from the files in the `_docs` directory. You will probably want to change the order
 of these items. You can do this in two ways, either in the config or with front matter using the navigation array settings.
 
-Since this feature shares a lot of similarities and implementation details with the navigation menu,
-I recommend you read the [navigation menu documentation](navigation) page as well to learn more about the fundamentals and terminology.
+### Table of contents
+
+Hyde automatically generates a table of contents for the page and adds it to the sidebar.
+
+The behaviour of this can be changed in the configuration file.
+See [the customization page](customization#navigation-menu--sidebar) for more details.
 
 ### Sidebar ordering
 
@@ -133,7 +137,7 @@ Sidebar grouping allows you to group items in the sidebar into categories. This
 The Hyde docs for instance use this.
 
 The feature is enabled automatically when one or more of your documentation pages have the `navigation.group` property set
-in the front matter, or when subdirectories are used. This will then switch to a slightly more compact sidebar layout with pages sorted into categories.
+in the front matter. This will then switch to a slightly more compact sidebar layout with pages sorted into categories.
 Any pages without the group front matter will get put in the "Other" group.
 
 ### Sidebar footer customization
@@ -165,9 +169,7 @@ You can also automatically group your documentation pages by placing source file
 
 For example, putting a Markdown file in `_docs/getting-started/`, is equivalent to adding the same front matter seen above.
 
->info Note that when the [flattened output paths](#using-flattened-output-paths) setting is enabled (which it is by default), the file will still be compiled to the `_site/docs/` directory like it would be if you didn't use the subdirectories. Note that this means that you can't have two documentation pages with the same filename as they overwrite each other.
-
->info Tip: When using subdirectory-based dropdowns, you can set their priority using the directory name as the array key.
+>info Note that when the [flattened output paths](#using-flattened-output-paths) setting is enabled (which it is by default), the file will still be compiled to the `_site/docs/` directory like it would be if you didn't use the subdirectories.
 
 ### Hiding items
 
@@ -250,8 +252,6 @@ Please note that this option is not added to the config file by default, as it's
 
 ### Table of contents settings
 
-Hyde automatically generates a table of contents for the page and adds it to the sidebar.
-
 In the `config/docs.php` file you can configure the behaviour, content, and the look and feel of the sidebar table of contents.
 You can also disable the feature completely.
 
diff --git a/docs/digging-deeper/advanced-markdown.md b/docs/digging-deeper/advanced-markdown.md
index 149b7f53b06..826b6e14920 100644
--- a/docs/digging-deeper/advanced-markdown.md
+++ b/docs/digging-deeper/advanced-markdown.md
@@ -1,7 +1,7 @@
 ---
 navigation:
     label: "Advanced Markdown"
-    priority: 27
+    priority: 26
 ---
 
 # Advanced Markdown
diff --git a/docs/digging-deeper/customization.md b/docs/digging-deeper/customization.md
index a1282434c58..f797b6e9be3 100644
--- a/docs/digging-deeper/customization.md
+++ b/docs/digging-deeper/customization.md
@@ -212,7 +212,7 @@ Still, you will likely want to customize some parts of these menus, and thankful
 - To customize the navigation menu, use the setting `navigation.order` in the `hyde.php` config.
 - When customizing the navigation menu, you should use the [route key](core-concepts#route-keys) of the page.
 
-Learn more in the [Navigation Menu](navigation) documentation.
+Learn more in the [Navigation Menu](navigation-menus) documentation.
 
 #### Customizing the documentation sidebar
 
@@ -221,15 +221,156 @@ Learn more in the [Navigation Menu](navigation) documentation.
 
 Learn more in the [Documentation Pages](documentation-pages) documentation.
 
+>info Tip: When using subdirectory-based dropdowns, you can set their priority using the directory name as the array key.
+
+### Primer on priorities
+
+All navigation menu items have an internal priority value that determines its order in the navigation.
+Lower values means that the item will be higher up in the menu. The default for pages is `999` which puts them last.
+However, some pages are autoconfigured to have a lower priority, for example, the `index` page defaults to a priority of `0`,
+
+#### Basic syntax for changing the priorities
+
+The cleanest way is to use the list-style syntax where each item will get the priority calculated according to its position in the list, plus an offset of `500`.
+The offset is added to make it easier to place pages earlier in the list using front matter or with explicit priority settings.
+
+```php
+[
+    'readme', // Gets priority 500
+    'installation', // Gets priority 501
+    'getting-started', // Gets priority 502
+]
+```
+
+#### Explicit syntax for changing the priorities
+
+You can also specify explicit priorities by adding a value to the array key:
+
+```php
+[
+    'readme' => 10, // Gets priority 10
+    'installation' => 15, // Gets priority 15
+    'getting-started' => 20, // Gets priority 20
+]
+```
+
+You can also combine these options if you want:
+
+```php
+[
+    'readme' => 10, // Gets priority 10
+    'installation', // Gets priority 500
+    'getting-started', // Gets priority 501
+]
+```
+
+You can also set the priority of a page directly in the front matter. This will override any dynamically inferred or
+config defined priority. While this is useful for one-offs, it can make it harder to reorder items later on.
+It's up to you which method you prefer to use. This setting can be used both for the navigation menu and the sidebar.
+
+```markdown
+---
+navigation:
+    priority: 25
+---
+```
+
+#### Changing the menu item labels
+
+Hyde makes a few attempts to find a suitable label for the navigation menu items to automatically create helpful titles.
+You can override the label using the `navigation.label` front matter property.
+
+From the Hyde config you can also override the label of navigation links using the by mapping the route key
+to the desired title. Note that the front matter property will take precedence over the config property.
+
+```php
+// filepath config/hyde.php
+'navigation' => [
+    'labels' => [
+        'index' => 'Start',
+        'docs/index' => 'Documentation',
+    ]
+]
+```
+
+#### Excluding Items (Blacklist)
+
+Sometimes, especially if you have a lot of pages, you may want to prevent links from showing up in the main navigation menu.
+To remove items from being automatically added, simply add the page's route key to the blacklist.
+As you can see, the `404` page has already been filled in for you.
+
+```php
+// filepath config/hyde.php
+'navigation' => [
+    'exclude' => [
+        '404'
+    ]
+]
+```
+
+You can also specify that a page should be excluded by setting the page front matter.
+
+```markdown
+---
+navigation:
+    hidden: true
+---
+
+#### Adding Custom Navigation Menu Links
+
+You can easily add custom navigation menu links similar how we add Authors. Simply add a `NavItem` model to the `navigation.custom` array.
+
+When linking to an external site, you should use the `NavItem::forLink()` method facade. The first two arguments are the
+destination and label, both required. Third argument is the priority, which is optional, and defaults to 500.
+
+```php
+// filepath config/hyde.php
+use Hyde\Framework\Features\Navigation\NavItem;
+
+'navigation' => [
+    'custom' => [
+        NavItem::forLink('https://github.com/hydephp/hyde', 'GitHub', 200),
+    ]
+]
+```
+
+Simplified, this will then be rendered as follows:
+
+```html
+<a href="https://github.com/hydephp/hyde">GitHub</a>
+```
+
+#### Automatic navigation menu dropdowns
+
+HydePHP has a neat feature to automatically place pages in dropdowns based on subdirectories.
+
+For pages that can be in the main site menu, ths feature needs to be enabled in the `hyde.php` config file.
+
+```php
+// filepath config/hyde.php
+
+'navigation' => [
+    'subdirectories' => 'dropdown',
+],
+```
+
+Now if you create a page called `_pages/about/contact.md` it will automatically be placed in a dropdown called "About".
+
+#### Automatic documentation sidebar grouping
+
+This feature works similarly to the automatic navigation menu dropdowns, but instead place the sidebar items in named groups.
+This feature is enabled by default, so you only need to place your pages in subdirectories to have them grouped.
+
+For example: `_docs/getting-started/installation.md` will be placed in a group called "Getting Started".
 
 ## Additional Advanced Options
 
-The following configuration options in the `confg/hyde.php` file are intended for advanced users and
+The following configuration options in the `confg/hyde.php` file are intended for advanced users and 
 should only be modified if you fully understand their impact. The code examples show the default values.
 
 ### `media_extensions`
 
-This option allows you to specify file extensions considered as media files, which will be copied to the output directory.
+This option allows you to specify file extensions considered as media files, which will be copied to the output directory. 
 To add more extensions, either append them to the existing array or override the entire array.
 
 ```php
@@ -282,7 +423,6 @@ use \Hyde\Framework\Services\AssetService;
 'hydefront_cdn_url' => AssetService::HYDEFRONT_CDN_URL,
 ```
 
-
 ## Blade Views
 
 Hyde uses the Laravel Blade templating engine. Most parts of the included templates have been extracted into components to be customized easily.
@@ -296,14 +436,12 @@ php hyde publish:views
 
 The files will then be available in the `resources/views/vendor/hyde` directory.
 
-
 ## Frontend Styles
 
 Hyde is designed to not only serve as a framework but a whole starter kit and comes with a Tailwind starter template
 for you to get up and running quickly. If you want to customize these, you are free to do so.
 Please see the [Managing Assets](managing-assets) page to learn more.
 
-
 ## Markdown Configuration
 
 Hyde uses [League CommonMark](https://commonmark.thephpleague.com/) for converting Markdown into HTML, and
@@ -366,7 +504,6 @@ arbitrary PHP code specified in Markdown to be executed. It's easy to enable how
 
 See the [Blade in Markdown](advanced-markdown#blade-support) documentation for more information on how to use this feature.
 
-
 ## YAML Configuration
 
 The settings in the `config/hyde.php` file can also be set by using a `hyde.yml` file in the root of your project directory.
diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
deleted file mode 100644
index 051ca1661e7..00000000000
--- a/docs/digging-deeper/navigation.md
+++ /dev/null
@@ -1,319 +0,0 @@
----
-navigation:
-    label: "Navigation Menus"
-    priority: 26
----
-
-# Navigation Menus
-
-## Introduction
-
-A great time-saving feature of HydePHP is the automatic navigation menu and documentation sidebar generation.
-Hyde is designed to automatically configure these menus for you based on the content you have in your project.
-
-There are two types of navigation menus in Hyde:
-
-- **Primary Navigation Menu**: This is the main navigation menu that appears on most pages of your site.
-- **Documentation Sidebar**: This is a sidebar that appears on documentation pages and contains links to other documentation pages.
-
-HydePHP automatically generates all of these menus for you based on the content of your project,
-and does its best to automatically configure them in the way that you most likely want them to be.
-
-Of course, this won't always be perfect, so thankfully Hyde makes it a breeze to customize these menus to your liking.
-Keep on reading to learn how! To learn even more about the sidebars, visit the [Documentation Pages](documentation-pages) documentation.
-
-### Quick primer on the internals
-
-It may be beneficial to understand the internal workings of the navigation menus to take full advantage of the options.
-
-In short, both navigation menu types extend the same class (meaning they share the same base code), this means that the way
-they are configured is very similar, making the documentation here applicable to both types of menus.
-
-See the [Digging Deeper](#digging-deeper-into-the-internals) section of this page if you want the full scoop on the internals!
-
-### Primer on priorities
-
-All navigation menu items have an internal priority value that determines their order in the navigation.
-Lower values mean that the item will be higher up in the menu. The default for pages is `999` which puts them last.
-However, some pages are autoconfigured to have a lower priority, for example, the `index` page defaults to a priority of `0`,
-
-### What to customize?
-
-Here is a quick overview of what you might want to customize in your navigation menus:
-
-- Navigation menu item labels - the text that appears in the menu links
-- Navigation menu item priority - control the order in which the links appear
-- Navigation menu item visibility - control if pages may show up in the menus
-- Navigation menu item grouping - group pages together in dropdowns
-
-### How and where to customize?
-
-Hyde provides a few different ways to customize the navigation menus, depending on what you prefer.
-
-Specifying the data in the front matter will override any dynamically inferred or config-defined priority.
-While this is useful for one-offs, it can make it harder to reorder items later on as you can't see the whole picture at once.
-It's up to you which method you prefer to use.
-
-To customize how a page is represented in navigation, you can either set the `navigation` front matter data in the page's markdown file,
-or configure it in the config file. Main navigation items are in the `hyde` config file, while documentation sidebar items are in the `docs` config file.
-General options for the entire navigation menus are also available in the `hyde` and `docs` config files.
-
-Now that you know the basics, let's dive into the details of how to customize the navigation menus!
-
-
-## Front matter configuration
-
-The front matter options allow you to customize the navigation menus on a per-page basis.
-Here is a quick reference of the available options. The full documentation of each option is below.
-You don't need to specify all the keys, only the ones you want to customize.
-
-```yaml
-navigation:
-    label: string  # The text to display
-    priority: int  # Order is also supported
-    hidden: bool   # Visible is also supported (but obviously invert the value)
-    group: string  # Category is also supported
-```
-
-### `label`
-
-The `label` option allows you to customize the text that appears in the navigation menu for the page.
-
-```yaml
-navigation:
-    label: "My Custom Label"
-```
-
-### `priority`
-
-The `priority` option allows you to control the order in which the page appears in the navigation menu. You can also use `order` instead of `priority`.
-
-```yaml
-navigation:
-    priority: 10
-```
-
-### `hidden`
-
-The `hidden` option allows you to control if the page appears in the navigation menu. You can also use `visible` instead of `hidden`, but obviously invert the value.
-
-```yaml
-navigation:
-    hidden: true
-```
-
-### `group`
-
-The `group` option has a slightly different meaning depending on the type of navigation menu.
-For the primary navigation menu, it allows you to group pages together in dropdowns.
-For the sidebar, it allows you to group pages together in the sidebar under a common heading.
-You can also use `category` instead of `group`.
-
-```yaml
-navigation:
-    group: "My Group"
-```
-
-
-## Config file configuration
-
-Next up, let's look at how to customize the navigation menus using the config files.
-
-- To customize the navigation menu, use the setting `navigation.order` in the `hyde.php` config.
-- When customizing the navigation menu, you should use the [route key](core-concepts#route-keys) of the page.
-
-- To customize the sidebar, use the setting `sidebar_order` in the `docs.php` config.
-- When customizing the sidebar, can use the route key, or just the [page identifier](core-concepts#page-identifiers) of the page.
-
-### Changing the priorities
-
-The `navigation.order` and `sidebar_order` settings allow you to customize the order of the pages in the navigation menus.
-
-#### Basic syntax for changing the priorities
-
-The cleanest way is to use the list-style syntax where each item will get the priority calculated according to its position in the list, plus an offset of `500`.
-The offset is added to make it easier to place pages earlier in the list using front matter or with explicit priority settings.
-
-```php
-// filepath: config/hyde.php
-
-'navigation' => [
-    'order' => [
-        'home', // Gets priority 500
-        'about', // Gets priority 501
-        'contact', // Gets priority 502
-    ]
-]
-```
-
-```php
-// filepath: config/docs.php
-
-'sidebar_order' => [
-    'readme', // Gets priority 500
-    'installation', // Gets priority 501
-    'getting-started', // Gets priority 502
-]
-```
-
-#### Explicit syntax for changing the priorities
-
-You can also specify explicit priorities by adding a value to the array key:
-
-```php
-// filepath: config/hyde.php
-
-'navigation' => [
-    'order' => [
-        'home' => 10, // Gets priority 10
-        'about' => 15, // Gets priority 15
-        'contact' => 20, // Gets priority 20
-    ]
-]
-```
-
-```php
-// filepath: config/docs.php
-
-'sidebar_order' => [
-    'readme' => 10, // Gets priority 10
-    'installation' => 15, // Gets priority 15
-    'getting-started' => 20, // Gets priority 20
-]
-```
-
-**You can of course also combine these methods if you want:**
-
-```php
-// filepath: Applicable to both
-[
-    'readme' => 10, // Gets priority 10
-    'installation', // Gets priority 500
-    'getting-started', // Gets priority 501
-]
-```
-
-### Changing the menu item labels
-
-Hyde makes a few attempts to find a suitable label for the navigation menu items to automatically create helpful titles.
-
-From the Hyde config you can override the label of navigation links using the by mapping the route key to the desired title.
-This is not yet supported for the sidebar, but will be in the future.
-
-```php
-// filepath config/hyde.php
-'navigation' => [
-    'labels' => [
-        'index' => 'Start',
-        'docs/index' => 'Documentation',
-    ]
-]
-```
-
-### Excluding Items (Blacklist)
-
-Sometimes, especially if you have a lot of pages, you may want to prevent links from showing up in the main navigation menu.
-To remove items from being automatically added, simply add the page's route key to the blacklist.
-
-```php
-// filepath config/hyde.php
-'navigation' => [
-    'exclude' => [
-        '404'
-    ]
-]
-```
-
-### Adding Custom Navigation Menu Links
-
-You can easily add custom navigation menu links similar to how we add Authors. Simply add a `NavItem` model to the `navigation.custom` array.
-
-When linking to an external site, you should use the `NavItem::forLink()` method facade. The first two arguments are the
-destination and label, both required. The third argument is the priority, which is optional, and defaults to `500`.
-
-```php
-// filepath config/hyde.php
-use Hyde\Framework\Features\Navigation\NavItem;
-
-'navigation' => [
-    'custom' => [
-        NavItem::forLink('https://github.com/hydephp/hyde', 'GitHub', 200),
-    ]
-]
-```
-
-Simplified, this will then be rendered as follows:
-
-```html
-<a href="https://github.com/hydephp/hyde">GitHub</a>
-```
-
-### Configure subdirectory handling
-
-Within the Hyde config you can configure how subdirectories should be displayed in the menu.
-
-```php
-// filepath config/hyde.php
-'navigation' => [
-    'subdirectories' => 'dropdown'
-]
-```
-
-Dropdown means that pages in subdirectories will be displayed in a dropdown menu,
-while `flat` means that pages in subdirectories will be displayed as individual items in the menu.
-Hidden means that pages in subdirectories will not be displayed in the menu at all.
-
-### Automatic menu groups
-
-HydePHP has a neat feature to automatically place pages in dropdowns based on subdirectories.
-
-#### Automatic navigation menu dropdowns
-
-For pages that can be in the main site menu, this feature needs to be enabled in the `hyde.php` config file.
-
-```php
-// filepath config/hyde.php
-
-'navigation' => [
-    'subdirectories' => 'dropdown',
-],
-```
-
-Now if you create a page called `_pages/about/contact.md` it will automatically be placed in a dropdown called "About".
-
-#### Automatic documentation sidebar grouping
-
-This feature works similarly to the automatic navigation menu dropdowns, but instead places the sidebar items in named groups.
-This feature is enabled by default, so you only need to place your pages in subdirectories to have them grouped.
-
-For example: `_docs/getting-started/installation.md` will be placed in a group called "Getting Started".
-
->info Tip: When using subdirectory-based dropdowns, you can set their priority using the directory name as the array key.
-
-
-## Digging deeper into the internals
-
-While not required to know, you may find it interesting to learn more about how the navigation is handled internally.
-The best way to learn about this is to look at the source code, so here is a high-level overview with details on where to look in the source code.
-
-The main navigation menu is the `NavigationMenu` class, and the documentation sidebar is the `DocumentationSidebar` class.
-Both extend the same `BaseNavigationMenu` class:
-
-```php
-use Hyde\Framework\Features\Navigation\NavigationMenu;
-use Hyde\Framework\Features\Navigation\DocumentationSidebar;
-use Hyde\Framework\Features\Navigation\BaseNavigationMenu;
-```
-
-Within the `BaseNavigationMenu` class, you will find the main logic for how the menus are generated,
-while the child implementations contain the extra logic tailored for their specific use cases.
-
-All the navigation menus store the menu items in their `$items` array containing instances of the `NavItem` class.
-
-The `NavItem` class is a simple class that contains the label and URL of the menu item and is used to represent each item in the menu.
-Dropdowns are represented by `DropdownNavItem` instances, which extend the `NavItem` class and contain an array of additional `NavItem` instances.
-
-```php
-use Hyde\Framework\Features\Navigation\NavItem;
-use Hyde\Framework\Features\Navigation\DropdownNavItem;
-```
diff --git a/docs/digging-deeper/updating-hyde.md b/docs/digging-deeper/updating-hyde.md
index f12d23790a4..0acb3d6ce11 100644
--- a/docs/digging-deeper/updating-hyde.md
+++ b/docs/digging-deeper/updating-hyde.md
@@ -13,7 +13,6 @@ This guide will help you update your HydePHP project to the latest version.
 When updating an existing installation, first ensure that you have a backup of your project in case anything goes wrong.
 The recommended way to do this is to use Git as that allows you to smoothly roll back any changes.
 
-
 ## Version compatibility
 
 HydePHP follows [semantic versioning](https://semver.org/), so you can expect that minor and patch releases will be backwards compatible.
@@ -28,12 +27,11 @@ hence why version controlling your site is helpful when updating versions as you
 be helpful to version control the compiled HTML, so you can view a diff of the changes. Be sure to test that your site
 can be built and that it looks as expected after updating before deploying the changes to your live site.
 
-We of course have extensive tests in place run on each single code commit to ensure all code is functional, however,
+We of course have extensive tests in place run on each single code commit to ensure all code is functional, however, 
 it is still possible that some edge cases slip through. This means that a bug fix may impact an edge case that you depend on.
 
 Obligatory related XKCD: [https://xkcd.com/1172](https://xkcd.com/1172)
 
-
 ## Methods
 
 ### Which method?
diff --git a/docs/extensions/extensions.md b/docs/extensions/extensions.md
index db3095658b6..28bf3100648 100644
--- a/docs/extensions/extensions.md
+++ b/docs/extensions/extensions.md
@@ -29,7 +29,6 @@ The [HydePHP UI Kit](https://github.com/hydephp/ui-kit) is a set of minimalistic
 The [GitHub Action for HydePHP](https://github.com/hydephp/action) is hands-down the easiest way to build and deploy your Hyde site to GitHub Pages.
 - Learn more at https://github.com/hydephp/action and see the documentation at https://hydephp.github.io/action
 
-
 ## Integrations with third-party tools
 
 ### Torchlight
diff --git a/docs/extensions/ui-kit.md b/docs/extensions/ui-kit.md
index 84ebe97d178..b632c0719cc 100644
--- a/docs/extensions/ui-kit.md
+++ b/docs/extensions/ui-kit.md
@@ -4,14 +4,12 @@ The HydePHP UI Kit is a collection of minimalistic and un-opinionated TailwindCS
 indented to be used with HydePHP. Note that these components may require CSS classes not present in the bundled app.css
 file and that you may need to recompile the CSS file using the included Laravel Mix configuration.
 
-
 ## Screenshot
 
 Here are some of the components you can use to build your next project! As you can see, all components support both light and dark mode out of the box, just like the rest of HydePHP.
 
 ![Components Screenshot](https://raw.githubusercontent.com/hydephp/ui-kit/art/header-large-min.png)
 
-
 ## Components
 
 Please make sure you're familiar with [Laravel Blade](https://laravel.com/docs/blade) before using the HydePHP UI Kit.
@@ -161,7 +159,6 @@ You can get surprisingly far when you combine the components. Take this newslett
 
 ![Newsletter Screenshot](https://raw.githubusercontent.com/hydephp/ui-kit/art/newsletter-signup-example-min.png)
 
-
 ## GitHub Repository
 
 You can find the source code for the UI Kit on GitHub at [hydephp/ui-kit](https://github.com/hydephp/ui-kit).
diff --git a/docs/redirects/configuration.md b/docs/redirects/configuration.md
deleted file mode 100644
index 10f2c14af44..00000000000
--- a/docs/redirects/configuration.md
+++ /dev/null
@@ -1,10 +0,0 @@
----
-navigation:
-    hidden: true
----
-
-<meta http-equiv="refresh" content="0;url=customization" />
-
-Redirecting you to [customization](customization)
-
-<!-- Note to self, if we need a lot of these in the future it may make more sense to put them in a CI that loads redirects from a config -->

From 5aade5fed59e6ae0c722d7d494e85aa0cea81dbf Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 10 Feb 2024 20:17:49 +0100
Subject: [PATCH 22/24] Format Markdown

---
 .github/workflows/hyde-stan.yml              | 1 -
 docs/architecture-concepts/the-hydekernel.md | 3 ++-
 docs/digging-deeper/customization.md         | 4 ++--
 docs/digging-deeper/updating-hyde.md         | 4 +++-
 docs/extensions/extensions.md                | 1 +
 docs/extensions/ui-kit.md                    | 3 +++
 6 files changed, 11 insertions(+), 5 deletions(-)

diff --git a/.github/workflows/hyde-stan.yml b/.github/workflows/hyde-stan.yml
index fcb4b436964..34f4b1bcfda 100644
--- a/.github/workflows/hyde-stan.yml
+++ b/.github/workflows/hyde-stan.yml
@@ -21,4 +21,3 @@ jobs:
 
       - name: Run HydeFront linter
         run: php packages/hydefront/.github/scripts/post-build.php
-
diff --git a/docs/architecture-concepts/the-hydekernel.md b/docs/architecture-concepts/the-hydekernel.md
index 0bb6b2d4c63..55d2c494c2d 100644
--- a/docs/architecture-concepts/the-hydekernel.md
+++ b/docs/architecture-concepts/the-hydekernel.md
@@ -26,7 +26,7 @@ The HydeKernel is stored as a singleton in a static property in its own class an
 Commonly, you'll use the `Hyde` facade which forwards calls to the singleton instance.
 You can also use the `hyde()` function to get the Kernel, and call methods on it.
 
-Since the instance is also bound into the Laravel Application Service Container you can also use Dependency Injection by type-hinting the `HydeKernel::class`. 
+Since the instance is also bound into the Laravel Application Service Container you can also use Dependency Injection by type-hinting the `HydeKernel::class`.
 
 Here are some examples of how you can call methods on the Kernel. All methods call the same method on the same instance, so it's just a matter of preference.
 
@@ -43,6 +43,7 @@ hyde()->version();
 
 The Kernel instance is constructed in `bootstrap.php`, and is available globally as `$hyde`.
 
+
 ## The kernel lifecycle
 
 Whenever we talk about the kernel being "booted" we are talking about the kernel's role in the autodiscovery process.
diff --git a/docs/digging-deeper/customization.md b/docs/digging-deeper/customization.md
index f797b6e9be3..bb6a8e07a24 100644
--- a/docs/digging-deeper/customization.md
+++ b/docs/digging-deeper/customization.md
@@ -365,12 +365,12 @@ For example: `_docs/getting-started/installation.md` will be placed in a group c
 
 ## Additional Advanced Options
 
-The following configuration options in the `confg/hyde.php` file are intended for advanced users and 
+The following configuration options in the `confg/hyde.php` file are intended for advanced users and
 should only be modified if you fully understand their impact. The code examples show the default values.
 
 ### `media_extensions`
 
-This option allows you to specify file extensions considered as media files, which will be copied to the output directory. 
+This option allows you to specify file extensions considered as media files, which will be copied to the output directory.
 To add more extensions, either append them to the existing array or override the entire array.
 
 ```php
diff --git a/docs/digging-deeper/updating-hyde.md b/docs/digging-deeper/updating-hyde.md
index 0acb3d6ce11..f12d23790a4 100644
--- a/docs/digging-deeper/updating-hyde.md
+++ b/docs/digging-deeper/updating-hyde.md
@@ -13,6 +13,7 @@ This guide will help you update your HydePHP project to the latest version.
 When updating an existing installation, first ensure that you have a backup of your project in case anything goes wrong.
 The recommended way to do this is to use Git as that allows you to smoothly roll back any changes.
 
+
 ## Version compatibility
 
 HydePHP follows [semantic versioning](https://semver.org/), so you can expect that minor and patch releases will be backwards compatible.
@@ -27,11 +28,12 @@ hence why version controlling your site is helpful when updating versions as you
 be helpful to version control the compiled HTML, so you can view a diff of the changes. Be sure to test that your site
 can be built and that it looks as expected after updating before deploying the changes to your live site.
 
-We of course have extensive tests in place run on each single code commit to ensure all code is functional, however, 
+We of course have extensive tests in place run on each single code commit to ensure all code is functional, however,
 it is still possible that some edge cases slip through. This means that a bug fix may impact an edge case that you depend on.
 
 Obligatory related XKCD: [https://xkcd.com/1172](https://xkcd.com/1172)
 
+
 ## Methods
 
 ### Which method?
diff --git a/docs/extensions/extensions.md b/docs/extensions/extensions.md
index 28bf3100648..db3095658b6 100644
--- a/docs/extensions/extensions.md
+++ b/docs/extensions/extensions.md
@@ -29,6 +29,7 @@ The [HydePHP UI Kit](https://github.com/hydephp/ui-kit) is a set of minimalistic
 The [GitHub Action for HydePHP](https://github.com/hydephp/action) is hands-down the easiest way to build and deploy your Hyde site to GitHub Pages.
 - Learn more at https://github.com/hydephp/action and see the documentation at https://hydephp.github.io/action
 
+
 ## Integrations with third-party tools
 
 ### Torchlight
diff --git a/docs/extensions/ui-kit.md b/docs/extensions/ui-kit.md
index b632c0719cc..84ebe97d178 100644
--- a/docs/extensions/ui-kit.md
+++ b/docs/extensions/ui-kit.md
@@ -4,12 +4,14 @@ The HydePHP UI Kit is a collection of minimalistic and un-opinionated TailwindCS
 indented to be used with HydePHP. Note that these components may require CSS classes not present in the bundled app.css
 file and that you may need to recompile the CSS file using the included Laravel Mix configuration.
 
+
 ## Screenshot
 
 Here are some of the components you can use to build your next project! As you can see, all components support both light and dark mode out of the box, just like the rest of HydePHP.
 
 ![Components Screenshot](https://raw.githubusercontent.com/hydephp/ui-kit/art/header-large-min.png)
 
+
 ## Components
 
 Please make sure you're familiar with [Laravel Blade](https://laravel.com/docs/blade) before using the HydePHP UI Kit.
@@ -159,6 +161,7 @@ You can get surprisingly far when you combine the components. Take this newslett
 
 ![Newsletter Screenshot](https://raw.githubusercontent.com/hydephp/ui-kit/art/newsletter-signup-example-min.png)
 
+
 ## GitHub Repository
 
 You can find the source code for the UI Kit on GitHub at [hydephp/ui-kit](https://github.com/hydephp/ui-kit).

From 2ae3ad6ba541afcc5a8ed69c08a329a427b5ebf7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 13 Feb 2024 14:40:15 +0100
Subject: [PATCH 23/24] wip

---
 .../Navigation/BaseNavigationMenu.php         | 17 +++++++++++++-
 .../tests/Feature/NavigationMenuTest.php      | 22 +++++++++++++++++++
 2 files changed, 38 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/BaseNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/BaseNavigationMenu.php
index d802662c974..0b1299df486 100644
--- a/packages/framework/src/Framework/Features/Navigation/BaseNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/BaseNavigationMenu.php
@@ -36,7 +36,7 @@ protected function generate(): void
     {
         Routes::each(function (Route $route): void {
             if ($this->canAddRoute($route)) {
-                $this->items->put($route->getRouteKey(), NavItem::fromRoute($route));
+                $this->addRoute($route);
             }
         });
 
@@ -69,4 +69,19 @@ public function getItems(): Collection
     {
         return $this->items;
     }
+
+    /**
+     * Add a route to the navigation menu.
+     *
+     * If you are calling this method manually, you must do so after the kernel has booted.
+     *
+     * @param \Hyde\Support\Models\Route $route
+     * @return $this
+     */
+    public function addRoute(Route $route): static
+    {
+        $this->items->put($route->getRouteKey(), NavItem::fromRoute($route));
+
+        return $this;
+    }
 }
diff --git a/packages/framework/tests/Feature/NavigationMenuTest.php b/packages/framework/tests/Feature/NavigationMenuTest.php
index a6c2a18501b..e9fba4b1c51 100644
--- a/packages/framework/tests/Feature/NavigationMenuTest.php
+++ b/packages/framework/tests/Feature/NavigationMenuTest.php
@@ -4,6 +4,7 @@
 
 namespace Hyde\Framework\Testing\Feature;
 
+use Hyde\Hyde;
 use BadMethodCallException;
 use Hyde\Support\Models\Route;
 
@@ -387,4 +388,25 @@ public function testDropdownMenuItemsAreSortedByPriority()
 
         $this->assertSame(['Foo', 'Bar', 'Baz'], $dropdowns[0]->getItems()->pluck('label')->toArray());
     }
+
+    public function test_can_add_route_to_navigation_menu()
+    {
+        $route = new Route(new MarkdownPage('foo'));
+        $menu = NavigationMenu::create();
+
+        $menu->addRoute($route);
+
+        $this->assertCount(2, $menu->items);
+    }
+
+    public function test_can_add_route_kernel_navigation_menu()
+    {
+        $menu = Hyde::navigation();
+        $route = new Route(new MarkdownPage('foo'));
+
+        $menu->addRoute($route);
+
+        $this->assertCount(2, $menu->items);
+        $this->assertSame($menu->items, Hyde::navigation()->items);
+    }
 }

From ad5aa9b142f7e3a00429516b6d30ff4f83f6bbee Mon Sep 17 00:00:00 2001
From: StyleCI Bot <bot@styleci.io>
Date: Tue, 13 Feb 2024 14:25:43 +0000
Subject: [PATCH 24/24] Apply fixes from StyleCI

---
 .../src/Framework/Features/Navigation/BaseNavigationMenu.php    | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/BaseNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/BaseNavigationMenu.php
index 0b1299df486..bcdc0836afd 100644
--- a/packages/framework/src/Framework/Features/Navigation/BaseNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/BaseNavigationMenu.php
@@ -75,7 +75,7 @@ public function getItems(): Collection
      *
      * If you are calling this method manually, you must do so after the kernel has booted.
      *
-     * @param \Hyde\Support\Models\Route $route
+     * @param  \Hyde\Support\Models\Route  $route
      * @return $this
      */
     public function addRoute(Route $route): static