From ab9308cf82d4d2b83f6f802e4eceec5688144f1c Mon Sep 17 00:00:00 2001
From: Lucian Behind The Scenes <silviulucian@gmail.com>
Date: Thu, 19 Feb 2026 16:24:23 +0200
Subject: [PATCH 1/8] feat: refactor cheat sheet to Livewire with grouped
 sections

Convert the cheat sheet from a closure route to a full Livewire
component with cached data. Group commands into semantic sections
(Server & Site Operations, Data Services, Cloud Providers, etc.)
for better discoverability.

Extract shared header and footer into reusable Blade components,
replace target="_blank" with wire:navigate on the TOC cheat sheet
link, improve code block styling, and add codex to boost config.
---
 app/Livewire/CheatSheet.php                   | 102 +++++++++
 app/Services/CommandCheatSheetService.php     | 206 +++++++++++-------
 boost.json                                    |   6 +-
 config/docs.php                               |   1 +
 resources/css/app.css                         |   4 +-
 resources/css/highlight.css                   |   2 +-
 resources/views/cheat-sheet.blade.php         | 153 +++++--------
 .../views/components/docs/footer.blade.php    |  31 +++
 .../views/components/docs/header.blade.php    |  29 +++
 resources/views/components/docs/toc.blade.php |   2 +-
 .../components/layouts/cheat-sheet.blade.php  |  22 ++
 .../views/components/layouts/docs.blade.php   |  62 +-----
 .../views/livewire/cheat-sheet.blade.php      |  71 ++++++
 routes/web.php                                |  14 +-
 tests/Feature/CheatSheetPageTest.php          |  35 +++
 tests/Feature/DocsSidebarNavigationTest.php   |   7 +
 16 files changed, 496 insertions(+), 251 deletions(-)
 create mode 100644 app/Livewire/CheatSheet.php
 create mode 100644 resources/views/components/docs/footer.blade.php
 create mode 100644 resources/views/components/docs/header.blade.php
 create mode 100644 resources/views/components/layouts/cheat-sheet.blade.php
 create mode 100644 resources/views/livewire/cheat-sheet.blade.php

diff --git a/app/Livewire/CheatSheet.php b/app/Livewire/CheatSheet.php
new file mode 100644
index 0000000..abd2a0a
--- /dev/null
+++ b/app/Livewire/CheatSheet.php
@@ -0,0 +1,102 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Livewire;
+
+use App\Services\CommandCheatSheetService;
+use Illuminate\Contracts\View\View;
+use Illuminate\Support\Facades\Cache;
+use Livewire\Attributes\Layout;
+use Livewire\Component;
+
+#[Layout('components.layouts.cheat-sheet')]
+final class CheatSheet extends Component
+{
+    /**
+     * @var array<int, array{
+     *     name: string,
+     *     count: int,
+     *     namespaceCount: int,
+     *     groups: array<int, array{
+     *         name: string,
+     *         count: int,
+     *         commands: array<int, array{
+     *             primary: string,
+     *             aliases: array<int, string>,
+     *             description: string
+     *         }>
+     *     }>
+     * }>
+     */
+    public array $sections = [];
+
+    /**
+     * @var array<int, array{
+     *     name: string,
+     *     count: int,
+     *     commands: array<int, array{
+     *         primary: string,
+     *         aliases: array<int, string>,
+     *         description: string
+     *     }>
+     * }>
+     */
+    public array $groups = [];
+
+    public int $commandCount = 0;
+
+    public int $aliasCount = 0;
+
+    public function mount(CommandCheatSheetService $sheet): void
+    {
+        $cacheTtlSeconds = (int) config('docs.cheat_sheet.cache_ttl_seconds', 300);
+        $cacheEnabled = ! app()->isLocal() && $cacheTtlSeconds > 0;
+
+        /** @var array{
+         *     sections: array<int, array{
+         *         name: string,
+         *         count: int,
+         *         namespaceCount: int,
+         *         groups: array<int, array{
+         *             name: string,
+         *             count: int,
+         *             commands: array<int, array{
+         *                 primary: string,
+         *                 aliases: array<int, string>,
+         *                 description: string
+         *             }>
+         *         }>
+         *     }>,
+         *     groups: array<int, array{
+         *         name: string,
+         *         count: int,
+         *         commands: array<int, array{
+         *             primary: string,
+         *             aliases: array<int, string>,
+         *             description: string
+         *         }>
+         *     }>,
+         *     commandCount: int,
+         *     aliasCount: int
+         * } $cheatSheet
+         */
+        $cheatSheet = $cacheEnabled
+            ? Cache::remember(
+                'cheat_sheet:v2',
+                now()->addSeconds($cacheTtlSeconds),
+                fn (): array => $sheet->build(),
+            )
+            : $sheet->build();
+
+        $this->sections = $cheatSheet['sections'];
+        $this->groups = $cheatSheet['groups'];
+        $this->commandCount = $cheatSheet['commandCount'];
+        $this->aliasCount = $cheatSheet['aliasCount'];
+    }
+
+    public function render(): View
+    {
+        return view('livewire.cheat-sheet');
+    }
+}
diff --git a/app/Services/CommandCheatSheetService.php b/app/Services/CommandCheatSheetService.php
index 5456cc4..af98b83 100644
--- a/app/Services/CommandCheatSheetService.php
+++ b/app/Services/CommandCheatSheetService.php
@@ -15,14 +15,27 @@ public function __construct(
 
     /**
      * @return array{
+     *     sections: array<int, array{
+     *         name: string,
+     *         count: int,
+     *         namespaceCount: int,
+     *         groups: array<int, array{
+     *             name: string,
+     *             count: int,
+     *             commands: array<int, array{
+     *                 primary: string,
+     *                 aliases: array<int, string>,
+     *                 description: string
+     *             }>
+     *         }>
+     *     }>,
      *     groups: array<int, array{
      *         name: string,
      *         count: int,
      *         commands: array<int, array{
      *             primary: string,
      *             aliases: array<int, string>,
-     *             description: string,
-     *             links: array<int, array{page: string, anchor: string}>
+     *             description: string
      *         }>
      *     }>,
      *     commandCount: int,
@@ -32,17 +45,15 @@ public function __construct(
     public function build(): array
     {
         $commands = $this->discoverCommands();
-        $links = $this->resolveCommandLinks();
         $groups = [];
         $aliasCount = 0;
 
         foreach ($commands as $command) {
-            $command['links'] = $links[$command['primary']] ?? [];
             $namespace = $this->extractNamespace($command['primary']);
 
             if (! array_key_exists($namespace, $groups)) {
                 $groups[$namespace] = [
-                    'name' => ucfirst($namespace),
+                    'name' => $this->formatNamespaceName($namespace),
                     'count' => 0,
                     'commands' => [],
                 ];
@@ -54,8 +65,10 @@ public function build(): array
         }
 
         ksort($groups);
+        $sections = $this->buildRelatedSections($groups);
 
         return [
+            'sections' => $sections,
             'groups' => array_values($groups),
             'commandCount' => count($commands),
             'aliasCount' => $aliasCount,
@@ -66,8 +79,7 @@ public function build(): array
      * @return array<int, array{
      *     primary: string,
      *     aliases: array<int, string>,
-     *     description: string,
-     *     links?: array<int, array{page: string, anchor: string}>
+     *     description: string
      * }>
      */
     private function discoverCommands(): array
@@ -183,97 +195,137 @@ private function parseCommandMetadata(string $path): ?array
         ];
     }
 
-    /**
-     * Scan documentation markdown files to map commands to their doc sections.
-     *
-     * @return array<string, array<int, array{page: string, anchor: string}>>
-     */
-    private function resolveCommandLinks(): array
+    private function extractNamespace(string $command): string
     {
-        $docsPath = $this->docsPath->path();
-
-        if (! is_dir($docsPath)) {
-            return [];
-        }
-
-        $files = glob($docsPath.'/*.md');
+        $segments = explode(':', $command, 2);
 
-        if ($files === false) {
-            return [];
+        if ($segments[0] === '') {
+            return 'general';
         }
 
-        sort($files);
-
-        /** @var array<string, array<string, array{page: string, anchor: string}>> $seen */
-        $seen = [];
+        return $segments[0];
+    }
 
-        foreach ($files as $file) {
-            $page = basename($file, '.md');
+    private function formatNamespaceName(string $namespace): string
+    {
+        return match ($namespace) {
+            'aws' => 'AWS',
+            'cf' => 'Cloudflare',
+            'do' => 'DigitalOcean',
+            'mariadb' => 'MariaDB',
+            'php' => 'PHP',
+            'postgresql' => 'PostgreSQL',
+            default => ucfirst($namespace),
+        };
+    }
 
-            if ($page === 'documentation' || $page === 'README') {
-                continue;
+    /**
+     * @param array<string, array{
+     *     name: string,
+     *     count: int,
+     *     commands: array<int, array{
+     *         primary: string,
+     *         aliases: array<int, string>,
+     *         description: string
+     *     }>
+     * }> $groups
+     * @return array<int, array{
+     *     name: string,
+     *     count: int,
+     *     namespaceCount: int,
+     *     groups: array<int, array{
+     *         name: string,
+     *         count: int,
+     *         commands: array<int, array{
+     *             primary: string,
+     *             aliases: array<int, string>,
+     *             description: string
+     *         }>
+     *     }>
+     * }>
+     */
+    private function buildRelatedSections(array $groups): array
+    {
+        /** @var array<string, array{
+         *     name: string,
+         *     count: int,
+         *     namespaceCount: int,
+         *     groups: array<int, array{
+         *         name: string,
+         *         count: int,
+         *         commands: array<int, array{
+         *             primary: string,
+         *             aliases: array<int, string>,
+         *             description: string
+         *         }>
+         *     }>
+         * }> $sections
+         */
+        $sections = [];
+
+        foreach ($groups as $namespace => $group) {
+            $sectionName = $this->resolveNamespaceSection($namespace);
+
+            if (! array_key_exists($sectionName, $sections)) {
+                $sections[$sectionName] = [
+                    'name' => $sectionName,
+                    'count' => 0,
+                    'namespaceCount' => 0,
+                    'groups' => [],
+                ];
             }
 
-            $content = file_get_contents($file);
+            $sections[$sectionName]['groups'][] = $group;
+            $sections[$sectionName]['count'] += $group['count'];
+            $sections[$sectionName]['namespaceCount']++;
+        }
+
+        $orderedSections = [];
 
-            if ($content === false) {
+        foreach ($this->sectionOrder() as $sectionName) {
+            if (! array_key_exists($sectionName, $sections)) {
                 continue;
             }
 
-            $currentAnchor = null;
-
-            foreach (explode("\n", $content) as $line) {
-                if (preg_match('/^#{2,3}\s+(.+)$/', $line, $headingMatch) === 1) {
-                    $currentAnchor = $this->slugify($headingMatch[1]);
-                }
-
-                if ($currentAnchor === null) {
-                    continue;
-                }
-
-                if (preg_match_all('/deployer\s+([a-z][a-z0-9:]+)\b/', $line, $commandMatches) !== 0) {
-                    foreach ($commandMatches[1] as $commandName) {
-                        $key = $page.'#'.$currentAnchor;
-
-                        if (! array_key_exists($commandName, $seen)) {
-                            $seen[$commandName] = [];
-                        }
-
-                        $seen[$commandName][$key] = [
-                            'page' => $page,
-                            'anchor' => $currentAnchor,
-                        ];
-                    }
-                }
-            }
+            $orderedSections[] = $sections[$sectionName];
+            unset($sections[$sectionName]);
         }
 
-        $links = [];
-
-        foreach ($seen as $commandName => $references) {
-            $links[$commandName] = array_values($references);
+        if ($sections !== []) {
+            foreach ($sections as $section) {
+                $orderedSections[] = $section;
+            }
         }
 
-        return $links;
+        return $orderedSections;
     }
 
-    private function slugify(string $text): string
+    private function resolveNamespaceSection(string $namespace): string
     {
-        $slug = mb_strtolower($text);
-        $slug = (string) preg_replace('/[^a-z0-9\s-]/', '', $slug);
-        $slug = (string) preg_replace('/[\s-]+/', '-', $slug);
-
-        return trim($slug, '-');
+        return match ($namespace) {
+            'server', 'site' => 'Server & Site Operations',
+            'cron', 'supervisor' => 'Scheduling & Process Control',
+            'nginx', 'php' => 'Web Runtime Services',
+            'mariadb', 'postgresql', 'redis', 'memcached' => 'Data Services',
+            'scaffold' => 'Scaffolding',
+            'aws', 'cf', 'do' => 'Cloud Providers',
+            default => 'Other',
+        };
     }
 
-    private function extractNamespace(string $command): string
+    /**
+     * @return array<int, string>
+     */
+    private function sectionOrder(): array
     {
-        $segments = explode(':', $command, 2);
-
-        if ($segments[0] === '') {
-            return 'general';
-        }
-
-        return $segments[0];
+        return [
+            'Server & Site Operations',
+            'Scheduling & Process Control',
+            'Web Runtime Services',
+            'Data Services',
+            'Scaffolding',
+            'Cloud Providers',
+            'Other',
+        ];
     }
 }
diff --git a/boost.json b/boost.json
index 9f73e7b..5d6022f 100644
--- a/boost.json
+++ b/boost.json
@@ -1,9 +1,11 @@
 {
     "agents": [
-        "claude_code"
+        "claude_code",
+        "codex"
     ],
     "editors": [
-        "claude_code"
+        "claude_code",
+        "codex"
     ],
     "guidelines": []
 }
diff --git a/config/docs.php b/config/docs.php
index 36fccf9..e441d09 100644
--- a/config/docs.php
+++ b/config/docs.php
@@ -24,6 +24,7 @@
     |--------------------------------------------------------------------------
     |
     | Cache TTL for the command cheat sheet payload in seconds.
+    | Set this to 0 (or a negative value) to disable caching.
     |
     */
 
diff --git a/resources/css/app.css b/resources/css/app.css
index 72ddf44..f516f06 100644
--- a/resources/css/app.css
+++ b/resources/css/app.css
@@ -65,7 +65,7 @@
     --tw-prose-headings: #18181b; /* zinc-900 */
     --tw-prose-links: #2299dd; /* accent */
     --tw-prose-code: #d946ef; /* fuchsia-600 */
-    --tw-prose-pre-bg: #f4f4f5; /* zinc-100 */
+    --tw-prose-pre-bg: #f4f4f590; /* zinc-100 */
     --tw-prose-pre-code: #3f3f46; /* zinc-700 */
     --tw-prose-counters: #71717a; /* zinc-500 */
     --tw-prose-bullets: #a1a1aa; /* zinc-400 */
@@ -160,6 +160,7 @@
     padding: 2rem 12px 12px;
     margin-top: 1.5rem;
     margin-bottom: 1.5rem;
+    line-height: 1.1;
 }
 
 .prose :where(pre code) {
@@ -168,7 +169,6 @@
     font-size: 0.875rem;
     font-weight: 400;
     color: inherit;
-    line-height: 1.2rem;
 }
 
 .prose :where(ul) {
diff --git a/resources/css/highlight.css b/resources/css/highlight.css
index 883231d..d6f565d 100644
--- a/resources/css/highlight.css
+++ b/resources/css/highlight.css
@@ -47,7 +47,7 @@
 .hljs-comment,
 .hljs-quote,
 .hljs-deletion {
-    color: #71717a; /* zinc-500 */
+    color: #a1a1aa; /* zinc-400 */
     font-style: italic;
 }
 
diff --git a/resources/views/cheat-sheet.blade.php b/resources/views/cheat-sheet.blade.php
index 6465002..7c6b057 100644
--- a/resources/views/cheat-sheet.blade.php
+++ b/resources/views/cheat-sheet.blade.php
@@ -12,124 +12,85 @@
     </head>
     <body class="min-h-screen bg-white text-zinc-700 dark:bg-zinc-900 dark:text-zinc-300">
         {{-- Header (matches docs layout) --}}
-        <flux:header sticky container class="z-11 border-b border-zinc-200 bg-white py-3 dark:border-zinc-800 dark:bg-zinc-900">
-            <a href="{{ route('home') }}" class="mr-4 flex min-w-0 flex-1 items-center gap-3 font-mono">
-                <img src="{{ asset('logo-mark.svg') }}" alt="" class="size-7 shrink-0 dark:hidden" aria-hidden="true" />
-                <img src="{{ asset('logo-mark-dark.svg') }}" alt="" class="hidden size-7 shrink-0 dark:block" aria-hidden="true" />
-                <span class="font-sans text-lg font-semibold text-cyan-400">DeployerPHP</span>
-                <span class="hidden min-w-0 flex-1 gap-0 sm:flex">
-                    <span class="h-px flex-1 bg-cyan-400"></span>
-                    <span class="h-px flex-1 bg-blue-400"></span>
-                    <span class="h-px flex-1 bg-fuchsia-400"></span>
-                    <span class="h-px flex-1 bg-slate-500 dark:bg-slate-600"></span>
-                </span>
-            </a>
-
-            <div class="flex items-center gap-3">
-                <flux:button size="sm" href="{{ route('cheat-sheet') }}" variant="primary">Cheat Sheet</flux:button>
-                <flux:button icon="github" size="sm" href="https://github.com/loadinglucian/deployer-php/" target="_blank">GitHub</flux:button>
-
-                <flux:separator vertical class="my-2 ml-3" />
-
-                <flux:button x-data variant="subtle" square aria-label="Toggle color scheme" x-on:click="$flux.appearance = $flux.dark ? 'light' : 'dark'">
-                    <flux:icon.moon x-cloak x-show="! $flux.dark" class="size-5" />
-                    <flux:icon.sun x-cloak x-show="$flux.dark" class="size-5" />
-                </flux:button>
-            </div>
-        </flux:header>
+        <x-docs.header />
 
         {{-- Main Content --}}
         <flux:main class="p-0!">
-            <div class="mx-auto max-w-7xl px-6 py-8 sm:py-10 lg:px-8">
+            <div class="mx-auto max-w-7xl px-6 py-4 sm:py-6 lg:px-8">
                 {{-- Page Header --}}
-                <header class="mb-8">
+                <header class="mb-6">
                     <h1 class="text-2xl font-semibold text-zinc-900 dark:text-zinc-50">Command Cheat Sheet</h1>
-                    <p class="mt-2 flex items-center gap-3 text-sm text-zinc-500 dark:text-zinc-400">
-                        <span><strong class="font-semibold text-zinc-700 dark:text-zinc-200">{{ $commandCount }}</strong> commands</span>
-                        <span aria-hidden="true" class="text-zinc-300 dark:text-zinc-600">&middot;</span>
-                        <span><strong class="font-semibold text-zinc-700 dark:text-zinc-200">{{ $aliasCount }}</strong> aliases</span>
+                    <p class="mt-2 text-sm text-zinc-500 dark:text-zinc-400">
+                        <strong class="font-semibold text-zinc-700 dark:text-zinc-200">{{ $commandCount }}</strong>
+                        commands organized by deployment workflow.
                     </p>
                 </header>
 
                 {{-- Global Options Hint --}}
                 <div class="mb-6 flex flex-wrap items-center justify-between gap-3 rounded-lg border border-zinc-200 bg-zinc-50 px-4 py-2.5 text-sm text-zinc-600 dark:border-zinc-700 dark:bg-zinc-800 dark:text-zinc-400">
-                    <span>Prefix commands with <code class="rounded bg-zinc-200/60 px-1.5 py-0.5 font-mono text-xs text-zinc-800 dark:bg-zinc-700/60 dark:text-zinc-200">deployer</code> (or your alias).</span>
+                    <span>
+                        Prefix commands with
+                        <code class="rounded bg-zinc-200/60 px-1.5 py-0.5 font-mono text-xs text-fuchsia-600 dark:bg-zinc-700/60 dark:text-fuchsia-400">deployer</code>
+                        in your terminal.
+                    </span>
                     <span class="flex flex-wrap items-center gap-1.5">
                         Global options:
-                        <code class="rounded bg-zinc-200/60 px-1.5 py-0.5 font-mono text-xs text-zinc-800 dark:bg-zinc-700/60 dark:text-zinc-200">--env</code>
-                        <code class="rounded bg-zinc-200/60 px-1.5 py-0.5 font-mono text-xs text-zinc-800 dark:bg-zinc-700/60 dark:text-zinc-200">--inventory</code>
-                        <code class="rounded bg-zinc-200/60 px-1.5 py-0.5 font-mono text-xs text-zinc-800 dark:bg-zinc-700/60 dark:text-zinc-200">--quiet</code>
+                        <code class="rounded bg-zinc-200/60 px-1.5 py-0.5 font-mono text-xs text-fuchsia-600 dark:bg-zinc-700/60 dark:text-fuchsia-400">--env</code>
+                        <code class="rounded bg-zinc-200/60 px-1.5 py-0.5 font-mono text-xs text-fuchsia-600 dark:bg-zinc-700/60 dark:text-fuchsia-400">--inventory</code>
+                        <code class="rounded bg-zinc-200/60 px-1.5 py-0.5 font-mono text-xs text-fuchsia-600 dark:bg-zinc-700/60 dark:text-fuchsia-400">--quiet</code>
                     </span>
                 </div>
 
-                {{-- Command Groups Grid --}}
-                <section class="grid grid-cols-1 gap-4 sm:grid-cols-2 xl:grid-cols-4" aria-label="All DeployerPHP commands">
-                    @foreach ($groups as $group)
-                        <article class="rounded-lg border border-zinc-200 bg-white p-4 dark:border-zinc-700 dark:bg-zinc-800/50">
-                            <h2 class="mb-3 flex items-baseline gap-1.5 text-xs font-semibold uppercase tracking-wide text-accent dark:text-blue-400">
-                                {{ $group['name'] }}
-                                <span class="text-zinc-400 dark:text-zinc-500">({{ $group['count'] }})</span>
-                            </h2>
+                {{-- Command Groups By Related Documentation Area --}}
+                @if ($sections !== [])
+                    <div class="space-y-10" aria-label="DeployerPHP commands grouped by related documentation area">
+                        @foreach ($sections as $section)
+                            @php
+                                $sectionDescription = match ($section['name']) {
+                                    'Server & Site Operations' => 'Core commands for provisioning hosts, managing sites, and handling routine server maintenance.',
+                                    'Scheduling & Process Control' => 'Tools for defining scheduled jobs and managing long-running background workers.',
+                                    'Web Runtime Services' => 'Commands for configuring and controlling the web stack, including PHP and Nginx services.',
+                                    'Data Services' => 'Operational commands for databases and cache layers used by deployed applications.',
+                                    'Scaffolding' => 'Generators and setup helpers that bootstrap common deployment resources and project structure.',
+                                    'Cloud Providers' => 'Provider-specific commands for creating and managing infrastructure across supported cloud platforms.',
+                                    default => 'Supporting commands for specialized tasks that do not fit a primary operations category.',
+                                };
+                            @endphp
 
-                            <ul class="space-y-1.5">
-                                @foreach ($group['commands'] as $command)
-                                    <li title="{{ $command['description'] }}">
-                                        <code class="font-mono text-sm text-zinc-900 dark:text-zinc-100">{{ $command['primary'] }}</code>
+                            <section>
+                                <header class="mb-4 border-b border-zinc-200 pb-2 dark:border-zinc-700">
+                                    <h2 class="text-lg font-semibold text-zinc-900 dark:text-zinc-50">{{ $section['name'] }}</h2>
+                                    <p class="mt-1 text-sm text-zinc-500 dark:text-zinc-400">{{ $sectionDescription }}</p>
+                                </header>
 
-                                        @if ($command['links'] !== [])
-                                            @foreach ($command['links'] as $index => $link)
-                                                <a href="{{ route('docs.show', ['page' => $link['page']]) }}#{{ $link['anchor'] }}" class="inline-flex items-center justify-center size-4 rounded-sm bg-accent/10 text-[10px] font-medium leading-none text-accent no-underline hover:bg-accent/20 dark:bg-blue-400/10 dark:text-blue-400 dark:hover:bg-blue-400/20" title="{{ $link['page'] }}#{{ $link['anchor'] }}">{{ $index + 1 }}</a>
-                                            @endforeach
-                                        @endif
+                                <div class="grid grid-cols-1 gap-4 sm:grid-cols-2 xl:grid-cols-4">
+                                    @foreach ($section['groups'] as $group)
+                                        <article class="rounded-lg border border-zinc-200 bg-white p-4 dark:border-zinc-700 dark:bg-zinc-800/50">
+                                            <h3 class="mb-3 flex items-baseline gap-1.5 text-sm font-semibold text-zinc-900 dark:text-zinc-50">
+                                                {{ $group['name'] }}
+                                                <span class="text-xs font-normal text-zinc-400 dark:text-zinc-500">({{ $group['count'] }})</span>
+                                            </h3>
 
-                                        @if ($command['aliases'] !== [])
-                                            <span class="ml-1 text-xs text-zinc-400 dark:text-zinc-500">
-                                                alias:
-                                                @foreach ($command['aliases'] as $alias)
-                                                    <code class="font-mono text-fuchsia-600 dark:text-fuchsia-400">{{ $alias }}</code>@if (! $loop->last), @endif
+                                            <ul class="space-y-1.5">
+                                                @foreach ($group['commands'] as $command)
+                                                    <li title="{{ $command['description'] }}">
+                                                        <code class="rounded bg-zinc-100/80 px-1 py-0.5 font-mono text-sm text-fuchsia-600 dark:bg-zinc-800/80 dark:text-fuchsia-400">{{ $command['primary'] }}</code>
+                                                    </li>
                                                 @endforeach
-                                            </span>
-                                        @endif
-                                    </li>
-                                @endforeach
-                            </ul>
-                        </article>
-                    @endforeach
-                </section>
+                                            </ul>
+                                        </article>
+                                    @endforeach
+                                </div>
+                            </section>
+                        @endforeach
+                    </div>
+                @else
+                    <p class="text-sm text-zinc-500 dark:text-zinc-400">No commands were discovered for the configured docs path.</p>
+                @endif
             </div>
 
             {{-- Footer (matches docs layout) --}}
-            <footer class="my-10 flex flex-col gap-6 p-6 text-center text-sm text-zinc-700/60 dark:border-zinc-800 dark:text-zinc-300/60">
-                <div class="flex items-center justify-center gap-1">
-                    <a href="https://github.com/loadinglucian/deployer-php/" target="_blank" rel="noopener" aria-label="View on GitHub" class="inline-flex items-center justify-center rounded-md p-2 text-zinc-500 transition-colors hover:text-zinc-900 dark:text-zinc-400 dark:hover:text-white">
-                        <flux:icon.github class="size-5" />
-                        <span class="sr-only">GitHub</span>
-                    </a>
-
-                    <a href="https://www.reddit.com/r/DeployerPHP/" target="_blank" rel="noopener" aria-label="Follow on Reddit" class="inline-flex items-center justify-center rounded-md p-2 text-zinc-500 transition-colors hover:text-zinc-900 dark:text-zinc-400 dark:hover:text-white">
-                        <flux:icon.reddit class="size-5" />
-                        <span class="sr-only">Reddit</span>
-                    </a>
-
-                    <a href="https://x.com/loadinglucian" target="_blank" rel="noopener" aria-label="Follow on X" class="inline-flex items-center justify-center rounded-md p-2 text-zinc-500 transition-colors hover:text-zinc-900 dark:text-zinc-400 dark:hover:text-white">
-                        <flux:icon.x class="size-5" />
-                        <span class="sr-only">X</span>
-                    </a>
-                </div>
-
-                <p>
-                    <span>Made with tender love</span>
-                    <svg class="inline-flex shrink-0 text-zinc-400 [:where(&amp;)]:size-4" data-flux-icon="" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16" fill="currentColor" aria-hidden="true" data-slot="icon">
-                        <path d="M2 6.342a3.375 3.375 0 0 1 6-2.088 3.375 3.375 0 0 1 5.997 2.26c-.063 2.134-1.618 3.76-2.955 4.784a14.437 14.437 0 0 1-2.676 1.61c-.02.01-.038.017-.05.022l-.014.006-.004.002h-.002a.75.75 0 0 1-.592.001h-.002l-.004-.003-.015-.006a5.528 5.528 0 0 1-.232-.107 14.395 14.395 0 0 1-2.535-1.557C3.564 10.22 1.999 8.558 1.999 6.38L2 6.342Z"></path>
-                    </svg>
-                    <span>and care</span>
-                    <a href="https://www.google.com/search?q=bucharest+romania" class="underline underline-offset-4" target="_blank" rel="noopener">in Bucharest, Romania</a>
-                </p>
-                <p>
-                    &copy; {{ now()->year }}
-                    <a href="https://x.com/loadinglucian" class="underline underline-offset-4" target="_blank" rel="noopener">Lucian V&#259;c&#259;roiu</a>
-                </p>
-            </footer>
+            <x-docs.footer />
         </flux:main>
 
         @fluxScripts
diff --git a/resources/views/components/docs/footer.blade.php b/resources/views/components/docs/footer.blade.php
new file mode 100644
index 0000000..5dee00c
--- /dev/null
+++ b/resources/views/components/docs/footer.blade.php
@@ -0,0 +1,31 @@
+<footer class="my-10 flex flex-col gap-6 p-6 text-center text-sm text-zinc-700/60 dark:border-zinc-800 dark:text-zinc-300/60">
+    <div class="flex items-center justify-center gap-1">
+        <a href="https://github.com/loadinglucian/deployer-php/" target="_blank" rel="noopener" aria-label="View on GitHub" class="inline-flex items-center justify-center rounded-md p-2 text-zinc-500 transition-colors hover:text-zinc-900 dark:text-zinc-400 dark:hover:text-white">
+            <flux:icon.github class="size-5" />
+            <span class="sr-only">GitHub</span>
+        </a>
+
+        <a href="https://www.reddit.com/r/DeployerPHP/" target="_blank" rel="noopener" aria-label="Follow on Reddit" class="inline-flex items-center justify-center rounded-md p-2 text-zinc-500 transition-colors hover:text-zinc-900 dark:text-zinc-400 dark:hover:text-white">
+            <flux:icon.reddit class="size-5" />
+            <span class="sr-only">Reddit</span>
+        </a>
+
+        <a href="https://x.com/loadinglucian" target="_blank" rel="noopener" aria-label="Follow on X" class="inline-flex items-center justify-center rounded-md p-2 text-zinc-500 transition-colors hover:text-zinc-900 dark:text-zinc-400 dark:hover:text-white">
+            <flux:icon.x class="size-5" />
+            <span class="sr-only">X</span>
+        </a>
+    </div>
+
+    <p>
+        <span>Made with tender love</span>
+        <svg class="inline-flex shrink-0 text-zinc-400 [:where(&amp;)]:size-4" data-flux-icon="" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16" fill="currentColor" aria-hidden="true" data-slot="icon">
+            <path d="M2 6.342a3.375 3.375 0 0 1 6-2.088 3.375 3.375 0 0 1 5.997 2.26c-.063 2.134-1.618 3.76-2.955 4.784a14.437 14.437 0 0 1-2.676 1.61c-.02.01-.038.017-.05.022l-.014.006-.004.002h-.002a.75.75 0 0 1-.592.001h-.002l-.004-.003-.015-.006a5.528 5.528 0 0 1-.232-.107 14.395 14.395 0 0 1-2.535-1.557C3.564 10.22 1.999 8.558 1.999 6.38L2 6.342Z"></path>
+        </svg>
+        <span>and care</span>
+        <a href="https://www.google.com/search?q=bucharest+romania" class="underline underline-offset-4" target="_blank" rel="noopener">in Bucharest, Romania</a>
+    </p>
+    <p>
+        &copy; {{ now()->year }}
+        <a href="https://x.com/loadinglucian" class="underline underline-offset-4" target="_blank" rel="noopener">Lucian Văcăroiu</a>
+    </p>
+</footer>
diff --git a/resources/views/components/docs/header.blade.php b/resources/views/components/docs/header.blade.php
new file mode 100644
index 0000000..caf42a7
--- /dev/null
+++ b/resources/views/components/docs/header.blade.php
@@ -0,0 +1,29 @@
+<flux:header sticky container class="z-11 border-b border-zinc-200 bg-white py-3 dark:border-zinc-800 dark:bg-zinc-900">
+    <flux:sidebar.toggle class="lg:hidden" icon="bars-3" inset="left" />
+
+    {{-- Colorful Logo --}}
+    <a href="{{ route('home') }}" wire:navigate class="mr-4 flex min-w-0 flex-1 items-center gap-3 font-mono">
+        <img src="{{ asset('logo-mark.svg') }}" alt="" class="size-7 shrink-0 dark:hidden" aria-hidden="true" />
+        <img src="{{ asset('logo-mark-dark.svg') }}" alt="" class="hidden size-7 shrink-0 dark:block" aria-hidden="true" />
+        <span class="font-sans text-lg font-semibold text-cyan-400">DeployerPHP</span>
+        <span class="hidden min-w-0 flex-1 gap-0 sm:flex">
+            <span class="h-px flex-1 bg-cyan-400"></span>
+            <span class="h-px flex-1 bg-blue-400"></span>
+            <span class="h-px flex-1 bg-fuchsia-400"></span>
+            <span class="h-px flex-1 bg-slate-500 dark:bg-slate-600"></span>
+        </span>
+    </a>
+
+    <div class="flex items-center gap-3">
+        {{-- GitHub Button --}}
+        <flux:button icon="github" size="sm" href="https://github.com/loadinglucian/deployer-php/" target="_blank">GitHub</flux:button>
+
+        <flux:separator vertical class="my-2 ml-3" />
+
+        {{-- Dark Mode Toggle --}}
+        <flux:button x-data variant="subtle" square aria-label="Toggle color scheme" x-on:click="$flux.appearance = $flux.dark ? 'light' : 'dark'">
+            <flux:icon.moon x-cloak x-show="! $flux.dark" class="size-5" />
+            <flux:icon.sun x-cloak x-show="$flux.dark" class="size-5" />
+        </flux:button>
+    </div>
+</flux:header>
diff --git a/resources/views/components/docs/toc.blade.php b/resources/views/components/docs/toc.blade.php
index d9ca4d8..9da18e1 100644
--- a/resources/views/components/docs/toc.blade.php
+++ b/resources/views/components/docs/toc.blade.php
@@ -13,7 +13,7 @@
             @endforeach
 
             @if ($loop->last)
-                <flux:navlist.item href="{{ route('cheat-sheet') }}" target="_blank">
+                <flux:navlist.item href="{{ route('cheat-sheet') }}" wire:navigate>
                     <div class="flex items-center gap-2">
                         <span>Cheat Sheet</span>
 
diff --git a/resources/views/components/layouts/cheat-sheet.blade.php b/resources/views/components/layouts/cheat-sheet.blade.php
new file mode 100644
index 0000000..a0f6123
--- /dev/null
+++ b/resources/views/components/layouts/cheat-sheet.blade.php
@@ -0,0 +1,22 @@
+<!DOCTYPE html>
+<html lang="{{ str_replace('_', '-', app()->getLocale()) }}" class="scroll-smooth">
+    <head>
+        <meta charset="utf-8" />
+        <meta name="viewport" content="width=device-width, initial-scale=1" />
+        <title>DeployerPHP - Command Cheat Sheet</title>
+        <link rel="icon" type="image/svg+xml" href="{{ asset('logo-mark.svg') }}" />
+        <link rel="preconnect" href="https://fonts.bunny.net" />
+        <link href="https://fonts.bunny.net/css?family=inter:400,500,600&display=swap" rel="stylesheet" />
+        @vite(['resources/css/app.css', 'resources/js/app.js'])
+        @fluxAppearance
+    </head>
+    <body class="min-h-screen bg-white text-zinc-700 dark:bg-zinc-900 dark:text-zinc-300">
+        <x-docs.header />
+
+        <flux:main class="p-0!">
+            {{ $slot }}
+        </flux:main>
+
+        @fluxScripts
+    </body>
+</html>
diff --git a/resources/views/components/layouts/docs.blade.php b/resources/views/components/layouts/docs.blade.php
index c3188e8..f6697e6 100644
--- a/resources/views/components/layouts/docs.blade.php
+++ b/resources/views/components/layouts/docs.blade.php
@@ -16,35 +16,7 @@
             // Fixed Header
             // ----
         --}}
-        <flux:header sticky container class="z-11 border-b border-zinc-200 bg-white py-3 dark:border-zinc-800 dark:bg-zinc-900">
-            <flux:sidebar.toggle class="lg:hidden" icon="bars-3" inset="left" />
-
-            {{-- Colorful Logo --}}
-            <a href="{{ route('home') }}" wire:navigate class="mr-4 flex min-w-0 flex-1 items-center gap-3 font-mono">
-                <img src="{{ asset('logo-mark.svg') }}" alt="" class="size-7 shrink-0 dark:hidden" aria-hidden="true" />
-                <img src="{{ asset('logo-mark-dark.svg') }}" alt="" class="hidden size-7 shrink-0 dark:block" aria-hidden="true" />
-                <span class="font-sans text-lg font-semibold text-cyan-400">DeployerPHP</span>
-                <span class="hidden min-w-0 flex-1 gap-0 sm:flex">
-                    <span class="h-px flex-1 bg-cyan-400"></span>
-                    <span class="h-px flex-1 bg-blue-400"></span>
-                    <span class="h-px flex-1 bg-fuchsia-400"></span>
-                    <span class="h-px flex-1 bg-slate-500 dark:bg-slate-600"></span>
-                </span>
-            </a>
-
-            <div class="flex items-center gap-3">
-                {{-- GitHub Button --}}
-                <flux:button icon="github" size="sm" href="https://github.com/loadinglucian/deployer-php/" target="_blank">GitHub</flux:button>
-
-                <flux:separator vertical class="my-2 ml-3" />
-
-                {{-- Dark Mode Toggle --}}
-                <flux:button x-data variant="subtle" square aria-label="Toggle color scheme" x-on:click="$flux.appearance = $flux.dark ? 'light' : 'dark'">
-                    <flux:icon.moon x-cloak x-show="! $flux.dark" class="size-5" />
-                    <flux:icon.sun x-cloak x-show="$flux.dark" class="size-5" />
-                </flux:button>
-            </div>
-        </flux:header>
+        <x-docs.header />
 
         {{--
             // ----
@@ -77,37 +49,7 @@
                         {{-- See content.blade.php --}}
                         {{ $slot }}
 
-                        <footer class="my-10 flex flex-col gap-6 p-6 text-center text-sm text-zinc-700/60 dark:border-zinc-800 dark:text-zinc-300/60">
-                            <div class="flex items-center justify-center gap-1">
-                                <a href="https://github.com/loadinglucian/deployer-php/" target="_blank" rel="noopener" aria-label="View on GitHub" class="inline-flex items-center justify-center rounded-md p-2 text-zinc-500 transition-colors hover:text-zinc-900 dark:text-zinc-400 dark:hover:text-white">
-                                    <flux:icon.github class="size-5" />
-                                    <span class="sr-only">GitHub</span>
-                                </a>
-
-                                <a href="https://www.reddit.com/r/DeployerPHP/" target="_blank" rel="noopener" aria-label="Follow on Reddit" class="inline-flex items-center justify-center rounded-md p-2 text-zinc-500 transition-colors hover:text-zinc-900 dark:text-zinc-400 dark:hover:text-white">
-                                    <flux:icon.reddit class="size-5" />
-                                    <span class="sr-only">Reddit</span>
-                                </a>
-
-                                <a href="https://x.com/loadinglucian" target="_blank" rel="noopener" aria-label="Follow on X" class="inline-flex items-center justify-center rounded-md p-2 text-zinc-500 transition-colors hover:text-zinc-900 dark:text-zinc-400 dark:hover:text-white">
-                                    <flux:icon.x class="size-5" />
-                                    <span class="sr-only">X</span>
-                                </a>
-                            </div>
-
-                            <p>
-                                <span>Made with tender love</span>
-                                <svg class="inline-flex shrink-0 text-zinc-400 [:where(&amp;)]:size-4" data-flux-icon="" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16" fill="currentColor" aria-hidden="true" data-slot="icon">
-                                    <path d="M2 6.342a3.375 3.375 0 0 1 6-2.088 3.375 3.375 0 0 1 5.997 2.26c-.063 2.134-1.618 3.76-2.955 4.784a14.437 14.437 0 0 1-2.676 1.61c-.02.01-.038.017-.05.022l-.014.006-.004.002h-.002a.75.75 0 0 1-.592.001h-.002l-.004-.003-.015-.006a5.528 5.528 0 0 1-.232-.107 14.395 14.395 0 0 1-2.535-1.557C3.564 10.22 1.999 8.558 1.999 6.38L2 6.342Z"></path>
-                                </svg>
-                                <span>and care</span>
-                                <a href="https://www.google.com/search?q=bucharest+romania" class="underline underline-offset-4" target="_blank" rel="noopener">in Bucharest, Romania</a>
-                            </p>
-                            <p>
-                                &copy; {{ now()->year }}
-                                <a href="https://x.com/loadinglucian" class="underline underline-offset-4" target="_blank" rel="noopener">Lucian Văcăroiu</a>
-                            </p>
-                        </footer>
+                        <x-docs.footer />
                     </main>
 
                     {{-- Right Sidebar: Page Headings --}}
diff --git a/resources/views/livewire/cheat-sheet.blade.php b/resources/views/livewire/cheat-sheet.blade.php
new file mode 100644
index 0000000..9286b9b
--- /dev/null
+++ b/resources/views/livewire/cheat-sheet.blade.php
@@ -0,0 +1,71 @@
+<div class="mx-auto max-w-7xl px-6 py-4 sm:py-6 lg:px-8">
+    <header class="mb-6">
+        <h1 class="text-2xl font-semibold text-zinc-900 dark:text-zinc-50">Command Cheat Sheet</h1>
+        <p class="mt-2 text-sm text-zinc-500 dark:text-zinc-400">
+            <strong class="font-semibold text-zinc-700 dark:text-zinc-200">{{ $commandCount }}</strong>
+            commands organized by deployment workflow.
+        </p>
+    </header>
+
+    <div class="mb-6 flex flex-wrap items-center justify-between gap-3 rounded-lg border border-zinc-200 bg-zinc-50 px-4 py-2.5 text-sm text-zinc-600 dark:border-zinc-700 dark:bg-zinc-800 dark:text-zinc-400">
+        <span>
+            Prefix commands with
+            <code class="rounded bg-zinc-200/60 px-1.5 py-0.5 font-mono text-xs text-fuchsia-600 dark:bg-zinc-700/60 dark:text-fuchsia-400">deployer</code>
+            in your terminal.
+        </span>
+        <span class="flex flex-wrap items-center gap-1.5">
+            Global options:
+            <code class="rounded bg-zinc-200/60 px-1.5 py-0.5 font-mono text-xs text-fuchsia-600 dark:bg-zinc-700/60 dark:text-fuchsia-400">--env</code>
+            <code class="rounded bg-zinc-200/60 px-1.5 py-0.5 font-mono text-xs text-fuchsia-600 dark:bg-zinc-700/60 dark:text-fuchsia-400">--inventory</code>
+            <code class="rounded bg-zinc-200/60 px-1.5 py-0.5 font-mono text-xs text-fuchsia-600 dark:bg-zinc-700/60 dark:text-fuchsia-400">--quiet</code>
+        </span>
+    </div>
+
+    @if ($sections !== [])
+        <div class="space-y-10" aria-label="DeployerPHP commands grouped by related documentation area">
+            @foreach ($sections as $section)
+                @php
+                    $sectionDescription = match ($section['name']) {
+                        'Server & Site Operations' => 'Core commands for provisioning hosts, managing sites, and handling routine server maintenance.',
+                        'Scheduling & Process Control' => 'Tools for defining scheduled jobs and managing long-running background workers.',
+                        'Web Runtime Services' => 'Commands for configuring and controlling the web stack, including PHP and Nginx services.',
+                        'Data Services' => 'Operational commands for databases and cache layers used by deployed applications.',
+                        'Scaffolding' => 'Generators and setup helpers that bootstrap common deployment resources and project structure.',
+                        'Cloud Providers' => 'Provider-specific commands for creating and managing infrastructure across supported cloud platforms.',
+                        default => 'Supporting commands for specialized tasks that do not fit a primary operations category.',
+                    };
+                @endphp
+
+                <section>
+                    <header class="mb-4 border-b border-zinc-200 pb-2 dark:border-zinc-700">
+                        <h2 class="text-lg font-semibold text-zinc-900 dark:text-zinc-50">{{ $section['name'] }}</h2>
+                        <p class="mt-1 text-sm text-zinc-500 dark:text-zinc-400">{{ $sectionDescription }}</p>
+                    </header>
+
+                    <div class="grid grid-cols-1 gap-4 sm:grid-cols-2 xl:grid-cols-4">
+                        @foreach ($section['groups'] as $group)
+                            <article class="rounded-lg border border-zinc-200 bg-white p-4 dark:border-zinc-700 dark:bg-zinc-800/50">
+                                <h3 class="mb-3 flex items-baseline gap-1.5 text-sm font-semibold text-zinc-900 dark:text-zinc-50">
+                                    {{ $group['name'] }}
+                                    <span class="text-xs font-normal text-zinc-400 dark:text-zinc-500">({{ $group['count'] }})</span>
+                                </h3>
+
+                                <ul class="space-y-1.5">
+                                    @foreach ($group['commands'] as $command)
+                                        <li title="{{ $command['description'] }}">
+                                            <code class="rounded bg-zinc-100/80 px-1 py-0.5 font-mono text-sm text-fuchsia-600 dark:bg-zinc-800/80 dark:text-fuchsia-400">{{ $command['primary'] }}</code>
+                                        </li>
+                                    @endforeach
+                                </ul>
+                            </article>
+                        @endforeach
+                    </div>
+                </section>
+            @endforeach
+        </div>
+    @else
+        <p class="text-sm text-zinc-500 dark:text-zinc-400">No commands were discovered for the configured docs path.</p>
+    @endif
+
+    <x-docs.footer />
+</div>
diff --git a/routes/web.php b/routes/web.php
index 5d81a0a..6bdfb9b 100644
--- a/routes/web.php
+++ b/routes/web.php
@@ -1,8 +1,7 @@
 <?php
 
+use App\Livewire\CheatSheet;
 use App\Livewire\DocsViewer;
-use App\Services\CommandCheatSheetService;
-use Illuminate\Support\Facades\Cache;
 use Illuminate\Support\Facades\Route;
 
 Route::get('/', DocsViewer::class)->name('home');
@@ -12,13 +11,4 @@
     ->name('docs.show')
     ->where(['page' => '[a-z0-9-]+']);
 
-Route::get('/cheat-sheet', function (CommandCheatSheetService $sheet) {
-    $cacheTtlSeconds = max(1, (int) config('docs.cheat_sheet.cache_ttl_seconds', 300));
-    $cheatSheet = Cache::remember(
-        'cheat_sheet:v1',
-        now()->addSeconds($cacheTtlSeconds),
-        fn (): array => $sheet->build(),
-    );
-
-    return view('cheat-sheet', $cheatSheet);
-})->name('cheat-sheet');
+Route::get('/cheat-sheet', CheatSheet::class)->name('cheat-sheet');
diff --git a/tests/Feature/CheatSheetPageTest.php b/tests/Feature/CheatSheetPageTest.php
index a21954b..f667aab 100644
--- a/tests/Feature/CheatSheetPageTest.php
+++ b/tests/Feature/CheatSheetPageTest.php
@@ -4,15 +4,50 @@
 
 use App\Services\CommandCheatSheetService;
 use App\Services\DocsPathService;
+use Illuminate\Support\Facades\Cache;
 
 it('renders the command cheat sheet with discovered commands', function (): void {
     app()->forgetInstance(DocsPathService::class);
     app()->forgetInstance(CommandCheatSheetService::class);
+    Cache::forget('cheat_sheet:v2');
 
     $response = $this->get(route('cheat-sheet'));
 
     $response->assertOk()
         ->assertSee('Command Cheat Sheet')
+        ->assertSeeText('Server & Site Operations')
+        ->assertSeeText('Scheduling & Process Control')
+        ->assertSeeText('Web Runtime Services')
+        ->assertSeeText('Data Services')
+        ->assertSeeText('Cloud Providers')
         ->assertSee('server:add')
         ->assertSee('site:deploy');
 });
+
+it('does not render docs reference links for commands', function (): void {
+    app()->forgetInstance(DocsPathService::class);
+    app()->forgetInstance(CommandCheatSheetService::class);
+    Cache::forget('cheat_sheet:v2');
+
+    $response = $this->get(route('cheat-sheet'));
+
+    $response->assertOk()
+        ->assertSeeText('site:delete')
+        ->assertDontSee(route('docs.show', ['page' => 'managing-sites']).'#deleting-a-site', false);
+});
+
+it('renders the empty-state message when no commands are available', function (): void {
+    Cache::forget('cheat_sheet:v2');
+
+    Cache::put('cheat_sheet:v2', [
+        'sections' => [],
+        'groups' => [],
+        'commandCount' => 0,
+        'aliasCount' => 0,
+    ], now()->addMinutes(5));
+
+    $response = $this->get(route('cheat-sheet'));
+
+    $response->assertOk()
+        ->assertSeeText('No commands were discovered for the configured docs path.');
+});
diff --git a/tests/Feature/DocsSidebarNavigationTest.php b/tests/Feature/DocsSidebarNavigationTest.php
index 11a7aeb..48a8c37 100644
--- a/tests/Feature/DocsSidebarNavigationTest.php
+++ b/tests/Feature/DocsSidebarNavigationTest.php
@@ -30,6 +30,13 @@
         ->assertSee('href="'.route('home').'"', false)
         ->assertSee('href="'.route('docs.show', ['page' => 'installation']).'"', false)
         ->assertSee('href="'.route('docs.show', ['page' => 'managing-services']).'"', false);
+
+    $content = $response->getContent();
+
+    expect($content)->not->toBeFalse();
+    expect((string) $content)
+        ->toMatch('/<a[^>]*href="'.preg_quote(route('cheat-sheet'), '/').'"[^>]*wire:navigate(?:="")?[^>]*>/')
+        ->not->toMatch('/<a[^>]*href="'.preg_quote(route('cheat-sheet'), '/').'"[^>]*target="_blank"[^>]*>/');
 });
 
 it('redirects missing docs pages to the docs home', function (): void {

From 33b2ee0d7bfe384987e1107c23ec5e504fbe9fd9 Mon Sep 17 00:00:00 2001
From: Lucian Behind The Scenes <silviulucian@gmail.com>
Date: Thu, 19 Feb 2026 19:48:34 +0200
Subject: [PATCH 2/8] refactor: rename cheat sheet to command index
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Renames the CheatSheet feature to CommandIndex across the entire
codebase—Livewire component, service, views, layout, route, config
key, env var, sidebar TOC link, and tests.
---
 .phpstorm.meta.php                            | 12 ++--
 .../{CheatSheet.php => CommandIndex.php}      | 38 ++++++----
 ...eetService.php => CommandIndexService.php} |  2 +-
 config/docs.php                               |  8 +--
 ...heet.blade.php => command-index.blade.php} |  4 +-
 resources/views/components/docs/toc.blade.php | 20 +++---
 .../components/layouts/cheat-sheet.blade.php  | 22 ------
 .../layouts/command-index.blade.php           | 55 +++++++++++++++
 ...heet.blade.php => command-index.blade.php} | 18 ++---
 routes/web.php                                |  4 +-
 tests/Feature/CheatSheetPageTest.php          | 53 --------------
 tests/Feature/CommandIndexPageTest.php        | 69 +++++++++++++++++++
 tests/Feature/DocsSidebarNavigationTest.php   |  6 +-
 13 files changed, 188 insertions(+), 123 deletions(-)
 rename app/Livewire/{CheatSheet.php => CommandIndex.php} (70%)
 rename app/Services/{CommandCheatSheetService.php => CommandIndexService.php} (99%)
 rename resources/views/{cheat-sheet.blade.php => command-index.blade.php} (98%)
 delete mode 100644 resources/views/components/layouts/cheat-sheet.blade.php
 create mode 100644 resources/views/components/layouts/command-index.blade.php
 rename resources/views/livewire/{cheat-sheet.blade.php => command-index.blade.php} (91%)
 delete mode 100644 tests/Feature/CheatSheetPageTest.php
 create mode 100644 tests/Feature/CommandIndexPageTest.php

diff --git a/.phpstorm.meta.php b/.phpstorm.meta.php
index f5371ec..a9eeb2b 100644
--- a/.phpstorm.meta.php
+++ b/.phpstorm.meta.php
@@ -1017,7 +1017,7 @@
             'database.redis.cache.backoff_base' => 'integer',
             'database.redis.cache.backoff_cap' => 'integer',
             'docs.path' => 'string',
-            'docs.cheat_sheet.cache_ttl_seconds' => 'integer',
+            'docs.command_index.cache_ttl_seconds' => 'integer',
             'docs.github.repo' => 'string',
             'docs.github.branch' => 'string',
             'docs.github.dir' => 'string',
@@ -1527,7 +1527,7 @@
             'database.redis.cache.backoff_base' => 'integer',
             'database.redis.cache.backoff_cap' => 'integer',
             'docs.path' => 'string',
-            'docs.cheat_sheet.cache_ttl_seconds' => 'integer',
+            'docs.command_index.cache_ttl_seconds' => 'integer',
             'docs.github.repo' => 'string',
             'docs.github.branch' => 'string',
             'docs.github.dir' => 'string',
@@ -2037,7 +2037,7 @@
             'database.redis.cache.backoff_base' => 'integer',
             'database.redis.cache.backoff_cap' => 'integer',
             'docs.path' => 'string',
-            'docs.cheat_sheet.cache_ttl_seconds' => 'integer',
+            'docs.command_index.cache_ttl_seconds' => 'integer',
             'docs.github.repo' => 'string',
             'docs.github.branch' => 'string',
             'docs.github.dir' => 'string',
@@ -2369,7 +2369,7 @@
 'database.redis.default.max_retries','database.redis.default.backoff_algorithm','database.redis.default.backoff_base','database.redis.default.backoff_cap','database.redis.cache.url',
 'database.redis.cache.host','database.redis.cache.username','database.redis.cache.password','database.redis.cache.port','database.redis.cache.database',
 'database.redis.cache.max_retries','database.redis.cache.backoff_algorithm','database.redis.cache.backoff_base','database.redis.cache.backoff_cap','docs.path',
-'docs.cheat_sheet.cache_ttl_seconds','docs.github.repo','docs.github.branch','docs.github.dir','filesystems.default',
+'docs.command_index.cache_ttl_seconds','docs.github.repo','docs.github.branch','docs.github.dir','filesystems.default',
 'filesystems.disks.local.driver','filesystems.disks.local.root','filesystems.disks.local.serve','filesystems.disks.local.throw','filesystems.disks.local.report',
 'filesystems.disks.public.driver','filesystems.disks.public.root','filesystems.disks.public.url','filesystems.disks.public.visibility','filesystems.disks.public.throw',
 'filesystems.disks.public.report','filesystems.disks.s3.driver','filesystems.disks.s3.key','filesystems.disks.s3.secret','filesystems.disks.s3.region',
@@ -2423,10 +2423,10 @@
 'signed','throttle','verified',);
         registerArgumentsSet('routes', 
 'boost.browser-logs','default-livewire.update',
-'livewire.upload-file','livewire.preview-file','home','docs.show','cheat-sheet',
+'livewire.upload-file','livewire.preview-file','home','docs.show','command-index',
 'storage.local',);
         registerArgumentsSet('views', 
-'8c026b058f5337eae33f20fdb97d2c88::docs-viewer','cheat-sheet','components.docs.alert','components.docs.code-block','components.docs.content',
+'8c026b058f5337eae33f20fdb97d2c88::docs-viewer','command-index','components.docs.alert','components.docs.code-block','components.docs.content',
 'components.docs.headings','components.docs.toc','components.layouts.docs','docs-viewer','docs.alert',
 'docs.code-block','docs.content','docs.headings','docs.toc','e60dd9d2c3a62d619c9acb38f20d5aa5::icon.github',
 'e60dd9d2c3a62d619c9acb38f20d5aa5::icon.reddit','e60dd9d2c3a62d619c9acb38f20d5aa5::icon.x','f3dff5f3846978e0b3612bcd64f9871e::docs.alert','f3dff5f3846978e0b3612bcd64f9871e::docs.code-block','f3dff5f3846978e0b3612bcd64f9871e::docs.content',
diff --git a/app/Livewire/CheatSheet.php b/app/Livewire/CommandIndex.php
similarity index 70%
rename from app/Livewire/CheatSheet.php
rename to app/Livewire/CommandIndex.php
index abd2a0a..3ee16c4 100644
--- a/app/Livewire/CheatSheet.php
+++ b/app/Livewire/CommandIndex.php
@@ -4,14 +4,15 @@
 
 namespace App\Livewire;
 
-use App\Services\CommandCheatSheetService;
+use App\Services\CommandIndexService;
+use App\Services\TocParserService;
 use Illuminate\Contracts\View\View;
 use Illuminate\Support\Facades\Cache;
 use Livewire\Attributes\Layout;
 use Livewire\Component;
 
-#[Layout('components.layouts.cheat-sheet')]
-final class CheatSheet extends Component
+#[Layout('components.layouts.command-index')]
+final class CommandIndex extends Component
 {
     /**
      * @var array<int, array{
@@ -48,9 +49,20 @@ final class CheatSheet extends Component
 
     public int $aliasCount = 0;
 
-    public function mount(CommandCheatSheetService $sheet): void
+    /**
+     * @var array<int, array{
+     *     name: string,
+     *     anchor: string,
+     *     links: array<int, array{title: string, path: string}>
+     * }>
+     */
+    public array $toc = [];
+
+    public function mount(TocParserService $tocParser, CommandIndexService $sheet): void
     {
-        $cacheTtlSeconds = (int) config('docs.cheat_sheet.cache_ttl_seconds', 300);
+        $this->toc = $tocParser->parse();
+
+        $cacheTtlSeconds = (int) config('docs.command_index.cache_ttl_seconds', 300);
         $cacheEnabled = ! app()->isLocal() && $cacheTtlSeconds > 0;
 
         /** @var array{
@@ -79,24 +91,24 @@ public function mount(CommandCheatSheetService $sheet): void
          *     }>,
          *     commandCount: int,
          *     aliasCount: int
-         * } $cheatSheet
+         * } $commandIndex
          */
-        $cheatSheet = $cacheEnabled
+        $commandIndex = $cacheEnabled
             ? Cache::remember(
-                'cheat_sheet:v2',
+                'command_index:v2',
                 now()->addSeconds($cacheTtlSeconds),
                 fn (): array => $sheet->build(),
             )
             : $sheet->build();
 
-        $this->sections = $cheatSheet['sections'];
-        $this->groups = $cheatSheet['groups'];
-        $this->commandCount = $cheatSheet['commandCount'];
-        $this->aliasCount = $cheatSheet['aliasCount'];
+        $this->sections = $commandIndex['sections'];
+        $this->groups = $commandIndex['groups'];
+        $this->commandCount = $commandIndex['commandCount'];
+        $this->aliasCount = $commandIndex['aliasCount'];
     }
 
     public function render(): View
     {
-        return view('livewire.cheat-sheet');
+        return view('livewire.command-index');
     }
 }
diff --git a/app/Services/CommandCheatSheetService.php b/app/Services/CommandIndexService.php
similarity index 99%
rename from app/Services/CommandCheatSheetService.php
rename to app/Services/CommandIndexService.php
index af98b83..2f50ff3 100644
--- a/app/Services/CommandCheatSheetService.php
+++ b/app/Services/CommandIndexService.php
@@ -7,7 +7,7 @@
 use RecursiveDirectoryIterator;
 use RecursiveIteratorIterator;
 
-final readonly class CommandCheatSheetService
+final readonly class CommandIndexService
 {
     public function __construct(
         private DocsPathService $docsPath,
diff --git a/config/docs.php b/config/docs.php
index e441d09..474fa05 100644
--- a/config/docs.php
+++ b/config/docs.php
@@ -20,16 +20,16 @@
 
     /*
     |--------------------------------------------------------------------------
-    | Cheat Sheet
+    | Command Index
     |--------------------------------------------------------------------------
     |
-    | Cache TTL for the command cheat sheet payload in seconds.
+    | Cache TTL for the command index payload in seconds.
     | Set this to 0 (or a negative value) to disable caching.
     |
     */
 
-    'cheat_sheet' => [
-        'cache_ttl_seconds' => (int) env('DOCS_CHEAT_SHEET_CACHE_TTL', 300),
+    'command_index' => [
+        'cache_ttl_seconds' => (int) env('DOCS_COMMAND_INDEX_CACHE_TTL', 300),
     ],
 
     /*
diff --git a/resources/views/cheat-sheet.blade.php b/resources/views/command-index.blade.php
similarity index 98%
rename from resources/views/cheat-sheet.blade.php
rename to resources/views/command-index.blade.php
index 7c6b057..8fbf740 100644
--- a/resources/views/cheat-sheet.blade.php
+++ b/resources/views/command-index.blade.php
@@ -3,7 +3,7 @@
     <head>
         <meta charset="utf-8" />
         <meta name="viewport" content="width=device-width, initial-scale=1" />
-        <title>DeployerPHP - Command Cheat Sheet</title>
+        <title>DeployerPHP - Command Index</title>
         <link rel="icon" type="image/svg+xml" href="{{ asset('logo-mark.svg') }}" />
         <link rel="preconnect" href="https://fonts.bunny.net" />
         <link href="https://fonts.bunny.net/css?family=inter:400,500,600&display=swap" rel="stylesheet" />
@@ -19,7 +19,7 @@
             <div class="mx-auto max-w-7xl px-6 py-4 sm:py-6 lg:px-8">
                 {{-- Page Header --}}
                 <header class="mb-6">
-                    <h1 class="text-2xl font-semibold text-zinc-900 dark:text-zinc-50">Command Cheat Sheet</h1>
+                    <h1 class="text-2xl font-semibold text-zinc-900 dark:text-zinc-50">Command Index</h1>
                     <p class="mt-2 text-sm text-zinc-500 dark:text-zinc-400">
                         <strong class="font-semibold text-zinc-700 dark:text-zinc-200">{{ $commandCount }}</strong>
                         commands organized by deployment workflow.
diff --git a/resources/views/components/docs/toc.blade.php b/resources/views/components/docs/toc.blade.php
index 9da18e1..7a32f00 100644
--- a/resources/views/components/docs/toc.blade.php
+++ b/resources/views/components/docs/toc.blade.php
@@ -11,16 +11,16 @@
                     {{ $link['title'] }}
                 </flux:navlist.item>
             @endforeach
-
-            @if ($loop->last)
-                <flux:navlist.item href="{{ route('cheat-sheet') }}" wire:navigate>
-                    <div class="flex items-center gap-2">
-                        <span>Cheat Sheet</span>
-
-                        <flux:icon.square-arrow-out-up-right class="size-3" />
-                    </div>
-                </flux:navlist.item>
-            @endif
         </flux:navlist.group>
     @endforeach
+
+    <flux:navlist.group heading="Index">
+        <flux:navlist.item href="{{ route('command-index') }}" wire:navigate :current="$currentPath === 'command-index'">
+            <div class="flex items-center gap-2">
+                <span>Command Index</span>
+
+                <flux:icon.square-arrow-out-up-right class="size-3" />
+            </div>
+        </flux:navlist.item>
+    </flux:navlist.group>
 </flux:navlist>
diff --git a/resources/views/components/layouts/cheat-sheet.blade.php b/resources/views/components/layouts/cheat-sheet.blade.php
deleted file mode 100644
index a0f6123..0000000
--- a/resources/views/components/layouts/cheat-sheet.blade.php
+++ /dev/null
@@ -1,22 +0,0 @@
-<!DOCTYPE html>
-<html lang="{{ str_replace('_', '-', app()->getLocale()) }}" class="scroll-smooth">
-    <head>
-        <meta charset="utf-8" />
-        <meta name="viewport" content="width=device-width, initial-scale=1" />
-        <title>DeployerPHP - Command Cheat Sheet</title>
-        <link rel="icon" type="image/svg+xml" href="{{ asset('logo-mark.svg') }}" />
-        <link rel="preconnect" href="https://fonts.bunny.net" />
-        <link href="https://fonts.bunny.net/css?family=inter:400,500,600&display=swap" rel="stylesheet" />
-        @vite(['resources/css/app.css', 'resources/js/app.js'])
-        @fluxAppearance
-    </head>
-    <body class="min-h-screen bg-white text-zinc-700 dark:bg-zinc-900 dark:text-zinc-300">
-        <x-docs.header />
-
-        <flux:main class="p-0!">
-            {{ $slot }}
-        </flux:main>
-
-        @fluxScripts
-    </body>
-</html>
diff --git a/resources/views/components/layouts/command-index.blade.php b/resources/views/components/layouts/command-index.blade.php
new file mode 100644
index 0000000..ce40c52
--- /dev/null
+++ b/resources/views/components/layouts/command-index.blade.php
@@ -0,0 +1,55 @@
+<!DOCTYPE html>
+<html lang="{{ str_replace('_', '-', app()->getLocale()) }}" class="scroll-smooth">
+    <head>
+        <meta charset="utf-8" />
+        <meta name="viewport" content="width=device-width, initial-scale=1" />
+        <title>DeployerPHP - Command Index</title>
+        <link rel="icon" type="image/svg+xml" href="{{ asset('logo-mark.svg') }}" />
+        <link rel="preconnect" href="https://fonts.bunny.net" />
+        <link href="https://fonts.bunny.net/css?family=inter:400,500,600&display=swap" rel="stylesheet" />
+        @vite(['resources/css/app.css', 'resources/js/app.js'])
+        @fluxAppearance
+    </head>
+    <body class="min-h-screen bg-white text-zinc-700 dark:bg-zinc-900 dark:text-zinc-300">
+        {{--
+            // ----
+            // Fixed Header
+            // ----
+        --}}
+        <x-docs.header />
+
+        {{--
+            // ----
+            // Mobile Sidebar
+            // ----
+        --}}
+        <flux:sidebar sticky stashable class="border-r border-zinc-200 bg-white px-6 pt-20 pb-10 lg:hidden dark:border-zinc-800 dark:bg-zinc-900">
+            {{ $sidebar }}
+        </flux:sidebar>
+
+        {{--
+            // ----
+            // Main Layout
+            // ----
+        --}}
+        <flux:main class="p-0!">
+            <div class="mx-auto max-w-7xl px-6 py-4 sm:py-6 lg:px-8">
+                <div class="lg:grid lg:grid-cols-[280px_1fr]">
+                    <aside class="hidden self-stretch lg:block">
+                        <div class="sticky max-h-[calc(100vh-var(--docs-sticky-top)-2rem)] w-54 overflow-y-auto pr-12" style="top: var(--docs-sticky-top)">
+                            {{ $sidebar }}
+                        </div>
+                    </aside>
+
+                    <main class="min-h-[calc(100vh-var(--docs-sticky-top)-2rem)] min-w-0">
+                        {{ $slot }}
+
+                        <x-docs.footer />
+                    </main>
+                </div>
+            </div>
+        </flux:main>
+
+        @fluxScripts
+    </body>
+</html>
diff --git a/resources/views/livewire/cheat-sheet.blade.php b/resources/views/livewire/command-index.blade.php
similarity index 91%
rename from resources/views/livewire/cheat-sheet.blade.php
rename to resources/views/livewire/command-index.blade.php
index 9286b9b..887fc0a 100644
--- a/resources/views/livewire/cheat-sheet.blade.php
+++ b/resources/views/livewire/command-index.blade.php
@@ -1,11 +1,15 @@
-<div class="mx-auto max-w-7xl px-6 py-4 sm:py-6 lg:px-8">
-    <header class="mb-6">
-        <h1 class="text-2xl font-semibold text-zinc-900 dark:text-zinc-50">Command Cheat Sheet</h1>
-        <p class="mt-2 text-sm text-zinc-500 dark:text-zinc-400">
-            <strong class="font-semibold text-zinc-700 dark:text-zinc-200">{{ $commandCount }}</strong>
+<x-slot:sidebar>
+    <x-docs.toc :toc="$toc" current-path="command-index" />
+</x-slot:sidebar>
+
+<div>
+    <article class="docs-prose prose max-w-none">
+        <h1>Command Index</h1>
+        <p>
+            <strong>{{ $commandCount }}</strong>
             commands organized by deployment workflow.
         </p>
-    </header>
+    </article>
 
     <div class="mb-6 flex flex-wrap items-center justify-between gap-3 rounded-lg border border-zinc-200 bg-zinc-50 px-4 py-2.5 text-sm text-zinc-600 dark:border-zinc-700 dark:bg-zinc-800 dark:text-zinc-400">
         <span>
@@ -66,6 +70,4 @@
     @else
         <p class="text-sm text-zinc-500 dark:text-zinc-400">No commands were discovered for the configured docs path.</p>
     @endif
-
-    <x-docs.footer />
 </div>
diff --git a/routes/web.php b/routes/web.php
index 6bdfb9b..509d5b6 100644
--- a/routes/web.php
+++ b/routes/web.php
@@ -1,6 +1,6 @@
 <?php
 
-use App\Livewire\CheatSheet;
+use App\Livewire\CommandIndex;
 use App\Livewire\DocsViewer;
 use Illuminate\Support\Facades\Route;
 
@@ -11,4 +11,4 @@
     ->name('docs.show')
     ->where(['page' => '[a-z0-9-]+']);
 
-Route::get('/cheat-sheet', CheatSheet::class)->name('cheat-sheet');
+Route::get('/command-index', CommandIndex::class)->name('command-index');
diff --git a/tests/Feature/CheatSheetPageTest.php b/tests/Feature/CheatSheetPageTest.php
deleted file mode 100644
index f667aab..0000000
--- a/tests/Feature/CheatSheetPageTest.php
+++ /dev/null
@@ -1,53 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-use App\Services\CommandCheatSheetService;
-use App\Services\DocsPathService;
-use Illuminate\Support\Facades\Cache;
-
-it('renders the command cheat sheet with discovered commands', function (): void {
-    app()->forgetInstance(DocsPathService::class);
-    app()->forgetInstance(CommandCheatSheetService::class);
-    Cache::forget('cheat_sheet:v2');
-
-    $response = $this->get(route('cheat-sheet'));
-
-    $response->assertOk()
-        ->assertSee('Command Cheat Sheet')
-        ->assertSeeText('Server & Site Operations')
-        ->assertSeeText('Scheduling & Process Control')
-        ->assertSeeText('Web Runtime Services')
-        ->assertSeeText('Data Services')
-        ->assertSeeText('Cloud Providers')
-        ->assertSee('server:add')
-        ->assertSee('site:deploy');
-});
-
-it('does not render docs reference links for commands', function (): void {
-    app()->forgetInstance(DocsPathService::class);
-    app()->forgetInstance(CommandCheatSheetService::class);
-    Cache::forget('cheat_sheet:v2');
-
-    $response = $this->get(route('cheat-sheet'));
-
-    $response->assertOk()
-        ->assertSeeText('site:delete')
-        ->assertDontSee(route('docs.show', ['page' => 'managing-sites']).'#deleting-a-site', false);
-});
-
-it('renders the empty-state message when no commands are available', function (): void {
-    Cache::forget('cheat_sheet:v2');
-
-    Cache::put('cheat_sheet:v2', [
-        'sections' => [],
-        'groups' => [],
-        'commandCount' => 0,
-        'aliasCount' => 0,
-    ], now()->addMinutes(5));
-
-    $response = $this->get(route('cheat-sheet'));
-
-    $response->assertOk()
-        ->assertSeeText('No commands were discovered for the configured docs path.');
-});
diff --git a/tests/Feature/CommandIndexPageTest.php b/tests/Feature/CommandIndexPageTest.php
new file mode 100644
index 0000000..dd9874e
--- /dev/null
+++ b/tests/Feature/CommandIndexPageTest.php
@@ -0,0 +1,69 @@
+<?php
+
+declare(strict_types=1);
+
+use App\Services\CommandIndexService;
+use App\Services\DocsPathService;
+use App\Services\TocParserService;
+use Illuminate\Support\Facades\Cache;
+
+it('renders the command index with discovered commands', function (): void {
+    app()->forgetInstance(DocsPathService::class);
+    app()->forgetInstance(CommandIndexService::class);
+    Cache::forget('command_index:v2');
+
+    $response = $this->get(route('command-index'));
+
+    $response->assertOk()
+        ->assertSee('Command Index')
+        ->assertSeeText('Server & Site Operations')
+        ->assertSeeText('Scheduling & Process Control')
+        ->assertSeeText('Web Runtime Services')
+        ->assertSeeText('Data Services')
+        ->assertSeeText('Cloud Providers')
+        ->assertSee('server:add')
+        ->assertSee('site:deploy');
+});
+
+it('does not render docs reference links for commands', function (): void {
+    app()->forgetInstance(DocsPathService::class);
+    app()->forgetInstance(CommandIndexService::class);
+    Cache::forget('command_index:v2');
+
+    $response = $this->get(route('command-index'));
+
+    $response->assertOk()
+        ->assertSeeText('site:delete')
+        ->assertDontSee(route('docs.show', ['page' => 'managing-sites']).'#deleting-a-site', false);
+});
+
+it('renders the empty-state message when no commands are available', function (): void {
+    Cache::forget('command_index:v2');
+
+    Cache::put('command_index:v2', [
+        'sections' => [],
+        'groups' => [],
+        'commandCount' => 0,
+        'aliasCount' => 0,
+    ], now()->addMinutes(5));
+
+    $response = $this->get(route('command-index'));
+
+    $response->assertOk()
+        ->assertSeeText('No commands were discovered for the configured docs path.');
+});
+
+it('renders the docs-style single sidebar layout', function (): void {
+    app()->forgetInstance(DocsPathService::class);
+    app()->forgetInstance(TocParserService::class);
+    app()->forgetInstance(CommandIndexService::class);
+    Cache::forget('command_index:v2');
+
+    $response = $this->get(route('command-index'));
+
+    $response->assertOk()
+        ->assertSee('href="'.route('home').'"', false)
+        ->assertSeeText('Guides')
+        ->assertSee('lg:grid-cols-[280px_1fr]', false)
+        ->assertDontSee('lg:grid-cols-[280px_1fr_280px]', false);
+});
diff --git a/tests/Feature/DocsSidebarNavigationTest.php b/tests/Feature/DocsSidebarNavigationTest.php
index 48a8c37..0b824b3 100644
--- a/tests/Feature/DocsSidebarNavigationTest.php
+++ b/tests/Feature/DocsSidebarNavigationTest.php
@@ -26,6 +26,8 @@
             'Managing Databases',
             'Cloud Providers',
             'Automation & AI',
+            'Index',
+            'Command Index',
         ])
         ->assertSee('href="'.route('home').'"', false)
         ->assertSee('href="'.route('docs.show', ['page' => 'installation']).'"', false)
@@ -35,8 +37,8 @@
 
     expect($content)->not->toBeFalse();
     expect((string) $content)
-        ->toMatch('/<a[^>]*href="'.preg_quote(route('cheat-sheet'), '/').'"[^>]*wire:navigate(?:="")?[^>]*>/')
-        ->not->toMatch('/<a[^>]*href="'.preg_quote(route('cheat-sheet'), '/').'"[^>]*target="_blank"[^>]*>/');
+        ->toMatch('/<a[^>]*href="'.preg_quote(route('command-index'), '/').'"[^>]*wire:navigate(?:="")?[^>]*>/')
+        ->not->toMatch('/<a[^>]*href="'.preg_quote(route('command-index'), '/').'"[^>]*target="_blank"[^>]*>/');
 });
 
 it('redirects missing docs pages to the docs home', function (): void {

From 4eda191053fc1f6cacdbbef29057e095ab36a87e Mon Sep 17 00:00:00 2001
From: Lucian Behind The Scenes <silviulucian@gmail.com>
Date: Thu, 19 Feb 2026 20:06:45 +0200
Subject: [PATCH 3/8]  fixup

---
 resources/css/app.css | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/resources/css/app.css b/resources/css/app.css
index f516f06..3d50187 100644
--- a/resources/css/app.css
+++ b/resources/css/app.css
@@ -160,7 +160,7 @@
     padding: 2rem 12px 12px;
     margin-top: 1.5rem;
     margin-bottom: 1.5rem;
-    line-height: 1.1;
+    line-height: 1.25;
 }
 
 .prose :where(pre code) {

From 5bf77cd7a5e80055f240e899257812898cc7eb22 Mon Sep 17 00:00:00 2001
From: Lucian Behind The Scenes <silviulucian@gmail.com>
Date: Fri, 20 Feb 2026 11:40:26 +0200
Subject: [PATCH 4/8] feat: introduce file-backed DocsOutputCacheService

Replaces the Laravel Cache facade approach with a dedicated
file-backed cache service that integrates with optimize:clear.

- Add DocsOutputCacheService with SHA1-keyed JSON files, atomic
  writes via temp-rename, and flock-based double-checked locking
- Add DocsClearCommand registered via AppServiceProvider::optimizes()
  so optimize:clear wipes the docs output cache automatically
- Refactor DocsViewer and CommandIndex to cache full page payloads
  (including TOC) through DocsOutputCacheService
- Add DocumentService file fingerprinting (mtime+size) for
  per-document cache invalidation without TTLs
- Replace command_index.cache_ttl_seconds config with unified
  docs.cache.* config block
- Add optimize:clear before optimize in deploy script
---
 .deployer/scripts/deploy.sh                 |   2 +-
 app/Console/Commands/DocsClearCommand.php   |  24 ++
 app/Livewire/CommandIndex.php               | 118 +++++++--
 app/Livewire/DocsViewer.php                 | 100 ++++++--
 app/Providers/AppServiceProvider.php        |   4 +-
 app/Services/DocsOutputCacheService.php     | 269 ++++++++++++++++++++
 app/Services/DocumentService.php            |  66 +++--
 config/docs.php                             |  13 +-
 tests/Feature/CommandIndexPageTest.php      |  97 ++++++-
 tests/Feature/DocsClearCommandTest.php      |  27 ++
 tests/Feature/DocsSidebarNavigationTest.php |  47 ++++
 tests/Feature/DocumentServiceCacheTest.php  |  56 ++++
 12 files changed, 747 insertions(+), 76 deletions(-)
 create mode 100644 app/Console/Commands/DocsClearCommand.php
 create mode 100644 app/Services/DocsOutputCacheService.php
 create mode 100644 tests/Feature/DocsClearCommandTest.php
 create mode 100644 tests/Feature/DocumentServiceCacheTest.php

diff --git a/.deployer/scripts/deploy.sh b/.deployer/scripts/deploy.sh
index 5ce4b4d..b412bef 100644
--- a/.deployer/scripts/deploy.sh
+++ b/.deployer/scripts/deploy.sh
@@ -126,8 +126,8 @@ if [[ $framework == "laravel" ]]; then
 	# ----
 
 	echo "→ Optimizing..."
+	"${DEPLOYER_PHP}" artisan optimize:clear
 	"${DEPLOYER_PHP}" artisan optimize
-
 fi
 
 # Symfony (uncomment as needed)
diff --git a/app/Console/Commands/DocsClearCommand.php b/app/Console/Commands/DocsClearCommand.php
new file mode 100644
index 0000000..5ce259e
--- /dev/null
+++ b/app/Console/Commands/DocsClearCommand.php
@@ -0,0 +1,24 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Console\Commands;
+
+use App\Services\DocsOutputCacheService;
+use Illuminate\Console\Command;
+
+final class DocsClearCommand extends Command
+{
+    protected $signature = 'docs:clear';
+
+    protected $description = 'Clear docs output files';
+
+    public function handle(DocsOutputCacheService $docsOutput): int
+    {
+        $docsOutput->clear();
+
+        $this->components->info('Docs output cleared.');
+
+        return self::SUCCESS;
+    }
+}
diff --git a/app/Livewire/CommandIndex.php b/app/Livewire/CommandIndex.php
index 3ee16c4..2e8e83a 100644
--- a/app/Livewire/CommandIndex.php
+++ b/app/Livewire/CommandIndex.php
@@ -5,9 +5,9 @@
 namespace App\Livewire;
 
 use App\Services\CommandIndexService;
+use App\Services\DocsOutputCacheService;
 use App\Services\TocParserService;
 use Illuminate\Contracts\View\View;
-use Illuminate\Support\Facades\Cache;
 use Livewire\Attributes\Layout;
 use Livewire\Component;
 
@@ -58,14 +58,17 @@ final class CommandIndex extends Component
      */
     public array $toc = [];
 
-    public function mount(TocParserService $tocParser, CommandIndexService $sheet): void
-    {
-        $this->toc = $tocParser->parse();
-
-        $cacheTtlSeconds = (int) config('docs.command_index.cache_ttl_seconds', 300);
-        $cacheEnabled = ! app()->isLocal() && $cacheTtlSeconds > 0;
-
+    public function mount(
+        DocsOutputCacheService $docsOutputCache,
+        TocParserService $tocParser,
+        CommandIndexService $sheet,
+    ): void {
         /** @var array{
+         *     toc: array<int, array{
+         *         name: string,
+         *         anchor: string,
+         *         links: array<int, array{title: string, path: string}>
+         *     }>,
          *     sections: array<int, array{
          *         name: string,
          *         count: int,
@@ -91,24 +94,99 @@ public function mount(TocParserService $tocParser, CommandIndexService $sheet):
          *     }>,
          *     commandCount: int,
          *     aliasCount: int
-         * } $commandIndex
+         * } $payload
          */
-        $commandIndex = $cacheEnabled
-            ? Cache::remember(
-                'command_index:v2',
-                now()->addSeconds($cacheTtlSeconds),
-                fn (): array => $sheet->build(),
-            )
-            : $sheet->build();
+        $payload = $docsOutputCache->remember(
+            $docsOutputCache->key('command-index'),
+            function () use ($tocParser, $sheet): array {
+                /** @var array{
+                 *     sections: array<int, array{
+                 *         name: string,
+                 *         count: int,
+                 *         namespaceCount: int,
+                 *         groups: array<int, array{
+                 *             name: string,
+                 *             count: int,
+                 *             commands: array<int, array{
+                 *                 primary: string,
+                 *                 aliases: array<int, string>,
+                 *                 description: string
+                 *             }>
+                 *         }>
+                 *     }>,
+                 *     groups: array<int, array{
+                 *         name: string,
+                 *         count: int,
+                 *         commands: array<int, array{
+                 *             primary: string,
+                 *             aliases: array<int, string>,
+                 *             description: string
+                 *         }>
+                 *     }>,
+                 *     commandCount: int,
+                 *     aliasCount: int
+                 * } $commandIndex
+                 */
+                $commandIndex = $sheet->build();
+
+                return [
+                    'toc' => $tocParser->parse(),
+                    'sections' => $commandIndex['sections'],
+                    'groups' => $commandIndex['groups'],
+                    'commandCount' => $commandIndex['commandCount'],
+                    'aliasCount' => $commandIndex['aliasCount'],
+                ];
+            },
+        );
 
-        $this->sections = $commandIndex['sections'];
-        $this->groups = $commandIndex['groups'];
-        $this->commandCount = $commandIndex['commandCount'];
-        $this->aliasCount = $commandIndex['aliasCount'];
+        $this->hydrateFromPayload($payload);
     }
 
     public function render(): View
     {
         return view('livewire.command-index');
     }
+
+    /**
+     * @param  array{
+     *     toc: array<int, array{
+     *         name: string,
+     *         anchor: string,
+     *         links: array<int, array{title: string, path: string}>
+     *     }>,
+     *     sections: array<int, array{
+     *         name: string,
+     *         count: int,
+     *         namespaceCount: int,
+     *         groups: array<int, array{
+     *             name: string,
+     *             count: int,
+     *             commands: array<int, array{
+     *                 primary: string,
+     *                 aliases: array<int, string>,
+     *                 description: string
+     *             }>
+     *         }>
+     *     }>,
+     *     groups: array<int, array{
+     *         name: string,
+     *         count: int,
+     *         commands: array<int, array{
+     *             primary: string,
+     *             aliases: array<int, string>,
+     *             description: string
+     *         }>
+     *     }>,
+     *     commandCount: int,
+     *     aliasCount: int
+     * } $payload
+     */
+    private function hydrateFromPayload(array $payload): void
+    {
+        $this->toc = $payload['toc'];
+        $this->sections = $payload['sections'];
+        $this->groups = $payload['groups'];
+        $this->commandCount = $payload['commandCount'];
+        $this->aliasCount = $payload['aliasCount'];
+    }
 }
diff --git a/app/Livewire/DocsViewer.php b/app/Livewire/DocsViewer.php
index 276d9a5..c534a06 100644
--- a/app/Livewire/DocsViewer.php
+++ b/app/Livewire/DocsViewer.php
@@ -4,6 +4,7 @@
 
 namespace App\Livewire;
 
+use App\Services\DocsOutputCacheService;
 use App\Services\DocumentService;
 use App\Services\TocParserService;
 use Illuminate\Contracts\View\View;
@@ -34,43 +35,108 @@ final class DocsViewer extends Component
     public array $toc = [];
 
     public function mount(
+        DocsOutputCacheService $docsOutputCache,
         TocParserService $tocParser,
         DocumentService $documentService,
         ?string $page = null,
     ): void {
-        $this->toc = $tocParser->parse();
+        $routeIdentity = $page === null || $page === '' ? 'home' : "docs:{$page}";
+
+        /** @var array{
+         *     page: string,
+         *     title: string,
+         *     content: string,
+         *     headings: array<int, array{level: int, text: string, id: string}>,
+         *     toc: array<int, array{
+         *         name: string,
+         *         anchor: string,
+         *         links: array<int, array{title: string, path: string}>
+         *     }>
+         * } $payload
+         */
+        $payload = $docsOutputCache->remember(
+            $docsOutputCache->key('docs-viewer', [$routeIdentity]),
+            fn (): array => $this->buildPayload($tocParser, $documentService, $page),
+        );
+
+        $this->hydrateFromPayload($payload);
+    }
+
+    public function render(): View
+    {
+        return view('livewire.docs-viewer');
+    }
+
+    /**
+     * @return array{
+     *     page: string,
+     *     title: string,
+     *     content: string,
+     *     headings: array<int, array{level: int, text: string, id: string}>,
+     *     toc: array<int, array{
+     *         name: string,
+     *         anchor: string,
+     *         links: array<int, array{title: string, path: string}>
+     *     }>
+     * }
+     */
+    private function buildPayload(
+        TocParserService $tocParser,
+        DocumentService $documentService,
+        ?string $page,
+    ): array {
+        $toc = $tocParser->parse();
 
-        // No page specified - show README or redirect to first doc
         if ($page === null || $page === '') {
             $readme = $documentService->loadReadme();
 
-            if ($readme !== null) {
-                $this->title = $readme['title'];
-                $this->content = $readme['content'];
-                $this->headings = $readme['headings'];
-                $this->page = '';
-
-                return;
+            if ($readme === null) {
+                throw new HttpResponseException(new RedirectResponse('/', 301));
             }
 
-            throw new HttpResponseException(new RedirectResponse('/', 301));
+            return [
+                'page' => '',
+                'title' => $readme['title'],
+                'content' => $readme['content'],
+                'headings' => $readme['headings'],
+                'toc' => $toc,
+            ];
         }
 
-        // Load the requested document
         $document = $documentService->load($page);
 
         if ($document === null) {
             throw new HttpResponseException(new RedirectResponse('/', 301));
         }
 
-        $this->page = $page;
-        $this->title = $document['title'];
-        $this->content = $document['content'];
-        $this->headings = $document['headings'];
+        return [
+            'page' => $page,
+            'title' => $document['title'],
+            'content' => $document['content'],
+            'headings' => $document['headings'],
+            'toc' => $toc,
+        ];
     }
 
-    public function render(): View
+    /**
+     * @param  array{
+     *     page: string,
+     *     title: string,
+     *     content: string,
+     *     headings: array<int, array{level: int, text: string, id: string}>,
+     *     toc: array<int, array{
+     *         name: string,
+     *         anchor: string,
+     *         links: array<int, array{title: string, path: string}>
+     *     }>
+     * }  $payload
+     */
+    private function hydrateFromPayload(array $payload): void
     {
-        return view('livewire.docs-viewer');
+        $this->page = $payload['page'];
+        $this->title = $payload['title'];
+        $this->content = $payload['content'];
+        $this->headings = $payload['headings'];
+        $this->toc = $payload['toc'];
     }
 }
diff --git a/app/Providers/AppServiceProvider.php b/app/Providers/AppServiceProvider.php
index 6360c78..6e484d9 100644
--- a/app/Providers/AppServiceProvider.php
+++ b/app/Providers/AppServiceProvider.php
@@ -4,6 +4,7 @@
 
 namespace App\Providers;
 
+use App\Services\DocsOutputCacheService;
 use App\Services\DocsPathService;
 use App\Services\DocumentService;
 use App\Services\HeadingExtractorService;
@@ -20,6 +21,7 @@ final class AppServiceProvider extends ServiceProvider
     public function register(): void
     {
         $this->app->singleton(DocsPathService::class);
+        $this->app->singleton(DocsOutputCacheService::class);
         $this->app->singleton(MarkdownService::class);
         $this->app->singleton(TocParserService::class);
         $this->app->singleton(HeadingExtractorService::class);
@@ -31,6 +33,6 @@ public function register(): void
      */
     public function boot(): void
     {
-        //
+        $this->optimizes(clear: 'docs:clear', key: 'docs');
     }
 }
diff --git a/app/Services/DocsOutputCacheService.php b/app/Services/DocsOutputCacheService.php
new file mode 100644
index 0000000..3429c5b
--- /dev/null
+++ b/app/Services/DocsOutputCacheService.php
@@ -0,0 +1,269 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Services;
+
+use Illuminate\Filesystem\Filesystem;
+use Throwable;
+
+final readonly class DocsOutputCacheService
+{
+    public function __construct(
+        private Filesystem $files,
+    ) {}
+
+    public function key(string $namespace, array $segments = []): string
+    {
+        $normalizedSegments = array_map(
+            fn (mixed $segment): string => $this->normalizeSegment($segment),
+            $segments,
+        );
+
+        $parts = array_values(array_filter([
+            $this->version(),
+            trim($namespace),
+            ...$normalizedSegments,
+        ], static fn (string $part): bool => $part !== ''));
+
+        return implode(':', $parts);
+    }
+
+    public function get(string $key): mixed
+    {
+        if (! $this->enabled()) {
+            return null;
+        }
+
+        $filePath = $this->cacheFilePath($key);
+
+        if (! is_file($filePath)) {
+            return null;
+        }
+
+        $contents = file_get_contents($filePath);
+
+        if ($contents === false || $contents === '') {
+            return null;
+        }
+
+        /** @var array{version?: string, key?: string, value?: mixed}|null $payload */
+        $payload = json_decode($contents, true);
+
+        if (! is_array($payload)) {
+            return null;
+        }
+
+        if (($payload['version'] ?? null) !== $this->version()) {
+            return null;
+        }
+
+        if (($payload['key'] ?? null) !== $key) {
+            return null;
+        }
+
+        return $payload['value'] ?? null;
+    }
+
+    public function put(string $key, mixed $value): void
+    {
+        if (! $this->enabled()) {
+            return;
+        }
+
+        $filePath = $this->cacheFilePath($key);
+        $directory = dirname($filePath);
+
+        $this->files->ensureDirectoryExists($directory);
+
+        $payload = [
+            'version' => $this->version(),
+            'created_at' => now()->toIso8601String(),
+            'key' => $key,
+            'value' => $value,
+        ];
+
+        $encoded = json_encode($payload, JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE);
+
+        if ($encoded === false) {
+            return;
+        }
+
+        try {
+            $suffix = bin2hex(random_bytes(8));
+        } catch (Throwable) {
+            $suffix = uniqid('', true);
+        }
+
+        $tempFile = sprintf('%s.tmp.%s', $filePath, $suffix);
+        $bytes = file_put_contents($tempFile, $encoded, LOCK_EX);
+
+        if ($bytes === false) {
+            return;
+        }
+
+        if (! @rename($tempFile, $filePath)) {
+            @unlink($tempFile);
+        }
+    }
+
+    public function remember(string $key, callable $resolver): mixed
+    {
+        if (! $this->enabled()) {
+            return $resolver();
+        }
+
+        $cached = $this->get($key);
+
+        if ($cached !== null) {
+            return $cached;
+        }
+
+        return $this->withLock($key, function () use ($key, $resolver): mixed {
+            $cachedAfterLock = $this->get($key);
+
+            if ($cachedAfterLock !== null) {
+                return $cachedAfterLock;
+            }
+
+            $value = $resolver();
+
+            if ($value !== null) {
+                $this->put($key, $value);
+            }
+
+            return $value;
+        });
+    }
+
+    public function clear(): void
+    {
+        $path = $this->path();
+
+        if ($this->files->isDirectory($path)) {
+            $this->files->deleteDirectory($path);
+        }
+
+        $this->files->ensureDirectoryExists($path);
+    }
+
+    public function path(): string
+    {
+        $path = config('docs.cache.path');
+
+        if (is_string($path) && $path !== '') {
+            return $path;
+        }
+
+        return storage_path('framework/cache/docs-output');
+    }
+
+    private function enabled(): bool
+    {
+        $enabled = config('docs.cache.enabled');
+
+        if (is_bool($enabled)) {
+            return $enabled;
+        }
+
+        return ! app()->isLocal();
+    }
+
+    private function version(): string
+    {
+        $version = config('docs.cache.version');
+
+        if (is_string($version) && $version !== '') {
+            return $version;
+        }
+
+        return 'v1';
+    }
+
+    private function lockTimeoutSeconds(): int
+    {
+        $timeout = config('docs.cache.lock_timeout_seconds');
+
+        if (is_int($timeout) && $timeout > 0) {
+            return $timeout;
+        }
+
+        return 5;
+    }
+
+    private function cacheFilePath(string $key): string
+    {
+        $hash = sha1($key);
+        $prefix = substr($hash, 0, 2);
+
+        return sprintf('%s/%s/%s.json', $this->path(), $prefix, $hash);
+    }
+
+    private function lockFilePath(string $key): string
+    {
+        $hash = sha1($key);
+
+        return sprintf('%s/.locks/%s.lock', $this->path(), $hash);
+    }
+
+    private function withLock(string $key, callable $callback): mixed
+    {
+        $lockFilePath = $this->lockFilePath($key);
+        $this->files->ensureDirectoryExists(dirname($lockFilePath));
+
+        $lockHandle = fopen($lockFilePath, 'c+');
+
+        if ($lockHandle === false) {
+            return $callback();
+        }
+
+        $timeoutAt = microtime(true) + $this->lockTimeoutSeconds();
+        $acquired = false;
+
+        do {
+            $acquired = flock($lockHandle, LOCK_EX | LOCK_NB);
+
+            if ($acquired) {
+                break;
+            }
+
+            usleep(50_000);
+        } while (microtime(true) < $timeoutAt);
+
+        if (! $acquired) {
+            fclose($lockHandle);
+
+            return $callback();
+        }
+
+        try {
+            return $callback();
+        } finally {
+            flock($lockHandle, LOCK_UN);
+            fclose($lockHandle);
+        }
+    }
+
+    private function normalizeSegment(mixed $segment): string
+    {
+        if (is_bool($segment)) {
+            return $segment ? 'true' : 'false';
+        }
+
+        if ($segment === null) {
+            return 'null';
+        }
+
+        if (is_scalar($segment)) {
+            return (string) $segment;
+        }
+
+        $encoded = json_encode($segment, JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE);
+
+        if ($encoded !== false) {
+            return $encoded;
+        }
+
+        return sha1(serialize($segment));
+    }
+}
diff --git a/app/Services/DocumentService.php b/app/Services/DocumentService.php
index f00dca3..ca4a788 100644
--- a/app/Services/DocumentService.php
+++ b/app/Services/DocumentService.php
@@ -10,6 +10,7 @@ public function __construct(
         private DocsPathService $docsPath,
         private MarkdownService $markdown,
         private HeadingExtractorService $headingExtractor,
+        private DocsOutputCacheService $docsOutputCache,
     ) {}
 
     /**
@@ -25,25 +26,7 @@ public function load(string $page): ?array
     {
         $filePath = sprintf('%s/%s.md', $this->docsPath->path(), $page);
 
-        if (! file_exists($filePath)) {
-            return null;
-        }
-
-        $content = file_get_contents($filePath);
-
-        if ($content === false) {
-            return null;
-        }
-
-        $html = $this->markdown->toHtml($content);
-        $headings = $this->headingExtractor->extract($html);
-        $title = $this->extractTitle($html, $page);
-
-        return [
-            'title' => $title,
-            'content' => $html,
-            'headings' => $headings,
-        ];
+        return $this->loadFromPath($filePath, "page:{$page}", $page);
     }
 
     /**
@@ -59,10 +42,39 @@ public function loadReadme(): ?array
     {
         $filePath = dirname($this->docsPath->path()).'/README.md';
 
+        return $this->loadFromPath($filePath, 'readme', 'README');
+    }
+
+    /**
+     * @return array{
+     *     title: string,
+     *     content: string,
+     *     headings: array<int, array{level: int, text: string, id: string}>
+     * }|null
+     */
+    private function loadFromPath(string $filePath, string $documentIdentity, string $titleFallback): ?array
+    {
         if (! file_exists($filePath)) {
             return null;
         }
 
+        $cacheKey = $this->docsOutputCache->key('document', [
+            $documentIdentity,
+            $this->fingerprint($filePath),
+        ]);
+
+        $cached = $this->docsOutputCache->get($cacheKey);
+
+        if (is_array($cached)) {
+            /** @var array{
+             *     title: string,
+             *     content: string,
+             *     headings: array<int, array{level: int, text: string, id: string}>
+             * } $cached
+             */
+            return $cached;
+        }
+
         $content = file_get_contents($filePath);
 
         if ($content === false) {
@@ -71,13 +83,25 @@ public function loadReadme(): ?array
 
         $html = $this->markdown->toHtml($content);
         $headings = $this->headingExtractor->extract($html);
-        $title = $this->extractTitle($html, 'README');
+        $title = $this->extractTitle($html, $titleFallback);
 
-        return [
+        $document = [
             'title' => $title,
             'content' => $html,
             'headings' => $headings,
         ];
+
+        $this->docsOutputCache->put($cacheKey, $document);
+
+        return $document;
+    }
+
+    private function fingerprint(string $path): string
+    {
+        $modifiedAt = filemtime($path);
+        $size = filesize($path);
+
+        return sprintf('%d:%d', $modifiedAt === false ? 0 : $modifiedAt, $size === false ? 0 : $size);
     }
 
     /**
diff --git a/config/docs.php b/config/docs.php
index 474fa05..5321b23 100644
--- a/config/docs.php
+++ b/config/docs.php
@@ -20,16 +20,19 @@
 
     /*
     |--------------------------------------------------------------------------
-    | Command Index
+    | Docs Output Cache
     |--------------------------------------------------------------------------
     |
-    | Cache TTL for the command index payload in seconds.
-    | Set this to 0 (or a negative value) to disable caching.
+    | Shared output cache for docs pages and command index payloads.
+    | This cache is file-backed and can be cleared via optimize:clear.
     |
     */
 
-    'command_index' => [
-        'cache_ttl_seconds' => (int) env('DOCS_COMMAND_INDEX_CACHE_TTL', 300),
+    'cache' => [
+        'enabled' => (bool) env('DOCS_CACHE_ENABLED', env('APP_ENV', 'local') !== 'local'),
+        'path' => env('DOCS_CACHE_PATH', storage_path('framework/cache/docs-output')),
+        'version' => env('DOCS_CACHE_VERSION', 'v1'),
+        'lock_timeout_seconds' => (int) env('DOCS_CACHE_LOCK_TIMEOUT_SECONDS', 5),
     ],
 
     /*
diff --git a/tests/Feature/CommandIndexPageTest.php b/tests/Feature/CommandIndexPageTest.php
index dd9874e..1ac71be 100644
--- a/tests/Feature/CommandIndexPageTest.php
+++ b/tests/Feature/CommandIndexPageTest.php
@@ -3,14 +3,20 @@
 declare(strict_types=1);
 
 use App\Services\CommandIndexService;
+use App\Services\DocsOutputCacheService;
 use App\Services\DocsPathService;
 use App\Services\TocParserService;
-use Illuminate\Support\Facades\Cache;
+
+beforeEach(function (): void {
+    config()->set('docs.cache.path', storage_path('framework/cache/docs-output-tests/'.uniqid('', true)));
+
+    app()->forgetInstance(DocsOutputCacheService::class);
+    app(DocsOutputCacheService::class)->clear();
+});
 
 it('renders the command index with discovered commands', function (): void {
     app()->forgetInstance(DocsPathService::class);
     app()->forgetInstance(CommandIndexService::class);
-    Cache::forget('command_index:v2');
 
     $response = $this->get(route('command-index'));
 
@@ -28,7 +34,6 @@
 it('does not render docs reference links for commands', function (): void {
     app()->forgetInstance(DocsPathService::class);
     app()->forgetInstance(CommandIndexService::class);
-    Cache::forget('command_index:v2');
 
     $response = $this->get(route('command-index'));
 
@@ -38,14 +43,18 @@
 });
 
 it('renders the empty-state message when no commands are available', function (): void {
-    Cache::forget('command_index:v2');
+    $docsOutputCache = app(DocsOutputCacheService::class);
 
-    Cache::put('command_index:v2', [
-        'sections' => [],
-        'groups' => [],
-        'commandCount' => 0,
-        'aliasCount' => 0,
-    ], now()->addMinutes(5));
+    $docsOutputCache->put(
+        $docsOutputCache->key('command-index'),
+        [
+            'toc' => [],
+            'sections' => [],
+            'groups' => [],
+            'commandCount' => 0,
+            'aliasCount' => 0,
+        ],
+    );
 
     $response = $this->get(route('command-index'));
 
@@ -57,7 +66,6 @@
     app()->forgetInstance(DocsPathService::class);
     app()->forgetInstance(TocParserService::class);
     app()->forgetInstance(CommandIndexService::class);
-    Cache::forget('command_index:v2');
 
     $response = $this->get(route('command-index'));
 
@@ -67,3 +75,70 @@
         ->assertSee('lg:grid-cols-[280px_1fr]', false)
         ->assertDontSee('lg:grid-cols-[280px_1fr_280px]', false);
 });
+
+it('uses cached command index payload when available', function (): void {
+    $docsOutputCache = app(DocsOutputCacheService::class);
+    $unresolvableDocsPath = storage_path('framework/testing/non-existent-docs-'.uniqid('', true));
+
+    config()->set('docs.path', $unresolvableDocsPath);
+    app()->forgetInstance(DocsPathService::class);
+    app()->forgetInstance(TocParserService::class);
+    app()->forgetInstance(CommandIndexService::class);
+
+    $docsOutputCache->put(
+        $docsOutputCache->key('command-index'),
+        [
+            'toc' => [
+                [
+                    'name' => 'Cached Nav',
+                    'anchor' => 'cached-nav',
+                    'links' => [
+                        ['title' => 'Cached Command Index', 'path' => 'command-index'],
+                    ],
+                ],
+            ],
+            'sections' => [
+                [
+                    'name' => 'Cached Section',
+                    'count' => 1,
+                    'namespaceCount' => 1,
+                    'groups' => [
+                        [
+                            'name' => 'Cached',
+                            'count' => 1,
+                            'commands' => [
+                                [
+                                    'primary' => 'cached:run',
+                                    'aliases' => [],
+                                    'description' => 'Cached command description',
+                                ],
+                            ],
+                        ],
+                    ],
+                ],
+            ],
+            'groups' => [
+                [
+                    'name' => 'Cached',
+                    'count' => 1,
+                    'commands' => [
+                        [
+                            'primary' => 'cached:run',
+                            'aliases' => [],
+                            'description' => 'Cached command description',
+                        ],
+                    ],
+                ],
+            ],
+            'commandCount' => 1,
+            'aliasCount' => 0,
+        ],
+    );
+
+    $response = $this->get(route('command-index'));
+
+    $response->assertOk()
+        ->assertSeeText('Cached Section')
+        ->assertSeeText('cached:run')
+        ->assertSeeText('Cached Nav');
+});
diff --git a/tests/Feature/DocsClearCommandTest.php b/tests/Feature/DocsClearCommandTest.php
new file mode 100644
index 0000000..376b59d
--- /dev/null
+++ b/tests/Feature/DocsClearCommandTest.php
@@ -0,0 +1,27 @@
+<?php
+
+declare(strict_types=1);
+
+use App\Services\DocsOutputCacheService;
+use Illuminate\Support\Facades\File;
+
+it('clears docs output when optimize clear runs', function (): void {
+    $cachePath = storage_path('framework/cache/docs-output-tests/'.uniqid('', true));
+
+    config()->set('docs.cache.path', $cachePath);
+
+    app()->forgetInstance(DocsOutputCacheService::class);
+
+    $docsOutput = app(DocsOutputCacheService::class);
+    $docsOutput->put(
+        $docsOutput->key('docs-viewer', ['home']),
+        ['title' => 'Cached'],
+    );
+
+    expect(File::allFiles($cachePath))->not->toBeEmpty();
+
+    $this->artisan('optimize:clear')->assertSuccessful();
+
+    expect(File::isDirectory($cachePath))->toBeTrue();
+    expect(File::allFiles($cachePath))->toBeEmpty();
+});
diff --git a/tests/Feature/DocsSidebarNavigationTest.php b/tests/Feature/DocsSidebarNavigationTest.php
index 0b824b3..1f23d22 100644
--- a/tests/Feature/DocsSidebarNavigationTest.php
+++ b/tests/Feature/DocsSidebarNavigationTest.php
@@ -2,10 +2,18 @@
 
 declare(strict_types=1);
 
+use App\Services\DocsOutputCacheService;
 use App\Services\DocsPathService;
 use App\Services\DocumentService;
 use App\Services\TocParserService;
 
+beforeEach(function (): void {
+    config()->set('docs.cache.path', storage_path('framework/cache/docs-output-tests/'.uniqid('', true)));
+
+    app()->forgetInstance(DocsOutputCacheService::class);
+    app(DocsOutputCacheService::class)->clear();
+});
+
 it('renders grouped sidebar navigation from documentation toc', function (): void {
     app()->forgetInstance(DocsPathService::class);
     app()->forgetInstance(TocParserService::class);
@@ -50,3 +58,42 @@
         ->assertRedirect('/')
         ->assertStatus(301);
 });
+
+it('uses cached docs viewer payload when available', function (): void {
+    $docsOutputCache = app(DocsOutputCacheService::class);
+    $unresolvableDocsPath = storage_path('framework/testing/non-existent-docs-'.uniqid('', true));
+
+    config()->set('docs.path', $unresolvableDocsPath);
+    app()->forgetInstance(DocsPathService::class);
+    app()->forgetInstance(TocParserService::class);
+    app()->forgetInstance(DocumentService::class);
+
+    $docsOutputCache->put(
+        $docsOutputCache->key('docs-viewer', ['home']),
+        [
+            'page' => '',
+            'title' => 'Cached Docs Title',
+            'content' => '<h1>Cached Docs Title</h1><p>Cached body.</p>',
+            'headings' => [],
+            'toc' => [
+                [
+                    'name' => 'Cached Section',
+                    'anchor' => 'cached-section',
+                    'links' => [
+                        [
+                            'title' => 'Cached Link',
+                            'path' => 'cached-link',
+                        ],
+                    ],
+                ],
+            ],
+        ],
+    );
+
+    $response = $this->get('/');
+
+    $response->assertOk()
+        ->assertSeeText('Cached Docs Title')
+        ->assertSeeText('Cached Section')
+        ->assertSeeText('Cached Link');
+});
diff --git a/tests/Feature/DocumentServiceCacheTest.php b/tests/Feature/DocumentServiceCacheTest.php
new file mode 100644
index 0000000..66d8dc0
--- /dev/null
+++ b/tests/Feature/DocumentServiceCacheTest.php
@@ -0,0 +1,56 @@
+<?php
+
+declare(strict_types=1);
+
+use App\Services\DocsOutputCacheService;
+use App\Services\DocumentService;
+use Illuminate\Support\Facades\File;
+
+it('reuses cached document payloads by file fingerprint', function (): void {
+    $docsPath = storage_path('framework/testing/docs-'.uniqid('', true));
+    $cachePath = storage_path('framework/cache/docs-output-tests/'.uniqid('', true));
+
+    File::ensureDirectoryExists($docsPath);
+    File::put("{$docsPath}/cached-page.md", "# Cached Page\n\nBody content");
+
+    config()->set('docs.path', $docsPath);
+    config()->set('docs.cache.path', $cachePath);
+
+    app()->forgetInstance(DocsOutputCacheService::class);
+    app()->forgetInstance(DocumentService::class);
+
+    $docsOutputCache = app(DocsOutputCacheService::class);
+    $documentService = app(DocumentService::class);
+
+    $firstLoad = $documentService->load('cached-page');
+
+    expect($firstLoad)->not->toBeNull();
+
+    $modifiedAt = filemtime("{$docsPath}/cached-page.md");
+    $size = filesize("{$docsPath}/cached-page.md");
+    $fingerprint = sprintf(
+        '%d:%d',
+        $modifiedAt === false ? 0 : $modifiedAt,
+        $size === false ? 0 : $size,
+    );
+
+    $docsOutputCache->put(
+        $docsOutputCache->key('document', ['page:cached-page', $fingerprint]),
+        [
+            'title' => 'From Cache',
+            'content' => '<h1>From Cache</h1><p>Cached document payload.</p>',
+            'headings' => [],
+        ],
+    );
+
+    $secondLoad = $documentService->load('cached-page');
+
+    expect($secondLoad)->toMatchArray([
+        'title' => 'From Cache',
+        'content' => '<h1>From Cache</h1><p>Cached document payload.</p>',
+        'headings' => [],
+    ]);
+
+    File::deleteDirectory($docsPath);
+    File::deleteDirectory($cachePath);
+});

From 3d1b0778eb1a66442d1e92b27fb661dba13079d6 Mon Sep 17 00:00:00 2001
From: Lucian Behind The Scenes <silviulucian@gmail.com>
Date: Fri, 20 Feb 2026 12:08:03 +0200
Subject: [PATCH 5/8] test: add comprehensive fixture-based test suite

Replaces real-docs-dependent tests with isolated fixture-based tests
using a shared UsesDocsFixtures concern. Adds full unit coverage for
all services (DocumentService, MarkdownService, HeadingExtractorService,
CommandIndexService, DocsOutputCacheService, TocParserService) and a
Livewire DocsViewer test. Removes superseded feature-level cache tests.
Simplifies Pest.php and ArchTest to match actual project structure.
---
 tests/Arch/ArchTest.php                       | 128 ++--------------
 tests/Concerns/UsesDocsFixtures.php           |  38 +++++
 tests/Feature/CommandIndexPageTest.php        |  95 +++---------
 tests/Feature/DocsRoutesSmokeTest.php         |  32 ++++
 tests/Feature/DocsSidebarNavigationTest.php   |  87 +++--------
 tests/Feature/DocumentServiceCacheTest.php    |  56 -------
 tests/Feature/MarkdownServiceTest.php         |  40 -----
 tests/Fixtures/docs/README.md                 |   5 +
 .../app/Console/Commands/FakeCloudCommand.php |  10 ++
 .../app/Console/Commands/FakeOtherCommand.php |  10 ++
 .../Console/Commands/FakeServerCommand.php    |  10 ++
 .../app/Console/Commands/InvalidCommand.php   |   7 +
 tests/Fixtures/docs/docs/documentation.md     |  10 ++
 tests/Fixtures/docs/docs/installation.md      |  10 ++
 tests/Fixtures/docs/docs/link-behavior.md     |  12 ++
 tests/Pest.php                                |  44 ------
 tests/Unit/CommandIndexServiceTest.php        |  54 +++++++
 tests/Unit/DocsOutputCacheServiceTest.php     | 145 ++++++++++++++++++
 tests/Unit/DocumentServiceTest.php            |  86 +++++++++++
 tests/Unit/HeadingExtractorServiceTest.php    |  48 ++++++
 tests/Unit/Livewire/DocsViewerTest.php        |  68 ++++++++
 tests/Unit/MarkdownServiceTest.php            | 118 ++++++++++++++
 tests/Unit/TocParserServiceTest.php           | 105 ++++++++++---
 23 files changed, 801 insertions(+), 417 deletions(-)
 create mode 100644 tests/Concerns/UsesDocsFixtures.php
 create mode 100644 tests/Feature/DocsRoutesSmokeTest.php
 delete mode 100644 tests/Feature/DocumentServiceCacheTest.php
 delete mode 100644 tests/Feature/MarkdownServiceTest.php
 create mode 100644 tests/Fixtures/docs/README.md
 create mode 100644 tests/Fixtures/docs/app/Console/Commands/FakeCloudCommand.php
 create mode 100644 tests/Fixtures/docs/app/Console/Commands/FakeOtherCommand.php
 create mode 100644 tests/Fixtures/docs/app/Console/Commands/FakeServerCommand.php
 create mode 100644 tests/Fixtures/docs/app/Console/Commands/InvalidCommand.php
 create mode 100644 tests/Fixtures/docs/docs/documentation.md
 create mode 100644 tests/Fixtures/docs/docs/installation.md
 create mode 100644 tests/Fixtures/docs/docs/link-behavior.md
 create mode 100644 tests/Unit/CommandIndexServiceTest.php
 create mode 100644 tests/Unit/DocsOutputCacheServiceTest.php
 create mode 100644 tests/Unit/DocumentServiceTest.php
 create mode 100644 tests/Unit/HeadingExtractorServiceTest.php
 create mode 100644 tests/Unit/Livewire/DocsViewerTest.php
 create mode 100644 tests/Unit/MarkdownServiceTest.php

diff --git a/tests/Arch/ArchTest.php b/tests/Arch/ArchTest.php
index d0d2cf3..2a1c820 100644
--- a/tests/Arch/ArchTest.php
+++ b/tests/Arch/ArchTest.php
@@ -2,10 +2,6 @@
 
 declare(strict_types=1);
 
-//
-// Global Debugging Prevention
-// ----
-
 arch()
     ->expect('App')
     ->not->toUse([
@@ -17,129 +13,27 @@
         'exit',
     ]);
 
-//
-// Preset Architecture Rules
-// ----
-
 arch()->preset()->php();
 arch()->preset()->laravel();
-arch()->preset()->security();
-
-//
-// Strict Layered Architecture Enforcement
-// ----
-
-// Layer 1: Controllers must NOT directly use Models or Repositories
-arch()
-    ->expect('App\Http\Controllers')
-    ->not->toUse([
-        'App\Models',
-        'App\Repositories',
-        'App\Services',
-        'Illuminate\Database\Eloquent',
-    ]);
-
-// Layer 1: Livewire Components must NOT directly use Models or Repositories
-arch()
-    ->expect('App\Livewire')
-    ->not->toUse([
-        'App\Models',
-        'App\Repositories',
-        'App\Services',
-        'Illuminate\Database\Eloquent',
-    ]);
-
-// Layer 2: Actions must NOT directly use Models or Repositories
-arch()
-    ->expect('App\Actions')
-    ->not->toUse([
-        'App\Models',
-        'App\Repositories',
-        'Illuminate\Database\Eloquent',
-    ]);
-
-// Layer 2: Services must NOT directly use Models (should use Repositories) or Actions
-arch()
-    ->expect('App\Services')
-    ->not->toUse([
-        'App\Actions',
-        'App\Models',
-        'Illuminate\Database\Eloquent',
-    ]);
-
-//
-// Directory Structure Enforcement
-// ----
 
 arch()
-    ->expect('App\Models')
-    ->toExtend(\Illuminate\Database\Eloquent\Model::class);
+    ->expect('App\\Http\\Controllers')
+    ->toHaveSuffix('Controller')
+    ->toExtend(\App\Http\Controllers\Controller::class);
 
 arch()
-    ->expect('App\Exceptions')
-    ->toExtend('Exception');
-
-//
-// Naming Conventions Enforcement
-// ----
+    ->expect('App\\Livewire')
+    ->toExtend(\Livewire\Component::class);
 
 arch()
-    ->expect('App\Http\Controllers')
-    ->toHaveSuffix('Controller');
-
-arch()
-    ->expect('App\Actions')
-    ->toHaveSuffix('Action');
-
-arch()
-    ->expect('App\Services')
+    ->expect('App\\Services')
     ->toHaveSuffix('Service');
 
 arch()
-    ->expect('App\Repositories')
-    ->toHaveSuffix('Repository');
-
-arch()
-    ->expect('App\Exceptions')
-    ->toHaveSuffix('Exception');
-
-//
-// Interface and Contract Enforcement
-// ----
-
-arch()
-    ->expect('App\Repositories')
+    ->expect('App\\Repositories')
+    ->toHaveSuffix('Repository')
     ->toImplement(\App\Contracts\RepositoryInterface::class);
 
-//
-// Conditional Architecture Tests
-// ----
-
-// For conditional tests that require complex logic, we keep traditional test format
-it('controllers extend base controller when it exists', function (): void {
-    if (class_exists(\App\Http\Controllers\Controller::class)) {
-        arch()
-            ->expect('App\Http\Controllers')
-            ->toExtend(\App\Http\Controllers\Controller::class);
-    } else {
-        expect(true)->toBeTrue(); // Skip if base controller doesn't exist
-    }
-});
-
-it('livewire components extend base component when livewire is installed', function (): void {
-    if (class_exists(\Livewire\Component::class)) {
-        arch()
-            ->expect('App\Livewire')
-            ->toExtend(\Livewire\Component::class);
-    } else {
-        expect(true)->toBeTrue(); // Skip if Livewire not installed
-    }
-});
-
-it('services implement service contracts when defined', function (): void {
-    arch()
-        ->expect('App\Services')
-        ->classes()
-        ->when(fn (ReflectionClass $class): bool => interface_exists("App\\Contracts\\{$class->getShortName()}Interface"))
-        ->toImplement(fn (ReflectionClass $class): string => "App\\Contracts\\{$class->getShortName()}Interface");
-});
+arch()
+    ->expect('App\\Models')
+    ->toExtend(\Illuminate\Database\Eloquent\Model::class);
diff --git a/tests/Concerns/UsesDocsFixtures.php b/tests/Concerns/UsesDocsFixtures.php
new file mode 100644
index 0000000..13c8258
--- /dev/null
+++ b/tests/Concerns/UsesDocsFixtures.php
@@ -0,0 +1,38 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Tests\Concerns;
+
+use App\Services\CommandIndexService;
+use App\Services\DocsOutputCacheService;
+use App\Services\DocsPathService;
+use App\Services\DocumentService;
+use App\Services\TocParserService;
+
+trait UsesDocsFixtures
+{
+    protected function configureDocsFixtures(?string $cacheSuffix = null): void
+    {
+        $root = $this->docsFixtureRoot();
+        $cachePath = storage_path('framework/cache/docs-output-tests/'.($cacheSuffix ?? uniqid('', true)));
+
+        config()->set('docs.path', "{$root}/docs");
+        config()->set('docs.cache.path', $cachePath);
+        config()->set('docs.cache.enabled', true);
+        config()->set('docs.cache.version', 'v1');
+
+        app()->forgetInstance(DocsPathService::class);
+        app()->forgetInstance(DocsOutputCacheService::class);
+        app()->forgetInstance(TocParserService::class);
+        app()->forgetInstance(DocumentService::class);
+        app()->forgetInstance(CommandIndexService::class);
+
+        app(DocsOutputCacheService::class)->clear();
+    }
+
+    protected function docsFixtureRoot(): string
+    {
+        return base_path('tests/Fixtures/docs');
+    }
+}
diff --git a/tests/Feature/CommandIndexPageTest.php b/tests/Feature/CommandIndexPageTest.php
index 1ac71be..bbb3a54 100644
--- a/tests/Feature/CommandIndexPageTest.php
+++ b/tests/Feature/CommandIndexPageTest.php
@@ -6,92 +6,37 @@
 use App\Services\DocsOutputCacheService;
 use App\Services\DocsPathService;
 use App\Services\TocParserService;
+use Tests\Concerns\UsesDocsFixtures;
 
-beforeEach(function (): void {
-    config()->set('docs.cache.path', storage_path('framework/cache/docs-output-tests/'.uniqid('', true)));
-
-    app()->forgetInstance(DocsOutputCacheService::class);
-    app(DocsOutputCacheService::class)->clear();
-});
-
-it('renders the command index with discovered commands', function (): void {
-    app()->forgetInstance(DocsPathService::class);
-    app()->forgetInstance(CommandIndexService::class);
-
-    $response = $this->get(route('command-index'));
-
-    $response->assertOk()
-        ->assertSee('Command Index')
-        ->assertSeeText('Server & Site Operations')
-        ->assertSeeText('Scheduling & Process Control')
-        ->assertSeeText('Web Runtime Services')
-        ->assertSeeText('Data Services')
-        ->assertSeeText('Cloud Providers')
-        ->assertSee('server:add')
-        ->assertSee('site:deploy');
-});
+uses(UsesDocsFixtures::class);
 
-it('does not render docs reference links for commands', function (): void {
-    app()->forgetInstance(DocsPathService::class);
-    app()->forgetInstance(CommandIndexService::class);
-
-    $response = $this->get(route('command-index'));
-
-    $response->assertOk()
-        ->assertSeeText('site:delete')
-        ->assertDontSee(route('docs.show', ['page' => 'managing-sites']).'#deleting-a-site', false);
-});
-
-it('renders the empty-state message when no commands are available', function (): void {
-    $docsOutputCache = app(DocsOutputCacheService::class);
-
-    $docsOutputCache->put(
-        $docsOutputCache->key('command-index'),
-        [
-            'toc' => [],
-            'sections' => [],
-            'groups' => [],
-            'commandCount' => 0,
-            'aliasCount' => 0,
-        ],
-    );
-
-    $response = $this->get(route('command-index'));
-
-    $response->assertOk()
-        ->assertSeeText('No commands were discovered for the configured docs path.');
+beforeEach(function (): void {
+    $this->configureDocsFixtures();
 });
 
-it('renders the docs-style single sidebar layout', function (): void {
+it('renders the command index using fixture commands', function (): void {
     app()->forgetInstance(DocsPathService::class);
-    app()->forgetInstance(TocParserService::class);
     app()->forgetInstance(CommandIndexService::class);
 
     $response = $this->get(route('command-index'));
 
     $response->assertOk()
-        ->assertSee('href="'.route('home').'"', false)
-        ->assertSeeText('Guides')
-        ->assertSee('lg:grid-cols-[280px_1fr]', false)
-        ->assertDontSee('lg:grid-cols-[280px_1fr_280px]', false);
+        ->assertSeeText('Command Index')
+        ->assertSeeText('server:add')
+        ->assertSeeText('aws:region')
+        ->assertSeeText('custom-task');
 });
 
-it('uses cached command index payload when available', function (): void {
+it('uses cached command index payload when docs are unavailable', function (): void {
     $docsOutputCache = app(DocsOutputCacheService::class);
-    $unresolvableDocsPath = storage_path('framework/testing/non-existent-docs-'.uniqid('', true));
-
-    config()->set('docs.path', $unresolvableDocsPath);
-    app()->forgetInstance(DocsPathService::class);
-    app()->forgetInstance(TocParserService::class);
-    app()->forgetInstance(CommandIndexService::class);
 
     $docsOutputCache->put(
         $docsOutputCache->key('command-index'),
         [
             'toc' => [
                 [
-                    'name' => 'Cached Nav',
-                    'anchor' => 'cached-nav',
+                    'name' => 'Cached',
+                    'anchor' => 'cached',
                     'links' => [
                         ['title' => 'Cached Command Index', 'path' => 'command-index'],
                     ],
@@ -104,13 +49,13 @@
                     'namespaceCount' => 1,
                     'groups' => [
                         [
-                            'name' => 'Cached',
+                            'name' => 'Cached Group',
                             'count' => 1,
                             'commands' => [
                                 [
                                     'primary' => 'cached:run',
                                     'aliases' => [],
-                                    'description' => 'Cached command description',
+                                    'description' => 'Cached command',
                                 ],
                             ],
                         ],
@@ -119,13 +64,13 @@
             ],
             'groups' => [
                 [
-                    'name' => 'Cached',
+                    'name' => 'Cached Group',
                     'count' => 1,
                     'commands' => [
                         [
                             'primary' => 'cached:run',
                             'aliases' => [],
-                            'description' => 'Cached command description',
+                            'description' => 'Cached command',
                         ],
                     ],
                 ],
@@ -135,10 +80,14 @@
         ],
     );
 
+    config()->set('docs.path', storage_path('framework/testing/missing-docs-'.uniqid('', true)));
+    app()->forgetInstance(DocsPathService::class);
+    app()->forgetInstance(TocParserService::class);
+    app()->forgetInstance(CommandIndexService::class);
+
     $response = $this->get(route('command-index'));
 
     $response->assertOk()
         ->assertSeeText('Cached Section')
-        ->assertSeeText('cached:run')
-        ->assertSeeText('Cached Nav');
+        ->assertSeeText('cached:run');
 });
diff --git a/tests/Feature/DocsRoutesSmokeTest.php b/tests/Feature/DocsRoutesSmokeTest.php
new file mode 100644
index 0000000..ee10a36
--- /dev/null
+++ b/tests/Feature/DocsRoutesSmokeTest.php
@@ -0,0 +1,32 @@
+<?php
+
+declare(strict_types=1);
+
+use Tests\Concerns\UsesDocsFixtures;
+
+uses(UsesDocsFixtures::class);
+
+beforeEach(function (): void {
+    $this->configureDocsFixtures();
+});
+
+it('exposes the docs home route', function (): void {
+    $this->get(route('home'))
+        ->assertOk()
+        ->assertSeeText('Fixture Documentation Home');
+});
+
+it('exposes the command index route', function (): void {
+    $this->get(route('command-index'))
+        ->assertOk()
+        ->assertSeeText('Command Index');
+});
+
+it('redirects docs index routes to home', function (string $uri): void {
+    $this->get($uri)
+        ->assertRedirect(route('home'))
+        ->assertMovedPermanently();
+})->with([
+    '/docs',
+    '/docs/',
+]);
diff --git a/tests/Feature/DocsSidebarNavigationTest.php b/tests/Feature/DocsSidebarNavigationTest.php
index 1f23d22..812b9a9 100644
--- a/tests/Feature/DocsSidebarNavigationTest.php
+++ b/tests/Feature/DocsSidebarNavigationTest.php
@@ -2,98 +2,49 @@
 
 declare(strict_types=1);
 
-use App\Services\DocsOutputCacheService;
 use App\Services\DocsPathService;
 use App\Services\DocumentService;
 use App\Services\TocParserService;
+use Tests\Concerns\UsesDocsFixtures;
 
-beforeEach(function (): void {
-    config()->set('docs.cache.path', storage_path('framework/cache/docs-output-tests/'.uniqid('', true)));
+uses(UsesDocsFixtures::class);
 
-    app()->forgetInstance(DocsOutputCacheService::class);
-    app(DocsOutputCacheService::class)->clear();
+beforeEach(function (): void {
+    $this->configureDocsFixtures();
 });
 
-it('renders grouped sidebar navigation from documentation toc', function (): void {
+it('renders fixture toc links on docs home', function (): void {
     app()->forgetInstance(DocsPathService::class);
     app()->forgetInstance(TocParserService::class);
     app()->forgetInstance(DocumentService::class);
 
-    $response = $this->get('/');
+    $response = $this->get(route('home'));
 
     $response->assertOk()
-        ->assertSeeInOrder([
-            'Guides',
-            'Introduction',
-            'Installation',
-            'Zero to Deploy',
-            'References',
-            'Managing Sites',
-            'Managing Servers',
-            'Managing Services',
-            'Managing Databases',
-            'Cloud Providers',
-            'Automation & AI',
-            'Index',
-            'Command Index',
-        ])
-        ->assertSee('href="'.route('home').'"', false)
+        ->assertSeeText('Guides')
+        ->assertSeeText('Installation')
         ->assertSee('href="'.route('docs.show', ['page' => 'installation']).'"', false)
-        ->assertSee('href="'.route('docs.show', ['page' => 'managing-services']).'"', false);
-
-    $content = $response->getContent();
-
-    expect($content)->not->toBeFalse();
-    expect((string) $content)
-        ->toMatch('/<a[^>]*href="'.preg_quote(route('command-index'), '/').'"[^>]*wire:navigate(?:="")?[^>]*>/')
-        ->not->toMatch('/<a[^>]*href="'.preg_quote(route('command-index'), '/').'"[^>]*target="_blank"[^>]*>/');
+        ->assertSee('href="'.route('command-index').'"', false);
 });
 
-it('redirects missing docs pages to the docs home', function (): void {
+it('renders a fixture docs page', function (): void {
     app()->forgetInstance(DocsPathService::class);
     app()->forgetInstance(TocParserService::class);
     app()->forgetInstance(DocumentService::class);
 
-    $this->get('/docs/introduction')
-        ->assertRedirect('/')
-        ->assertStatus(301);
-});
+    $response = $this->get(route('docs.show', ['page' => 'installation']));
 
-it('uses cached docs viewer payload when available', function (): void {
-    $docsOutputCache = app(DocsOutputCacheService::class);
-    $unresolvableDocsPath = storage_path('framework/testing/non-existent-docs-'.uniqid('', true));
+    $response->assertOk()
+        ->assertSeeText('Installation')
+        ->assertSeeText('Requirements');
+});
 
-    config()->set('docs.path', $unresolvableDocsPath);
+it('redirects missing docs pages to the docs home', function (): void {
     app()->forgetInstance(DocsPathService::class);
     app()->forgetInstance(TocParserService::class);
     app()->forgetInstance(DocumentService::class);
 
-    $docsOutputCache->put(
-        $docsOutputCache->key('docs-viewer', ['home']),
-        [
-            'page' => '',
-            'title' => 'Cached Docs Title',
-            'content' => '<h1>Cached Docs Title</h1><p>Cached body.</p>',
-            'headings' => [],
-            'toc' => [
-                [
-                    'name' => 'Cached Section',
-                    'anchor' => 'cached-section',
-                    'links' => [
-                        [
-                            'title' => 'Cached Link',
-                            'path' => 'cached-link',
-                        ],
-                    ],
-                ],
-            ],
-        ],
-    );
-
-    $response = $this->get('/');
-
-    $response->assertOk()
-        ->assertSeeText('Cached Docs Title')
-        ->assertSeeText('Cached Section')
-        ->assertSeeText('Cached Link');
+    $this->get(route('docs.show', ['page' => 'does-not-exist']))
+        ->assertRedirect(route('home'))
+        ->assertMovedPermanently();
 });
diff --git a/tests/Feature/DocumentServiceCacheTest.php b/tests/Feature/DocumentServiceCacheTest.php
deleted file mode 100644
index 66d8dc0..0000000
--- a/tests/Feature/DocumentServiceCacheTest.php
+++ /dev/null
@@ -1,56 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-use App\Services\DocsOutputCacheService;
-use App\Services\DocumentService;
-use Illuminate\Support\Facades\File;
-
-it('reuses cached document payloads by file fingerprint', function (): void {
-    $docsPath = storage_path('framework/testing/docs-'.uniqid('', true));
-    $cachePath = storage_path('framework/cache/docs-output-tests/'.uniqid('', true));
-
-    File::ensureDirectoryExists($docsPath);
-    File::put("{$docsPath}/cached-page.md", "# Cached Page\n\nBody content");
-
-    config()->set('docs.path', $docsPath);
-    config()->set('docs.cache.path', $cachePath);
-
-    app()->forgetInstance(DocsOutputCacheService::class);
-    app()->forgetInstance(DocumentService::class);
-
-    $docsOutputCache = app(DocsOutputCacheService::class);
-    $documentService = app(DocumentService::class);
-
-    $firstLoad = $documentService->load('cached-page');
-
-    expect($firstLoad)->not->toBeNull();
-
-    $modifiedAt = filemtime("{$docsPath}/cached-page.md");
-    $size = filesize("{$docsPath}/cached-page.md");
-    $fingerprint = sprintf(
-        '%d:%d',
-        $modifiedAt === false ? 0 : $modifiedAt,
-        $size === false ? 0 : $size,
-    );
-
-    $docsOutputCache->put(
-        $docsOutputCache->key('document', ['page:cached-page', $fingerprint]),
-        [
-            'title' => 'From Cache',
-            'content' => '<h1>From Cache</h1><p>Cached document payload.</p>',
-            'headings' => [],
-        ],
-    );
-
-    $secondLoad = $documentService->load('cached-page');
-
-    expect($secondLoad)->toMatchArray([
-        'title' => 'From Cache',
-        'content' => '<h1>From Cache</h1><p>Cached document payload.</p>',
-        'headings' => [],
-    ]);
-
-    File::deleteDirectory($docsPath);
-    File::deleteDirectory($cachePath);
-});
diff --git a/tests/Feature/MarkdownServiceTest.php b/tests/Feature/MarkdownServiceTest.php
deleted file mode 100644
index 96c3076..0000000
--- a/tests/Feature/MarkdownServiceTest.php
+++ /dev/null
@@ -1,40 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-use App\Services\MarkdownService;
-
-it('renders important github alerts with additional block content', function (): void {
-    $markdown = <<<'MARKDOWN'
-> [!IMPORTANT]
-> First important callout.
->
-> - First item
-> - Second item
->
-> Another paragraph.
-MARKDOWN;
-
-    $html = app(MarkdownService::class)->toHtml($markdown);
-
-    expect(substr_count($html, 'dark:border-l-amber-400'))->toBe(1)
-        ->and(substr_count($html, '<svg'))->toBe(1)
-        ->and($html)->toContain('<ul>')
-        ->toContain('<li>First item</li>')
-        ->toContain('<li>Second item</li>');
-});
-
-it('renders multiple important github alerts on the same page', function (): void {
-    $markdown = <<<'MARKDOWN'
-> [!IMPORTANT]
-> First important callout.
-
-> [!IMPORTANT]
-> Second important callout.
-MARKDOWN;
-
-    $html = app(MarkdownService::class)->toHtml($markdown);
-
-    expect(substr_count($html, 'dark:border-l-amber-400'))->toBe(2)
-        ->and(substr_count($html, '<svg'))->toBe(2);
-});
diff --git a/tests/Fixtures/docs/README.md b/tests/Fixtures/docs/README.md
new file mode 100644
index 0000000..0af3dd4
--- /dev/null
+++ b/tests/Fixtures/docs/README.md
@@ -0,0 +1,5 @@
+# Fixture Documentation Home
+
+Welcome to the fixture-based docs home.
+
+See [Installation](/docs/installation) and [External Guide](guides/setup).
diff --git a/tests/Fixtures/docs/app/Console/Commands/FakeCloudCommand.php b/tests/Fixtures/docs/app/Console/Commands/FakeCloudCommand.php
new file mode 100644
index 0000000..c1efd8e
--- /dev/null
+++ b/tests/Fixtures/docs/app/Console/Commands/FakeCloudCommand.php
@@ -0,0 +1,10 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Tests\Fixtures\Docs\App\Console\Commands;
+
+use Symfony\Component\Console\Attribute\AsCommand;
+
+#[AsCommand(name: 'aws:region', description: 'List AWS regions.')]
+final class FakeCloudCommand {}
diff --git a/tests/Fixtures/docs/app/Console/Commands/FakeOtherCommand.php b/tests/Fixtures/docs/app/Console/Commands/FakeOtherCommand.php
new file mode 100644
index 0000000..221ce05
--- /dev/null
+++ b/tests/Fixtures/docs/app/Console/Commands/FakeOtherCommand.php
@@ -0,0 +1,10 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Tests\Fixtures\Docs\App\Console\Commands;
+
+use Symfony\Component\Console\Attribute\AsCommand;
+
+#[AsCommand(name: 'custom-task', description: 'Run a custom task.')]
+final class FakeOtherCommand {}
diff --git a/tests/Fixtures/docs/app/Console/Commands/FakeServerCommand.php b/tests/Fixtures/docs/app/Console/Commands/FakeServerCommand.php
new file mode 100644
index 0000000..62c444c
--- /dev/null
+++ b/tests/Fixtures/docs/app/Console/Commands/FakeServerCommand.php
@@ -0,0 +1,10 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Tests\Fixtures\Docs\App\Console\Commands;
+
+use Symfony\Component\Console\Attribute\AsCommand;
+
+#[AsCommand(name: 'server:add|server:create', description: 'Create a server.')]
+final class FakeServerCommand {}
diff --git a/tests/Fixtures/docs/app/Console/Commands/InvalidCommand.php b/tests/Fixtures/docs/app/Console/Commands/InvalidCommand.php
new file mode 100644
index 0000000..2d8ac7c
--- /dev/null
+++ b/tests/Fixtures/docs/app/Console/Commands/InvalidCommand.php
@@ -0,0 +1,7 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Tests\Fixtures\Docs\App\Console\Commands;
+
+final class InvalidCommand {}
diff --git a/tests/Fixtures/docs/docs/documentation.md b/tests/Fixtures/docs/docs/documentation.md
new file mode 100644
index 0000000..27a3321
--- /dev/null
+++ b/tests/Fixtures/docs/docs/documentation.md
@@ -0,0 +1,10 @@
+<a name="guides"></a>
+## Guides
+- [Introduction](README.md)
+- [Installation](installation.md)
+- [Link Behavior](link-behavior.md)
+
+<a name="references"></a>
+## References
+- [Command Index](command-index.md)
+- [Operations](operations/runbooks.md)
diff --git a/tests/Fixtures/docs/docs/installation.md b/tests/Fixtures/docs/docs/installation.md
new file mode 100644
index 0000000..ac3e7f0
--- /dev/null
+++ b/tests/Fixtures/docs/docs/installation.md
@@ -0,0 +1,10 @@
+# Installation
+
+Install the application.
+
+## Requirements
+PHP 8.5+
+
+## Steps
+1. Copy env.
+2. Run composer install.
diff --git a/tests/Fixtures/docs/docs/link-behavior.md b/tests/Fixtures/docs/docs/link-behavior.md
new file mode 100644
index 0000000..3fcf2e1
--- /dev/null
+++ b/tests/Fixtures/docs/docs/link-behavior.md
@@ -0,0 +1,12 @@
+# Link Behavior
+
+[Home Docs Link](/docs)
+[Install Relative](docs/installation)
+[GitHub Relative](guides/setup)
+[GitHub Root](/CONTRIBUTING)
+[Anchor](#local-anchor)
+[External](https://example.com/docs)
+
+```bash nocopy
+php artisan test
+```
diff --git a/tests/Pest.php b/tests/Pest.php
index 562545e..cb99f7b 100644
--- a/tests/Pest.php
+++ b/tests/Pest.php
@@ -2,55 +2,11 @@
 
 declare(strict_types=1);
 
-/*
-|--------------------------------------------------------------------------
-| Test Case
-|--------------------------------------------------------------------------
-|
-| The closure you provide to your test functions is always bound to a specific PHPUnit test
-| case class. By default, that class is "PHPUnit\Framework\TestCase". Of course, you may
-| need to change it using the "pest()" function to bind a different classes or traits.
-|
-*/
-
-// Architecture Tests: Architecture rules and best practices
 pest()->extend(Tests\TestCase::class)
     ->in('Arch');
 
-// Feature Tests: Full HTTP stack end-to-end tests
 pest()->extend(Tests\FeatureTestCase::class)
-    ->use(Illuminate\Foundation\Testing\RefreshDatabase::class)
     ->in('Feature');
 
-// Unit Tests: Pure business logic, mocked dependencies, no database
 pest()->extend(Tests\TestCase::class)
     ->in('Unit');
-
-/*
-|--------------------------------------------------------------------------
-| Expectations
-|--------------------------------------------------------------------------
-|
-| When you're writing tests, you often need to check that values meet certain conditions. The
-| "expect()" function gives you access to a set of "expectations" methods that you can use
-| to assert different things. Of course, you may extend the Expectation API at any time.
-|
-*/
-
-expect()->extend('toBeOne', fn () => $this->toBe(1));
-
-/*
-|--------------------------------------------------------------------------
-| Functions
-|--------------------------------------------------------------------------
-|
-| While Pest is very powerful out-of-the-box, you may have some testing code specific to your
-| project that you don't want to repeat in every file. Here you can also expose helpers as
-| global functions to help you to reduce the number of lines of code in your test files.
-|
-*/
-
-function something()
-{
-    // ..
-}
diff --git a/tests/Unit/CommandIndexServiceTest.php b/tests/Unit/CommandIndexServiceTest.php
new file mode 100644
index 0000000..66879cc
--- /dev/null
+++ b/tests/Unit/CommandIndexServiceTest.php
@@ -0,0 +1,54 @@
+<?php
+
+declare(strict_types=1);
+
+use App\Services\CommandIndexService;
+use App\Services\DocsPathService;
+use Tests\Concerns\UsesDocsFixtures;
+
+uses(UsesDocsFixtures::class);
+
+beforeEach(function (): void {
+    $this->configureDocsFixtures();
+});
+
+it('builds grouped command index data from fixture command classes', function (): void {
+    $index = app(CommandIndexService::class)->build();
+
+    expect($index['commandCount'])->toBe(3)
+        ->and($index['aliasCount'])->toBe(1)
+        ->and($index['groups'])->toHaveCount(3)
+        ->and($index['groups'][0]['name'])->toBe('AWS')
+        ->and($index['groups'][1]['name'])->toBe('Custom-task')
+        ->and($index['groups'][2]['name'])->toBe('Server');
+
+    $commands = collect($index['groups'])->pluck('commands')->flatten(1)->pluck('primary')->all();
+
+    expect($commands)->toBe([
+        'aws:region',
+        'custom-task',
+        'server:add',
+    ]);
+});
+
+it('maps namespaces into ordered related sections', function (): void {
+    $sections = app(CommandIndexService::class)->build()['sections'];
+
+    expect(array_column($sections, 'name'))->toBe([
+        'Server & Site Operations',
+        'Cloud Providers',
+        'Other',
+    ]);
+});
+
+it('falls back to vendor console commands when docs console path is unavailable', function (): void {
+    config()->set('docs.path', storage_path('framework/testing/no-console-'.uniqid('', true)));
+    app()->forgetInstance(DocsPathService::class);
+    app()->forgetInstance(CommandIndexService::class);
+
+    $index = app(CommandIndexService::class)->build();
+
+    expect($index['commandCount'])->toBeGreaterThan(0)
+        ->and($index['sections'])->not->toBeEmpty()
+        ->and($index['groups'])->not->toBeEmpty();
+});
diff --git a/tests/Unit/DocsOutputCacheServiceTest.php b/tests/Unit/DocsOutputCacheServiceTest.php
new file mode 100644
index 0000000..27fd9a1
--- /dev/null
+++ b/tests/Unit/DocsOutputCacheServiceTest.php
@@ -0,0 +1,145 @@
+<?php
+
+declare(strict_types=1);
+
+use App\Services\DocsOutputCacheService;
+use Illuminate\Support\Facades\File;
+
+beforeEach(function (): void {
+    config()->set('docs.cache.enabled', true);
+    config()->set('docs.cache.version', 'v1');
+    config()->set('docs.cache.path', storage_path('framework/cache/docs-output-tests/'.uniqid('', true)));
+
+    app()->forgetInstance(DocsOutputCacheService::class);
+
+    app(DocsOutputCacheService::class)->clear();
+});
+
+it('builds stable cache keys from normalized segments', function (): void {
+    $service = app(DocsOutputCacheService::class);
+
+    $key = $service->key('docs-viewer', [true, false, null, ['page' => 'home']]);
+
+    expect($key)
+        ->toContain('v1:docs-viewer:true:false:null')
+        ->toContain('{"page":"home"}');
+});
+
+it('persists and retrieves cache payloads', function (): void {
+    $service = app(DocsOutputCacheService::class);
+    $key = $service->key('document', ['page:installation']);
+
+    $service->put($key, ['title' => 'Installation']);
+
+    expect($service->get($key))->toBe(['title' => 'Installation']);
+});
+
+it('returns null for stale versioned payloads', function (): void {
+    $service = app(DocsOutputCacheService::class);
+    $key = $service->key('document', ['page:installation']);
+
+    $service->put($key, ['title' => 'Installation']);
+
+    config()->set('docs.cache.version', 'v2');
+    app()->forgetInstance(DocsOutputCacheService::class);
+
+    expect(app(DocsOutputCacheService::class)->get($key))->toBeNull();
+});
+
+it('returns null for key mismatches and invalid payloads', function (): void {
+    $service = app(DocsOutputCacheService::class);
+    $key = $service->key('document', ['page:installation']);
+
+    $hash = sha1($key);
+    $path = config('docs.cache.path').'/'.substr($hash, 0, 2)."/{$hash}.json";
+
+    File::ensureDirectoryExists(dirname($path));
+    File::put($path, '{bad json');
+
+    expect($service->get($key))->toBeNull();
+
+    File::put($path, json_encode([
+        'version' => 'v1',
+        'key' => 'different-key',
+        'value' => ['title' => 'Wrong'],
+    ], JSON_UNESCAPED_SLASHES));
+
+    expect($service->get($key))->toBeNull();
+});
+
+it('bypasses cache reads and writes when disabled', function (): void {
+    config()->set('docs.cache.enabled', false);
+    app()->forgetInstance(DocsOutputCacheService::class);
+
+    $service = app(DocsOutputCacheService::class);
+    $key = $service->key('document', ['page:installation']);
+
+    $service->put($key, ['title' => 'Installation']);
+
+    expect($service->get($key))->toBeNull();
+
+    $calls = 0;
+
+    $first = $service->remember($key, function () use (&$calls): array {
+        $calls++;
+
+        return ['title' => 'A'];
+    });
+
+    $second = $service->remember($key, function () use (&$calls): array {
+        $calls++;
+
+        return ['title' => 'B'];
+    });
+
+    expect($first)->toBe(['title' => 'A'])
+        ->and($second)->toBe(['title' => 'B'])
+        ->and($calls)->toBe(2);
+});
+
+it('memoizes resolver values with remember when enabled', function (): void {
+    $service = app(DocsOutputCacheService::class);
+    $key = $service->key('document', ['page:installation']);
+    $calls = 0;
+
+    $first = $service->remember($key, function () use (&$calls): array {
+        $calls++;
+
+        return ['title' => 'Installation'];
+    });
+
+    $second = $service->remember($key, function () use (&$calls): array {
+        $calls++;
+
+        return ['title' => 'Changed'];
+    });
+
+    expect($first)->toBe(['title' => 'Installation'])
+        ->and($second)->toBe(['title' => 'Installation'])
+        ->and($calls)->toBe(1);
+});
+
+it('clears cache files while keeping the cache directory present', function (): void {
+    $service = app(DocsOutputCacheService::class);
+    $key = $service->key('document', ['page:installation']);
+
+    $service->put($key, ['title' => 'Installation']);
+
+    $cachePath = config('docs.cache.path');
+
+    expect(File::allFiles($cachePath))->not->toBeEmpty();
+
+    $service->clear();
+
+    expect(File::isDirectory($cachePath))->toBeTrue()
+        ->and(File::allFiles($cachePath))->toBeEmpty();
+});
+
+it('falls back to default cache path when config path is invalid', function (): void {
+    config()->set('docs.cache.path', null);
+    app()->forgetInstance(DocsOutputCacheService::class);
+
+    $service = app(DocsOutputCacheService::class);
+
+    expect($service->path())->toBe(storage_path('framework/cache/docs-output'));
+});
diff --git a/tests/Unit/DocumentServiceTest.php b/tests/Unit/DocumentServiceTest.php
new file mode 100644
index 0000000..29df400
--- /dev/null
+++ b/tests/Unit/DocumentServiceTest.php
@@ -0,0 +1,86 @@
+<?php
+
+declare(strict_types=1);
+
+use App\Services\DocsOutputCacheService;
+use App\Services\DocsPathService;
+use App\Services\DocumentService;
+use Illuminate\Support\Facades\File;
+use Tests\Concerns\UsesDocsFixtures;
+
+uses(UsesDocsFixtures::class);
+
+beforeEach(function (): void {
+    $this->configureDocsFixtures();
+});
+
+it('loads and renders fixture documentation pages', function (): void {
+    $document = app(DocumentService::class)->load('installation');
+
+    expect($document)->not->toBeNull();
+    expect($document)
+        ->toHaveKey('title', 'Installation')
+        ->and($document['content'])->toContain('<h2 id="requirements">Requirements</h2>')
+        ->and($document['headings'])->toBe([
+            ['level' => 2, 'text' => 'Requirements', 'id' => 'requirements'],
+            ['level' => 2, 'text' => 'Steps', 'id' => 'steps'],
+        ]);
+});
+
+it('loads the fixture readme from the docs parent directory', function (): void {
+    $document = app(DocumentService::class)->loadReadme();
+
+    expect($document)->not->toBeNull();
+    expect($document)
+        ->toHaveKey('title', 'Fixture Documentation Home')
+        ->and($document['content'])->toContain('fixture-based docs home');
+});
+
+it('returns null when requested docs page is missing', function (): void {
+    expect(app(DocumentService::class)->load('missing-page'))->toBeNull();
+});
+
+it('falls back to title-cased slug when no h1 is present', function (): void {
+    $docsPath = storage_path('framework/testing/docs-no-title-'.uniqid('', true));
+
+    File::ensureDirectoryExists($docsPath);
+    File::put("{$docsPath}/no-title.md", "Paragraph only\n\n## Section");
+
+    config()->set('docs.path', $docsPath);
+    app()->forgetInstance(DocsPathService::class);
+    app()->forgetInstance(DocumentService::class);
+
+    $document = app(DocumentService::class)->load('no-title');
+
+    expect($document)->not->toBeNull();
+    expect($document['title'])->toBe('No title');
+
+    File::deleteDirectory($docsPath);
+});
+
+it('uses cached document payloads keyed by file fingerprint', function (): void {
+    $service = app(DocumentService::class);
+    $cache = app(DocsOutputCacheService::class);
+
+    $path = $this->docsFixtureRoot().'/docs/installation.md';
+    $modifiedAt = filemtime($path);
+    $size = filesize($path);
+    $fingerprint = sprintf('%d:%d', $modifiedAt === false ? 0 : $modifiedAt, $size === false ? 0 : $size);
+
+    $cache->put(
+        $cache->key('document', ['page:installation', $fingerprint]),
+        [
+            'title' => 'From Cache',
+            'content' => '<h1>From Cache</h1><p>Cached.</p>',
+            'headings' => [],
+        ],
+    );
+
+    $document = $service->load('installation');
+
+    expect($document)->toBe([
+        'title' => 'From Cache',
+        'content' => '<h1>From Cache</h1><p>Cached.</p>',
+        'headings' => [],
+    ]);
+});
diff --git a/tests/Unit/HeadingExtractorServiceTest.php b/tests/Unit/HeadingExtractorServiceTest.php
new file mode 100644
index 0000000..bcb18a9
--- /dev/null
+++ b/tests/Unit/HeadingExtractorServiceTest.php
@@ -0,0 +1,48 @@
+<?php
+
+declare(strict_types=1);
+
+use App\Services\HeadingExtractorService;
+
+it('returns an empty array for blank html', function (): void {
+    $headings = app(HeadingExtractorService::class)->extract('  ');
+
+    expect($headings)->toBe([]);
+});
+
+it('extracts h2 and h3 headings and ignores h1', function (): void {
+    $html = <<<'HTML'
+<h1 id="top">Top</h1>
+<h2 id="requirements">Requirements</h2>
+<h3 id="steps">Steps</h3>
+HTML;
+
+    $headings = app(HeadingExtractorService::class)->extract($html);
+
+    expect($headings)->toBe([
+        ['level' => 2, 'text' => 'Requirements', 'id' => 'requirements'],
+        ['level' => 3, 'text' => 'Steps', 'id' => 'steps'],
+    ]);
+});
+
+it('extracts heading ids from permalink anchors when no id exists on heading', function (): void {
+    $html = <<<'HTML'
+<h2><a id="linked-heading" class="heading-permalink" href="#linked-heading">#</a>Heading Title</h2>
+HTML;
+
+    $headings = app(HeadingExtractorService::class)->extract($html);
+
+    expect($headings)->toBe([
+        ['level' => 2, 'text' => 'Heading Title', 'id' => 'linked-heading'],
+    ]);
+});
+
+it('skips headings that do not contain visible text', function (): void {
+    $html = <<<'HTML'
+<h2><a id="empty" class="heading-permalink" href="#empty">#</a></h2>
+HTML;
+
+    $headings = app(HeadingExtractorService::class)->extract($html);
+
+    expect($headings)->toBe([]);
+});
diff --git a/tests/Unit/Livewire/DocsViewerTest.php b/tests/Unit/Livewire/DocsViewerTest.php
new file mode 100644
index 0000000..5c1cec6
--- /dev/null
+++ b/tests/Unit/Livewire/DocsViewerTest.php
@@ -0,0 +1,68 @@
+<?php
+
+declare(strict_types=1);
+
+use App\Livewire\DocsViewer;
+use App\Services\DocsOutputCacheService;
+use App\Services\DocsPathService;
+use App\Services\DocumentService;
+use App\Services\TocParserService;
+use Livewire\Livewire;
+use Tests\Concerns\UsesDocsFixtures;
+
+uses(UsesDocsFixtures::class);
+
+beforeEach(function (): void {
+    $this->configureDocsFixtures();
+});
+
+it('hydrates docs viewer state for the docs home', function (): void {
+    Livewire::test(DocsViewer::class)
+        ->assertSet('page', '')
+        ->assertSet('title', 'Fixture Documentation Home')
+        ->assertSet('toc.0.name', 'Guides');
+});
+
+it('hydrates docs viewer state for a docs page', function (): void {
+    Livewire::test(DocsViewer::class, ['page' => 'installation'])
+        ->assertSet('page', 'installation')
+        ->assertSet('title', 'Installation')
+        ->assertSet('headings.0.text', 'Requirements');
+});
+
+it('uses cached viewer payload when available', function (): void {
+    $cache = app(DocsOutputCacheService::class);
+
+    $cache->put(
+        $cache->key('docs-viewer', ['home']),
+        [
+            'page' => '',
+            'title' => 'Cached Home',
+            'content' => '<h1>Cached Home</h1>',
+            'headings' => [],
+            'toc' => [
+                [
+                    'name' => 'Cached',
+                    'anchor' => 'cached',
+                    'links' => [
+                        ['title' => 'Cached Link', 'path' => 'cached-link'],
+                    ],
+                ],
+            ],
+        ],
+    );
+
+    config()->set('docs.path', storage_path('framework/testing/missing-docs-'.uniqid('', true)));
+    app()->forgetInstance(DocsPathService::class);
+    app()->forgetInstance(TocParserService::class);
+    app()->forgetInstance(DocumentService::class);
+
+    Livewire::test(DocsViewer::class)
+        ->assertSet('title', 'Cached Home')
+        ->assertSet('toc.0.name', 'Cached');
+});
+
+it('redirects to home when a docs page does not exist', function (): void {
+    Livewire::test(DocsViewer::class, ['page' => 'missing-page'])
+        ->assertRedirect(route('home'));
+});
diff --git a/tests/Unit/MarkdownServiceTest.php b/tests/Unit/MarkdownServiceTest.php
new file mode 100644
index 0000000..7e94925
--- /dev/null
+++ b/tests/Unit/MarkdownServiceTest.php
@@ -0,0 +1,118 @@
+<?php
+
+declare(strict_types=1);
+
+use App\Services\MarkdownService;
+
+beforeEach(function (): void {
+    config()->set('docs.github.repo', 'acme/docs-repo');
+    config()->set('docs.github.branch', 'main');
+    config()->set('docs.github.dir', 'docs');
+});
+
+it('strips markdown artifacts and content before the first h1', function (): void {
+    $markdown = <<<'MARKDOWN'
+Intro paragraph that should be removed.
+
+<!-- toc -->
+- fake toc
+<!-- /toc -->
+
+<a name="legacy-anchor"></a>
+
+# Real Title
+
+Body
+MARKDOWN;
+
+    $html = app(MarkdownService::class)->toHtml($markdown);
+
+    expect($html)
+        ->toContain('<h1>Real Title</h1>')
+        ->toContain('<p>Body</p>')
+        ->not->toContain('Intro paragraph that should be removed.')
+        ->not->toContain('legacy-anchor');
+});
+
+it('converts docs links to internal routes and preserves fragments', function (): void {
+    $markdown = <<<'MARKDOWN'
+# Links
+
+[Docs Home](/docs)
+[Install](docs/installation#requirements)
+MARKDOWN;
+
+    $html = app(MarkdownService::class)->toHtml($markdown);
+
+    expect($html)
+        ->toContain('<a href="/">Docs Home</a>')
+        ->toContain('<a href="/docs/installation#requirements">Install</a>');
+});
+
+it('converts relative links to github blob urls', function (): void {
+    $markdown = <<<'MARKDOWN'
+# Links
+
+[Relative Section](setup)
+[Relative Markdown](guides/setup.md#cli)
+[Root Path](/CONTRIBUTING#policy)
+[Anchor](#local)
+[External](https://example.com)
+MARKDOWN;
+
+    $html = app(MarkdownService::class)->toHtml($markdown, 'deploy');
+
+    expect($html)
+        ->toContain('href="https://github.com/acme/docs-repo/blob/main/docs/deploy/setup.md" target="_blank" rel="noopener noreferrer"')
+        ->toContain('href="https://github.com/acme/docs-repo/blob/main/docs/guides/setup.md#cli" target="_blank" rel="noopener noreferrer"')
+        ->toContain('href="https://github.com/acme/docs-repo/blob/main/CONTRIBUTING#policy" target="_blank" rel="noopener noreferrer"')
+        ->toContain('<a href="#local">Anchor</a>')
+        ->toContain('<a href="https://example.com">External</a>');
+});
+
+it('wraps code blocks and respects nocopy modifiers', function (): void {
+    $markdown = <<<'MARKDOWN'
+# Code
+
+```bash nocopy
+php artisan test
+```
+
+```php
+<?php echo 'ok';
+```
+MARKDOWN;
+
+    $html = app(MarkdownService::class)->toHtml($markdown);
+
+    expect(substr_count($html, 'aria-label="Copy code to clipboard"'))->toBe(1)
+        ->and($html)->toContain('language-bash')
+        ->toContain('language-php');
+});
+
+it('renders important alerts with block content', function (): void {
+    $markdown = <<<'MARKDOWN'
+> [!IMPORTANT]
+> First important callout.
+>
+> - First item
+> - Second item
+MARKDOWN;
+
+    $html = app(MarkdownService::class)->toHtml($markdown);
+
+    expect(substr_count($html, 'dark:border-l-amber-400'))->toBe(1)
+        ->and($html)
+        ->toContain('<li>First item</li>')
+        ->toContain('<li>Second item</li>');
+});
+
+it('keeps empty github alert markers unchanged when there is no content', function (): void {
+    $markdown = <<<'MARKDOWN'
+> [!IMPORTANT]
+MARKDOWN;
+
+    $html = app(MarkdownService::class)->toHtml($markdown);
+
+    expect($html)->toContain('[!IMPORTANT]');
+});
diff --git a/tests/Unit/TocParserServiceTest.php b/tests/Unit/TocParserServiceTest.php
index 66dc202..ad7b910 100644
--- a/tests/Unit/TocParserServiceTest.php
+++ b/tests/Unit/TocParserServiceTest.php
@@ -4,24 +4,91 @@
 
 use App\Services\DocsPathService;
 use App\Services\TocParserService;
+use Illuminate\Support\Facades\File;
+use Tests\Concerns\UsesDocsFixtures;
 
-it('parses grouped toc sections and maps readme links to root path', function (): void {
-    $toc = new TocParserService(new DocsPathService)->parse();
-
-    expect($toc)->toHaveCount(2)
-        ->and($toc[0]['name'])->toBe('Guides')
-        ->and($toc[0]['links'])->toBe([
-            ['title' => 'Introduction', 'path' => ''],
-            ['title' => 'Installation', 'path' => 'installation'],
-            ['title' => 'Zero to Deploy', 'path' => 'zero-to-deploy'],
-        ])
-        ->and($toc[1]['name'])->toBe('References')
-        ->and($toc[1]['links'])->toBe([
-            ['title' => 'Managing Sites', 'path' => 'managing-sites'],
-            ['title' => 'Managing Servers', 'path' => 'managing-servers'],
-            ['title' => 'Managing Services', 'path' => 'managing-services'],
-            ['title' => 'Managing Databases', 'path' => 'managing-databases'],
-            ['title' => 'Cloud Providers', 'path' => 'cloud-providers'],
-            ['title' => 'Automation & AI', 'path' => 'automation'],
-        ]);
+uses(UsesDocsFixtures::class);
+
+beforeEach(function (): void {
+    $this->configureDocsFixtures();
+});
+
+it('parses grouped toc sections from fixture docs', function (): void {
+    $toc = app(TocParserService::class)->parse();
+
+    expect($toc)->toBe([
+        [
+            'name' => 'Guides',
+            'anchor' => 'guides',
+            'links' => [
+                ['title' => 'Introduction', 'path' => ''],
+                ['title' => 'Installation', 'path' => 'installation'],
+                ['title' => 'Link Behavior', 'path' => 'link-behavior'],
+            ],
+        ],
+        [
+            'name' => 'References',
+            'anchor' => 'references',
+            'links' => [
+                ['title' => 'Command Index', 'path' => 'command-index'],
+                ['title' => 'Operations', 'path' => 'runbooks'],
+            ],
+        ],
+    ]);
+});
+
+it('returns an empty toc when documentation file is missing', function (): void {
+    config()->set('docs.path', storage_path('framework/testing/missing-docs-'.uniqid('', true)));
+    app()->forgetInstance(DocsPathService::class);
+    app()->forgetInstance(TocParserService::class);
+
+    expect(app(TocParserService::class)->parse())->toBe([]);
+});
+
+it('parses flat toc links into the default documentation section', function (): void {
+    $docsPath = storage_path('framework/testing/docs-flat-'.uniqid('', true));
+
+    File::ensureDirectoryExists($docsPath);
+    File::put("{$docsPath}/documentation.md", "- [Readme](README.md)\n- [Guide](guides/guide.md)\n");
+
+    config()->set('docs.path', $docsPath);
+    app()->forgetInstance(DocsPathService::class);
+    app()->forgetInstance(TocParserService::class);
+
+    $toc = app(TocParserService::class)->parse();
+
+    expect($toc)->toBe([
+        [
+            'name' => 'Documentation',
+            'anchor' => 'documentation',
+            'links' => [
+                ['title' => 'Readme', 'path' => ''],
+                ['title' => 'Guide', 'path' => 'guide'],
+            ],
+        ],
+    ]);
+
+    File::deleteDirectory($docsPath);
+});
+
+it('memoizes parsed toc values per service instance', function (): void {
+    $docsPath = storage_path('framework/testing/docs-memoized-'.uniqid('', true));
+    File::ensureDirectoryExists($docsPath);
+    File::put("{$docsPath}/documentation.md", "- [Original](original.md)\n");
+
+    config()->set('docs.path', $docsPath);
+    app()->forgetInstance(DocsPathService::class);
+    app()->forgetInstance(TocParserService::class);
+
+    $service = app(TocParserService::class);
+
+    $first = $service->parse();
+
+    File::put("{$docsPath}/documentation.md", "- [Changed](changed.md)\n");
+
+    $second = $service->parse();
+
+    expect($second)->toBe($first);
+
+    File::deleteDirectory($docsPath);
 });

From b6dcd6b2b176101ebf2198edc2140a3643aa0dfc Mon Sep 17 00:00:00 2001
From: Lucian Behind The Scenes <silviulucian@gmail.com>
Date: Fri, 20 Feb 2026 12:27:29 +0200
Subject: [PATCH 6/8] chore: clean up stale files and polish command index view

- Remove HomeController (broken redirect to self) and welcome.blade.php
- Delete old non-Livewire command-index view
- Fix x-slot closing tag in Livewire command-index view
- Remove redundant prefix info bar from command-index view
- Add PHPDoc array type annotation to DocsOutputCacheService::key()
---
 app/Http/Controllers/HomeController.php       |  18 --
 app/Services/DocsOutputCacheService.php       |   3 +
 resources/views/command-index.blade.php       |  98 -------
 .../views/livewire/command-index.blade.php    |  16 +-
 resources/views/welcome.blade.php             | 277 ------------------
 5 files changed, 4 insertions(+), 408 deletions(-)
 delete mode 100644 app/Http/Controllers/HomeController.php
 delete mode 100644 resources/views/command-index.blade.php
 delete mode 100644 resources/views/welcome.blade.php

diff --git a/app/Http/Controllers/HomeController.php b/app/Http/Controllers/HomeController.php
deleted file mode 100644
index ced89ba..0000000
--- a/app/Http/Controllers/HomeController.php
+++ /dev/null
@@ -1,18 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace App\Http\Controllers;
-
-use Illuminate\Http\RedirectResponse;
-
-final class HomeController extends Controller
-{
-    /**
-     * Redirect to documentation index.
-     */
-    public function __invoke(): RedirectResponse
-    {
-        return redirect('/');
-    }
-}
diff --git a/app/Services/DocsOutputCacheService.php b/app/Services/DocsOutputCacheService.php
index 3429c5b..20349d7 100644
--- a/app/Services/DocsOutputCacheService.php
+++ b/app/Services/DocsOutputCacheService.php
@@ -13,6 +13,9 @@ public function __construct(
         private Filesystem $files,
     ) {}
 
+    /**
+     * @param  array<array-key, mixed>  $segments
+     */
     public function key(string $namespace, array $segments = []): string
     {
         $normalizedSegments = array_map(
diff --git a/resources/views/command-index.blade.php b/resources/views/command-index.blade.php
deleted file mode 100644
index 8fbf740..0000000
--- a/resources/views/command-index.blade.php
+++ /dev/null
@@ -1,98 +0,0 @@
-<!DOCTYPE html>
-<html lang="{{ str_replace('_', '-', app()->getLocale()) }}" class="scroll-smooth">
-    <head>
-        <meta charset="utf-8" />
-        <meta name="viewport" content="width=device-width, initial-scale=1" />
-        <title>DeployerPHP - Command Index</title>
-        <link rel="icon" type="image/svg+xml" href="{{ asset('logo-mark.svg') }}" />
-        <link rel="preconnect" href="https://fonts.bunny.net" />
-        <link href="https://fonts.bunny.net/css?family=inter:400,500,600&display=swap" rel="stylesheet" />
-        @vite(['resources/css/app.css', 'resources/js/app.js'])
-        @fluxAppearance
-    </head>
-    <body class="min-h-screen bg-white text-zinc-700 dark:bg-zinc-900 dark:text-zinc-300">
-        {{-- Header (matches docs layout) --}}
-        <x-docs.header />
-
-        {{-- Main Content --}}
-        <flux:main class="p-0!">
-            <div class="mx-auto max-w-7xl px-6 py-4 sm:py-6 lg:px-8">
-                {{-- Page Header --}}
-                <header class="mb-6">
-                    <h1 class="text-2xl font-semibold text-zinc-900 dark:text-zinc-50">Command Index</h1>
-                    <p class="mt-2 text-sm text-zinc-500 dark:text-zinc-400">
-                        <strong class="font-semibold text-zinc-700 dark:text-zinc-200">{{ $commandCount }}</strong>
-                        commands organized by deployment workflow.
-                    </p>
-                </header>
-
-                {{-- Global Options Hint --}}
-                <div class="mb-6 flex flex-wrap items-center justify-between gap-3 rounded-lg border border-zinc-200 bg-zinc-50 px-4 py-2.5 text-sm text-zinc-600 dark:border-zinc-700 dark:bg-zinc-800 dark:text-zinc-400">
-                    <span>
-                        Prefix commands with
-                        <code class="rounded bg-zinc-200/60 px-1.5 py-0.5 font-mono text-xs text-fuchsia-600 dark:bg-zinc-700/60 dark:text-fuchsia-400">deployer</code>
-                        in your terminal.
-                    </span>
-                    <span class="flex flex-wrap items-center gap-1.5">
-                        Global options:
-                        <code class="rounded bg-zinc-200/60 px-1.5 py-0.5 font-mono text-xs text-fuchsia-600 dark:bg-zinc-700/60 dark:text-fuchsia-400">--env</code>
-                        <code class="rounded bg-zinc-200/60 px-1.5 py-0.5 font-mono text-xs text-fuchsia-600 dark:bg-zinc-700/60 dark:text-fuchsia-400">--inventory</code>
-                        <code class="rounded bg-zinc-200/60 px-1.5 py-0.5 font-mono text-xs text-fuchsia-600 dark:bg-zinc-700/60 dark:text-fuchsia-400">--quiet</code>
-                    </span>
-                </div>
-
-                {{-- Command Groups By Related Documentation Area --}}
-                @if ($sections !== [])
-                    <div class="space-y-10" aria-label="DeployerPHP commands grouped by related documentation area">
-                        @foreach ($sections as $section)
-                            @php
-                                $sectionDescription = match ($section['name']) {
-                                    'Server & Site Operations' => 'Core commands for provisioning hosts, managing sites, and handling routine server maintenance.',
-                                    'Scheduling & Process Control' => 'Tools for defining scheduled jobs and managing long-running background workers.',
-                                    'Web Runtime Services' => 'Commands for configuring and controlling the web stack, including PHP and Nginx services.',
-                                    'Data Services' => 'Operational commands for databases and cache layers used by deployed applications.',
-                                    'Scaffolding' => 'Generators and setup helpers that bootstrap common deployment resources and project structure.',
-                                    'Cloud Providers' => 'Provider-specific commands for creating and managing infrastructure across supported cloud platforms.',
-                                    default => 'Supporting commands for specialized tasks that do not fit a primary operations category.',
-                                };
-                            @endphp
-
-                            <section>
-                                <header class="mb-4 border-b border-zinc-200 pb-2 dark:border-zinc-700">
-                                    <h2 class="text-lg font-semibold text-zinc-900 dark:text-zinc-50">{{ $section['name'] }}</h2>
-                                    <p class="mt-1 text-sm text-zinc-500 dark:text-zinc-400">{{ $sectionDescription }}</p>
-                                </header>
-
-                                <div class="grid grid-cols-1 gap-4 sm:grid-cols-2 xl:grid-cols-4">
-                                    @foreach ($section['groups'] as $group)
-                                        <article class="rounded-lg border border-zinc-200 bg-white p-4 dark:border-zinc-700 dark:bg-zinc-800/50">
-                                            <h3 class="mb-3 flex items-baseline gap-1.5 text-sm font-semibold text-zinc-900 dark:text-zinc-50">
-                                                {{ $group['name'] }}
-                                                <span class="text-xs font-normal text-zinc-400 dark:text-zinc-500">({{ $group['count'] }})</span>
-                                            </h3>
-
-                                            <ul class="space-y-1.5">
-                                                @foreach ($group['commands'] as $command)
-                                                    <li title="{{ $command['description'] }}">
-                                                        <code class="rounded bg-zinc-100/80 px-1 py-0.5 font-mono text-sm text-fuchsia-600 dark:bg-zinc-800/80 dark:text-fuchsia-400">{{ $command['primary'] }}</code>
-                                                    </li>
-                                                @endforeach
-                                            </ul>
-                                        </article>
-                                    @endforeach
-                                </div>
-                            </section>
-                        @endforeach
-                    </div>
-                @else
-                    <p class="text-sm text-zinc-500 dark:text-zinc-400">No commands were discovered for the configured docs path.</p>
-                @endif
-            </div>
-
-            {{-- Footer (matches docs layout) --}}
-            <x-docs.footer />
-        </flux:main>
-
-        @fluxScripts
-    </body>
-</html>
diff --git a/resources/views/livewire/command-index.blade.php b/resources/views/livewire/command-index.blade.php
index 887fc0a..b55f104 100644
--- a/resources/views/livewire/command-index.blade.php
+++ b/resources/views/livewire/command-index.blade.php
@@ -1,6 +1,6 @@
 <x-slot:sidebar>
     <x-docs.toc :toc="$toc" current-path="command-index" />
-</x-slot:sidebar>
+</x-slot>
 
 <div>
     <article class="docs-prose prose max-w-none">
@@ -11,20 +11,6 @@
         </p>
     </article>
 
-    <div class="mb-6 flex flex-wrap items-center justify-between gap-3 rounded-lg border border-zinc-200 bg-zinc-50 px-4 py-2.5 text-sm text-zinc-600 dark:border-zinc-700 dark:bg-zinc-800 dark:text-zinc-400">
-        <span>
-            Prefix commands with
-            <code class="rounded bg-zinc-200/60 px-1.5 py-0.5 font-mono text-xs text-fuchsia-600 dark:bg-zinc-700/60 dark:text-fuchsia-400">deployer</code>
-            in your terminal.
-        </span>
-        <span class="flex flex-wrap items-center gap-1.5">
-            Global options:
-            <code class="rounded bg-zinc-200/60 px-1.5 py-0.5 font-mono text-xs text-fuchsia-600 dark:bg-zinc-700/60 dark:text-fuchsia-400">--env</code>
-            <code class="rounded bg-zinc-200/60 px-1.5 py-0.5 font-mono text-xs text-fuchsia-600 dark:bg-zinc-700/60 dark:text-fuchsia-400">--inventory</code>
-            <code class="rounded bg-zinc-200/60 px-1.5 py-0.5 font-mono text-xs text-fuchsia-600 dark:bg-zinc-700/60 dark:text-fuchsia-400">--quiet</code>
-        </span>
-    </div>
-
     @if ($sections !== [])
         <div class="space-y-10" aria-label="DeployerPHP commands grouped by related documentation area">
             @foreach ($sections as $section)
diff --git a/resources/views/welcome.blade.php b/resources/views/welcome.blade.php
deleted file mode 100644
index b7355d7..0000000
--- a/resources/views/welcome.blade.php
+++ /dev/null
@@ -1,277 +0,0 @@
-<!DOCTYPE html>
-<html lang="{{ str_replace('_', '-', app()->getLocale()) }}">
-    <head>
-        <meta charset="utf-8">
-        <meta name="viewport" content="width=device-width, initial-scale=1">
-
-        <title>{{ config('app.name', 'Laravel') }}</title>
-
-        <!-- Fonts -->
-        <link rel="preconnect" href="https://fonts.bunny.net">
-        <link href="https://fonts.bunny.net/css?family=instrument-sans:400,500,600" rel="stylesheet" />
-
-        <!-- Styles / Scripts -->
-        @if (file_exists(public_path('build/manifest.json')) || file_exists(public_path('hot')))
-            @vite(['resources/css/app.css', 'resources/js/app.js'])
-        @else
-            <style>
-                /*! tailwindcss v4.0.7 | MIT License | https://tailwindcss.com */@layer theme{:root,:host{--font-sans:'Instrument Sans',ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji","Segoe UI Symbol","Noto Color Emoji";--font-serif:ui-serif,Georgia,Cambria,"Times New Roman",Times,serif;--font-mono:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,"Liberation Mono","Courier New",monospace;--color-red-50:oklch(.971 .013 17.38);--color-red-100:oklch(.936 .032 17.717);--color-red-200:oklch(.885 .062 18.334);--color-red-300:oklch(.808 .114 19.571);--color-red-400:oklch(.704 .191 22.216);--color-red-500:oklch(.637 .237 25.331);--color-red-600:oklch(.577 .245 27.325);--color-red-700:oklch(.505 .213 27.518);--color-red-800:oklch(.444 .177 26.899);--color-red-900:oklch(.396 .141 25.723);--color-red-950:oklch(.258 .092 26.042);--color-orange-50:oklch(.98 .016 73.684);--color-orange-100:oklch(.954 .038 75.164);--color-orange-200:oklch(.901 .076 70.697);--color-orange-300:oklch(.837 .128 66.29);--color-orange-400:oklch(.75 .183 55.934);--color-orange-500:oklch(.705 .213 47.604);--color-orange-600:oklch(.646 .222 41.116);--color-orange-700:oklch(.553 .195 38.402);--color-orange-800:oklch(.47 .157 37.304);--color-orange-900:oklch(.408 .123 38.172);--color-orange-950:oklch(.266 .079 36.259);--color-amber-50:oklch(.987 .022 95.277);--color-amber-100:oklch(.962 .059 95.617);--color-amber-200:oklch(.924 .12 95.746);--color-amber-300:oklch(.879 .169 91.605);--color-amber-400:oklch(.828 .189 84.429);--color-amber-500:oklch(.769 .188 70.08);--color-amber-600:oklch(.666 .179 58.318);--color-amber-700:oklch(.555 .163 48.998);--color-amber-800:oklch(.473 .137 46.201);--color-amber-900:oklch(.414 .112 45.904);--color-amber-950:oklch(.279 .077 45.635);--color-yellow-50:oklch(.987 .026 102.212);--color-yellow-100:oklch(.973 .071 103.193);--color-yellow-200:oklch(.945 .129 101.54);--color-yellow-300:oklch(.905 .182 98.111);--color-yellow-400:oklch(.852 .199 91.936);--color-yellow-500:oklch(.795 .184 86.047);--color-yellow-600:oklch(.681 .162 75.834);--color-yellow-700:oklch(.554 .135 66.442);--color-yellow-800:oklch(.476 .114 61.907);--color-yellow-900:oklch(.421 .095 57.708);--color-yellow-950:oklch(.286 .066 53.813);--color-lime-50:oklch(.986 .031 120.757);--color-lime-100:oklch(.967 .067 122.328);--color-lime-200:oklch(.938 .127 124.321);--color-lime-300:oklch(.897 .196 126.665);--color-lime-400:oklch(.841 .238 128.85);--color-lime-500:oklch(.768 .233 130.85);--color-lime-600:oklch(.648 .2 131.684);--color-lime-700:oklch(.532 .157 131.589);--color-lime-800:oklch(.453 .124 130.933);--color-lime-900:oklch(.405 .101 131.063);--color-lime-950:oklch(.274 .072 132.109);--color-green-50:oklch(.982 .018 155.826);--color-green-100:oklch(.962 .044 156.743);--color-green-200:oklch(.925 .084 155.995);--color-green-300:oklch(.871 .15 154.449);--color-green-400:oklch(.792 .209 151.711);--color-green-500:oklch(.723 .219 149.579);--color-green-600:oklch(.627 .194 149.214);--color-green-700:oklch(.527 .154 150.069);--color-green-800:oklch(.448 .119 151.328);--color-green-900:oklch(.393 .095 152.535);--color-green-950:oklch(.266 .065 152.934);--color-emerald-50:oklch(.979 .021 166.113);--color-emerald-100:oklch(.95 .052 163.051);--color-emerald-200:oklch(.905 .093 164.15);--color-emerald-300:oklch(.845 .143 164.978);--color-emerald-400:oklch(.765 .177 163.223);--color-emerald-500:oklch(.696 .17 162.48);--color-emerald-600:oklch(.596 .145 163.225);--color-emerald-700:oklch(.508 .118 165.612);--color-emerald-800:oklch(.432 .095 166.913);--color-emerald-900:oklch(.378 .077 168.94);--color-emerald-950:oklch(.262 .051 172.552);--color-teal-50:oklch(.984 .014 180.72);--color-teal-100:oklch(.953 .051 180.801);--color-teal-200:oklch(.91 .096 180.426);--color-teal-300:oklch(.855 .138 181.071);--color-teal-400:oklch(.777 .152 181.912);--color-teal-500:oklch(.704 .14 182.503);--color-teal-600:oklch(.6 .118 184.704);--color-teal-700:oklch(.511 .096 186.391);--color-teal-800:oklch(.437 .078 188.216);--color-teal-900:oklch(.386 .063 188.416);--color-teal-950:oklch(.277 .046 192.524);--color-cyan-50:oklch(.984 .019 200.873);--color-cyan-100:oklch(.956 .045 203.388);--color-cyan-200:oklch(.917 .08 205.041);--color-cyan-300:oklch(.865 .127 207.078);--color-cyan-400:oklch(.789 .154 211.53);--color-cyan-500:oklch(.715 .143 215.221);--color-cyan-600:oklch(.609 .126 221.723);--color-cyan-700:oklch(.52 .105 223.128);--color-cyan-800:oklch(.45 .085 224.283);--color-cyan-900:oklch(.398 .07 227.392);--color-cyan-950:oklch(.302 .056 229.695);--color-sky-50:oklch(.977 .013 236.62);--color-sky-100:oklch(.951 .026 236.824);--color-sky-200:oklch(.901 .058 230.902);--color-sky-300:oklch(.828 .111 230.318);--color-sky-400:oklch(.746 .16 232.661);--color-sky-500:oklch(.685 .169 237.323);--color-sky-600:oklch(.588 .158 241.966);--color-sky-700:oklch(.5 .134 242.749);--color-sky-800:oklch(.443 .11 240.79);--color-sky-900:oklch(.391 .09 240.876);--color-sky-950:oklch(.293 .066 243.157);--color-blue-50:oklch(.97 .014 254.604);--color-blue-100:oklch(.932 .032 255.585);--color-blue-200:oklch(.882 .059 254.128);--color-blue-300:oklch(.809 .105 251.813);--color-blue-400:oklch(.707 .165 254.624);--color-blue-500:oklch(.623 .214 259.815);--color-blue-600:oklch(.546 .245 262.881);--color-blue-700:oklch(.488 .243 264.376);--color-blue-800:oklch(.424 .199 265.638);--color-blue-900:oklch(.379 .146 265.522);--color-blue-950:oklch(.282 .091 267.935);--color-indigo-50:oklch(.962 .018 272.314);--color-indigo-100:oklch(.93 .034 272.788);--color-indigo-200:oklch(.87 .065 274.039);--color-indigo-300:oklch(.785 .115 274.713);--color-indigo-400:oklch(.673 .182 276.935);--color-indigo-500:oklch(.585 .233 277.117);--color-indigo-600:oklch(.511 .262 276.966);--color-indigo-700:oklch(.457 .24 277.023);--color-indigo-800:oklch(.398 .195 277.366);--color-indigo-900:oklch(.359 .144 278.697);--color-indigo-950:oklch(.257 .09 281.288);--color-violet-50:oklch(.969 .016 293.756);--color-violet-100:oklch(.943 .029 294.588);--color-violet-200:oklch(.894 .057 293.283);--color-violet-300:oklch(.811 .111 293.571);--color-violet-400:oklch(.702 .183 293.541);--color-violet-500:oklch(.606 .25 292.717);--color-violet-600:oklch(.541 .281 293.009);--color-violet-700:oklch(.491 .27 292.581);--color-violet-800:oklch(.432 .232 292.759);--color-violet-900:oklch(.38 .189 293.745);--color-violet-950:oklch(.283 .141 291.089);--color-purple-50:oklch(.977 .014 308.299);--color-purple-100:oklch(.946 .033 307.174);--color-purple-200:oklch(.902 .063 306.703);--color-purple-300:oklch(.827 .119 306.383);--color-purple-400:oklch(.714 .203 305.504);--color-purple-500:oklch(.627 .265 303.9);--color-purple-600:oklch(.558 .288 302.321);--color-purple-700:oklch(.496 .265 301.924);--color-purple-800:oklch(.438 .218 303.724);--color-purple-900:oklch(.381 .176 304.987);--color-purple-950:oklch(.291 .149 302.717);--color-fuchsia-50:oklch(.977 .017 320.058);--color-fuchsia-100:oklch(.952 .037 318.852);--color-fuchsia-200:oklch(.903 .076 319.62);--color-fuchsia-300:oklch(.833 .145 321.434);--color-fuchsia-400:oklch(.74 .238 322.16);--color-fuchsia-500:oklch(.667 .295 322.15);--color-fuchsia-600:oklch(.591 .293 322.896);--color-fuchsia-700:oklch(.518 .253 323.949);--color-fuchsia-800:oklch(.452 .211 324.591);--color-fuchsia-900:oklch(.401 .17 325.612);--color-fuchsia-950:oklch(.293 .136 325.661);--color-pink-50:oklch(.971 .014 343.198);--color-pink-100:oklch(.948 .028 342.258);--color-pink-200:oklch(.899 .061 343.231);--color-pink-300:oklch(.823 .12 346.018);--color-pink-400:oklch(.718 .202 349.761);--color-pink-500:oklch(.656 .241 354.308);--color-pink-600:oklch(.592 .249 .584);--color-pink-700:oklch(.525 .223 3.958);--color-pink-800:oklch(.459 .187 3.815);--color-pink-900:oklch(.408 .153 2.432);--color-pink-950:oklch(.284 .109 3.907);--color-rose-50:oklch(.969 .015 12.422);--color-rose-100:oklch(.941 .03 12.58);--color-rose-200:oklch(.892 .058 10.001);--color-rose-300:oklch(.81 .117 11.638);--color-rose-400:oklch(.712 .194 13.428);--color-rose-500:oklch(.645 .246 16.439);--color-rose-600:oklch(.586 .253 17.585);--color-rose-700:oklch(.514 .222 16.935);--color-rose-800:oklch(.455 .188 13.697);--color-rose-900:oklch(.41 .159 10.272);--color-rose-950:oklch(.271 .105 12.094);--color-slate-50:oklch(.984 .003 247.858);--color-slate-100:oklch(.968 .007 247.896);--color-slate-200:oklch(.929 .013 255.508);--color-slate-300:oklch(.869 .022 252.894);--color-slate-400:oklch(.704 .04 256.788);--color-slate-500:oklch(.554 .046 257.417);--color-slate-600:oklch(.446 .043 257.281);--color-slate-700:oklch(.372 .044 257.287);--color-slate-800:oklch(.279 .041 260.031);--color-slate-900:oklch(.208 .042 265.755);--color-slate-950:oklch(.129 .042 264.695);--color-gray-50:oklch(.985 .002 247.839);--color-gray-100:oklch(.967 .003 264.542);--color-gray-200:oklch(.928 .006 264.531);--color-gray-300:oklch(.872 .01 258.338);--color-gray-400:oklch(.707 .022 261.325);--color-gray-500:oklch(.551 .027 264.364);--color-gray-600:oklch(.446 .03 256.802);--color-gray-700:oklch(.373 .034 259.733);--color-gray-800:oklch(.278 .033 256.848);--color-gray-900:oklch(.21 .034 264.665);--color-gray-950:oklch(.13 .028 261.692);--color-zinc-50:oklch(.985 0 0);--color-zinc-100:oklch(.967 .001 286.375);--color-zinc-200:oklch(.92 .004 286.32);--color-zinc-300:oklch(.871 .006 286.286);--color-zinc-400:oklch(.705 .015 286.067);--color-zinc-500:oklch(.552 .016 285.938);--color-zinc-600:oklch(.442 .017 285.786);--color-zinc-700:oklch(.37 .013 285.805);--color-zinc-800:oklch(.274 .006 286.033);--color-zinc-900:oklch(.21 .006 285.885);--color-zinc-950:oklch(.141 .005 285.823);--color-neutral-50:oklch(.985 0 0);--color-neutral-100:oklch(.97 0 0);--color-neutral-200:oklch(.922 0 0);--color-neutral-300:oklch(.87 0 0);--color-neutral-400:oklch(.708 0 0);--color-neutral-500:oklch(.556 0 0);--color-neutral-600:oklch(.439 0 0);--color-neutral-700:oklch(.371 0 0);--color-neutral-800:oklch(.269 0 0);--color-neutral-900:oklch(.205 0 0);--color-neutral-950:oklch(.145 0 0);--color-stone-50:oklch(.985 .001 106.423);--color-stone-100:oklch(.97 .001 106.424);--color-stone-200:oklch(.923 .003 48.717);--color-stone-300:oklch(.869 .005 56.366);--color-stone-400:oklch(.709 .01 56.259);--color-stone-500:oklch(.553 .013 58.071);--color-stone-600:oklch(.444 .011 73.639);--color-stone-700:oklch(.374 .01 67.558);--color-stone-800:oklch(.268 .007 34.298);--color-stone-900:oklch(.216 .006 56.043);--color-stone-950:oklch(.147 .004 49.25);--color-black:#000;--color-white:#fff;--spacing:.25rem;--breakpoint-sm:40rem;--breakpoint-md:48rem;--breakpoint-lg:64rem;--breakpoint-xl:80rem;--breakpoint-2xl:96rem;--container-3xs:16rem;--container-2xs:18rem;--container-xs:20rem;--container-sm:24rem;--container-md:28rem;--container-lg:32rem;--container-xl:36rem;--container-2xl:42rem;--container-3xl:48rem;--container-4xl:56rem;--container-5xl:64rem;--container-6xl:72rem;--container-7xl:80rem;--text-xs:.75rem;--text-xs--line-height:calc(1/.75);--text-sm:.875rem;--text-sm--line-height:calc(1.25/.875);--text-base:1rem;--text-base--line-height: 1.5 ;--text-lg:1.125rem;--text-lg--line-height:calc(1.75/1.125);--text-xl:1.25rem;--text-xl--line-height:calc(1.75/1.25);--text-2xl:1.5rem;--text-2xl--line-height:calc(2/1.5);--text-3xl:1.875rem;--text-3xl--line-height: 1.2 ;--text-4xl:2.25rem;--text-4xl--line-height:calc(2.5/2.25);--text-5xl:3rem;--text-5xl--line-height:1;--text-6xl:3.75rem;--text-6xl--line-height:1;--text-7xl:4.5rem;--text-7xl--line-height:1;--text-8xl:6rem;--text-8xl--line-height:1;--text-9xl:8rem;--text-9xl--line-height:1;--font-weight-thin:100;--font-weight-extralight:200;--font-weight-light:300;--font-weight-normal:400;--font-weight-medium:500;--font-weight-semibold:600;--font-weight-bold:700;--font-weight-extrabold:800;--font-weight-black:900;--tracking-tighter:-.05em;--tracking-tight:-.025em;--tracking-normal:0em;--tracking-wide:.025em;--tracking-wider:.05em;--tracking-widest:.1em;--leading-tight:1.25;--leading-snug:1.375;--leading-normal:1.5;--leading-relaxed:1.625;--leading-loose:2;--radius-xs:.125rem;--radius-sm:.25rem;--radius-md:.375rem;--radius-lg:.5rem;--radius-xl:.75rem;--radius-2xl:1rem;--radius-3xl:1.5rem;--radius-4xl:2rem;--shadow-2xs:0 1px #0000000d;--shadow-xs:0 1px 2px 0 #0000000d;--shadow-sm:0 1px 3px 0 #0000001a,0 1px 2px -1px #0000001a;--shadow-md:0 4px 6px -1px #0000001a,0 2px 4px -2px #0000001a;--shadow-lg:0 10px 15px -3px #0000001a,0 4px 6px -4px #0000001a;--shadow-xl:0 20px 25px -5px #0000001a,0 8px 10px -6px #0000001a;--shadow-2xl:0 25px 50px -12px #00000040;--inset-shadow-2xs:inset 0 1px #0000000d;--inset-shadow-xs:inset 0 1px 1px #0000000d;--inset-shadow-sm:inset 0 2px 4px #0000000d;--drop-shadow-xs:0 1px 1px #0000000d;--drop-shadow-sm:0 1px 2px #00000026;--drop-shadow-md:0 3px 3px #0000001f;--drop-shadow-lg:0 4px 4px #00000026;--drop-shadow-xl:0 9px 7px #0000001a;--drop-shadow-2xl:0 25px 25px #00000026;--ease-in:cubic-bezier(.4,0,1,1);--ease-out:cubic-bezier(0,0,.2,1);--ease-in-out:cubic-bezier(.4,0,.2,1);--animate-spin:spin 1s linear infinite;--animate-ping:ping 1s cubic-bezier(0,0,.2,1)infinite;--animate-pulse:pulse 2s cubic-bezier(.4,0,.6,1)infinite;--animate-bounce:bounce 1s infinite;--blur-xs:4px;--blur-sm:8px;--blur-md:12px;--blur-lg:16px;--blur-xl:24px;--blur-2xl:40px;--blur-3xl:64px;--perspective-dramatic:100px;--perspective-near:300px;--perspective-normal:500px;--perspective-midrange:800px;--perspective-distant:1200px;--aspect-video:16/9;--default-transition-duration:.15s;--default-transition-timing-function:cubic-bezier(.4,0,.2,1);--default-font-family:var(--font-sans);--default-font-feature-settings:var(--font-sans--font-feature-settings);--default-font-variation-settings:var(--font-sans--font-variation-settings);--default-mono-font-family:var(--font-mono);--default-mono-font-feature-settings:var(--font-mono--font-feature-settings);--default-mono-font-variation-settings:var(--font-mono--font-variation-settings)}}@layer base{*,:after,:before,::backdrop{box-sizing:border-box;border:0 solid;margin:0;padding:0}::file-selector-button{box-sizing:border-box;border:0 solid;margin:0;padding:0}html,:host{-webkit-text-size-adjust:100%;-moz-tab-size:4;tab-size:4;line-height:1.5;font-family:var(--default-font-family,ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji","Segoe UI Symbol","Noto Color Emoji");font-feature-settings:var(--default-font-feature-settings,normal);font-variation-settings:var(--default-font-variation-settings,normal);-webkit-tap-highlight-color:transparent}body{line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;-webkit-text-decoration:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:var(--default-mono-font-family,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,"Liberation Mono","Courier New",monospace);font-feature-settings:var(--default-mono-font-feature-settings,normal);font-variation-settings:var(--default-mono-font-variation-settings,normal);font-size:1em}small{font-size:80%}sub,sup{vertical-align:baseline;font-size:75%;line-height:0;position:relative}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}:-moz-focusring{outline:auto}progress{vertical-align:baseline}summary{display:list-item}ol,ul,menu{list-style:none}img,svg,video,canvas,audio,iframe,embed,object{vertical-align:middle;display:block}img,video{max-width:100%;height:auto}button,input,select,optgroup,textarea{font:inherit;font-feature-settings:inherit;font-variation-settings:inherit;letter-spacing:inherit;color:inherit;opacity:1;background-color:#0000;border-radius:0}::file-selector-button{font:inherit;font-feature-settings:inherit;font-variation-settings:inherit;letter-spacing:inherit;color:inherit;opacity:1;background-color:#0000;border-radius:0}:where(select:is([multiple],[size])) optgroup{font-weight:bolder}:where(select:is([multiple],[size])) optgroup option{padding-inline-start:20px}::file-selector-button{margin-inline-end:4px}::placeholder{opacity:1;color:color-mix(in oklab,currentColor 50%,transparent)}textarea{resize:vertical}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-date-and-time-value{min-height:1lh;text-align:inherit}::-webkit-datetime-edit{display:inline-flex}::-webkit-datetime-edit-fields-wrapper{padding:0}::-webkit-datetime-edit{padding-block:0}::-webkit-datetime-edit-year-field{padding-block:0}::-webkit-datetime-edit-month-field{padding-block:0}::-webkit-datetime-edit-day-field{padding-block:0}::-webkit-datetime-edit-hour-field{padding-block:0}::-webkit-datetime-edit-minute-field{padding-block:0}::-webkit-datetime-edit-second-field{padding-block:0}::-webkit-datetime-edit-millisecond-field{padding-block:0}::-webkit-datetime-edit-meridiem-field{padding-block:0}:-moz-ui-invalid{box-shadow:none}button,input:where([type=button],[type=reset],[type=submit]){-webkit-appearance:button;-moz-appearance:button;appearance:button}::file-selector-button{-webkit-appearance:button;-moz-appearance:button;appearance:button}::-webkit-inner-spin-button{height:auto}::-webkit-outer-spin-button{height:auto}[hidden]:where(:not([hidden=until-found])){display:none!important}}@layer components;@layer utilities{.absolute{position:absolute}.relative{position:relative}.static{position:static}.inset-0{inset:calc(var(--spacing)*0)}.-mt-\[4\.9rem\]{margin-top:-4.9rem}.-mb-px{margin-bottom:-1px}.mb-1{margin-bottom:calc(var(--spacing)*1)}.mb-2{margin-bottom:calc(var(--spacing)*2)}.mb-4{margin-bottom:calc(var(--spacing)*4)}.mb-6{margin-bottom:calc(var(--spacing)*6)}.-ml-8{margin-left:calc(var(--spacing)*-8)}.flex{display:flex}.hidden{display:none}.inline-block{display:inline-block}.inline-flex{display:inline-flex}.table{display:table}.aspect-\[335\/376\]{aspect-ratio:335/376}.h-1{height:calc(var(--spacing)*1)}.h-1\.5{height:calc(var(--spacing)*1.5)}.h-2{height:calc(var(--spacing)*2)}.h-2\.5{height:calc(var(--spacing)*2.5)}.h-3{height:calc(var(--spacing)*3)}.h-3\.5{height:calc(var(--spacing)*3.5)}.h-14{height:calc(var(--spacing)*14)}.h-14\.5{height:calc(var(--spacing)*14.5)}.min-h-screen{min-height:100vh}.w-1{width:calc(var(--spacing)*1)}.w-1\.5{width:calc(var(--spacing)*1.5)}.w-2{width:calc(var(--spacing)*2)}.w-2\.5{width:calc(var(--spacing)*2.5)}.w-3{width:calc(var(--spacing)*3)}.w-3\.5{width:calc(var(--spacing)*3.5)}.w-\[448px\]{width:448px}.w-full{width:100%}.max-w-\[335px\]{max-width:335px}.max-w-none{max-width:none}.flex-1{flex:1}.shrink-0{flex-shrink:0}.translate-y-0{--tw-translate-y:calc(var(--spacing)*0);translate:var(--tw-translate-x)var(--tw-translate-y)}.transform{transform:var(--tw-rotate-x)var(--tw-rotate-y)var(--tw-rotate-z)var(--tw-skew-x)var(--tw-skew-y)}.flex-col{flex-direction:column}.flex-col-reverse{flex-direction:column-reverse}.items-center{align-items:center}.justify-center{justify-content:center}.justify-end{justify-content:flex-end}.gap-3{gap:calc(var(--spacing)*3)}.gap-4{gap:calc(var(--spacing)*4)}:where(.space-x-1>:not(:last-child)){--tw-space-x-reverse:0;margin-inline-start:calc(calc(var(--spacing)*1)*var(--tw-space-x-reverse));margin-inline-end:calc(calc(var(--spacing)*1)*calc(1 - var(--tw-space-x-reverse)))}.overflow-hidden{overflow:hidden}.rounded-full{border-radius:3.40282e38px}.rounded-sm{border-radius:var(--radius-sm)}.rounded-t-lg{border-top-left-radius:var(--radius-lg);border-top-right-radius:var(--radius-lg)}.rounded-br-lg{border-bottom-right-radius:var(--radius-lg)}.rounded-bl-lg{border-bottom-left-radius:var(--radius-lg)}.border{border-style:var(--tw-border-style);border-width:1px}.border-\[\#19140035\]{border-color:#19140035}.border-\[\#e3e3e0\]{border-color:#e3e3e0}.border-black{border-color:var(--color-black)}.border-transparent{border-color:#0000}.bg-\[\#1b1b18\]{background-color:#1b1b18}.bg-\[\#FDFDFC\]{background-color:#fdfdfc}.bg-\[\#dbdbd7\]{background-color:#dbdbd7}.bg-\[\#fff2f2\]{background-color:#fff2f2}.bg-white{background-color:var(--color-white)}.p-6{padding:calc(var(--spacing)*6)}.px-5{padding-inline:calc(var(--spacing)*5)}.py-1{padding-block:calc(var(--spacing)*1)}.py-1\.5{padding-block:calc(var(--spacing)*1.5)}.py-2{padding-block:calc(var(--spacing)*2)}.pb-12{padding-bottom:calc(var(--spacing)*12)}.text-sm{font-size:var(--text-sm);line-height:var(--tw-leading,var(--text-sm--line-height))}.text-\[13px\]{font-size:13px}.leading-\[20px\]{--tw-leading:20px;line-height:20px}.leading-normal{--tw-leading:var(--leading-normal);line-height:var(--leading-normal)}.font-medium{--tw-font-weight:var(--font-weight-medium);font-weight:var(--font-weight-medium)}.text-\[\#1b1b18\]{color:#1b1b18}.text-\[\#706f6c\]{color:#706f6c}.text-\[\#F53003\],.text-\[\#f53003\]{color:#f53003}.text-white{color:var(--color-white)}.underline{text-decoration-line:underline}.underline-offset-4{text-underline-offset:4px}.opacity-100{opacity:1}.shadow-\[0px_0px_1px_0px_rgba\(0\,0\,0\,0\.03\)\,0px_1px_2px_0px_rgba\(0\,0\,0\,0\.06\)\]{--tw-shadow:0px 0px 1px 0px var(--tw-shadow-color,#00000008),0px 1px 2px 0px var(--tw-shadow-color,#0000000f);box-shadow:var(--tw-inset-shadow),var(--tw-inset-ring-shadow),var(--tw-ring-offset-shadow),var(--tw-ring-shadow),var(--tw-shadow)}.shadow-\[inset_0px_0px_0px_1px_rgba\(26\,26\,0\,0\.16\)\]{--tw-shadow:inset 0px 0px 0px 1px var(--tw-shadow-color,#1a1a0029);box-shadow:var(--tw-inset-shadow),var(--tw-inset-ring-shadow),var(--tw-ring-offset-shadow),var(--tw-ring-shadow),var(--tw-shadow)}.\!filter{filter:var(--tw-blur,)var(--tw-brightness,)var(--tw-contrast,)var(--tw-grayscale,)var(--tw-hue-rotate,)var(--tw-invert,)var(--tw-saturate,)var(--tw-sepia,)var(--tw-drop-shadow,)!important}.filter{filter:var(--tw-blur,)var(--tw-brightness,)var(--tw-contrast,)var(--tw-grayscale,)var(--tw-hue-rotate,)var(--tw-invert,)var(--tw-saturate,)var(--tw-sepia,)var(--tw-drop-shadow,)}.transition-all{transition-property:all;transition-timing-function:var(--tw-ease,var(--default-transition-timing-function));transition-duration:var(--tw-duration,var(--default-transition-duration))}.transition-opacity{transition-property:opacity;transition-timing-function:var(--tw-ease,var(--default-transition-timing-function));transition-duration:var(--tw-duration,var(--default-transition-duration))}.delay-300{transition-delay:.3s}.duration-750{--tw-duration:.75s;transition-duration:.75s}.not-has-\[nav\]\:hidden:not(:has(:is(nav))){display:none}.before\:absolute:before{content:var(--tw-content);position:absolute}.before\:top-0:before{content:var(--tw-content);top:calc(var(--spacing)*0)}.before\:top-1\/2:before{content:var(--tw-content);top:50%}.before\:bottom-0:before{content:var(--tw-content);bottom:calc(var(--spacing)*0)}.before\:bottom-1\/2:before{content:var(--tw-content);bottom:50%}.before\:left-\[0\.4rem\]:before{content:var(--tw-content);left:.4rem}.before\:border-l:before{content:var(--tw-content);border-left-style:var(--tw-border-style);border-left-width:1px}.before\:border-\[\#e3e3e0\]:before{content:var(--tw-content);border-color:#e3e3e0}@media (hover:hover){.hover\:border-\[\#1915014a\]:hover{border-color:#1915014a}.hover\:border-\[\#19140035\]:hover{border-color:#19140035}.hover\:border-black:hover{border-color:var(--color-black)}.hover\:bg-black:hover{background-color:var(--color-black)}}@media (width>=64rem){.lg\:-mt-\[6\.6rem\]{margin-top:-6.6rem}.lg\:mb-0{margin-bottom:calc(var(--spacing)*0)}.lg\:mb-6{margin-bottom:calc(var(--spacing)*6)}.lg\:-ml-px{margin-left:-1px}.lg\:ml-0{margin-left:calc(var(--spacing)*0)}.lg\:block{display:block}.lg\:aspect-auto{aspect-ratio:auto}.lg\:w-\[438px\]{width:438px}.lg\:max-w-4xl{max-width:var(--container-4xl)}.lg\:grow{flex-grow:1}.lg\:flex-row{flex-direction:row}.lg\:justify-center{justify-content:center}.lg\:rounded-t-none{border-top-left-radius:0;border-top-right-radius:0}.lg\:rounded-tl-lg{border-top-left-radius:var(--radius-lg)}.lg\:rounded-r-lg{border-top-right-radius:var(--radius-lg);border-bottom-right-radius:var(--radius-lg)}.lg\:rounded-br-none{border-bottom-right-radius:0}.lg\:p-8{padding:calc(var(--spacing)*8)}.lg\:p-20{padding:calc(var(--spacing)*20)}}@media (prefers-color-scheme:dark){.dark\:block{display:block}.dark\:hidden{display:none}.dark\:border-\[\#3E3E3A\]{border-color:#3e3e3a}.dark\:border-\[\#eeeeec\]{border-color:#eeeeec}.dark\:bg-\[\#0a0a0a\]{background-color:#0a0a0a}.dark\:bg-\[\#1D0002\]{background-color:#1d0002}.dark\:bg-\[\#3E3E3A\]{background-color:#3e3e3a}.dark\:bg-\[\#161615\]{background-color:#161615}.dark\:bg-\[\#eeeeec\]{background-color:#eeeeec}.dark\:text-\[\#1C1C1A\]{color:#1c1c1a}.dark\:text-\[\#A1A09A\]{color:#a1a09a}.dark\:text-\[\#EDEDEC\]{color:#ededec}.dark\:text-\[\#F61500\]{color:#f61500}.dark\:text-\[\#FF4433\]{color:#f43}.dark\:shadow-\[inset_0px_0px_0px_1px_\#fffaed2d\]{--tw-shadow:inset 0px 0px 0px 1px var(--tw-shadow-color,#fffaed2d);box-shadow:var(--tw-inset-shadow),var(--tw-inset-ring-shadow),var(--tw-ring-offset-shadow),var(--tw-ring-shadow),var(--tw-shadow)}.dark\:before\:border-\[\#3E3E3A\]:before{content:var(--tw-content);border-color:#3e3e3a}@media (hover:hover){.dark\:hover\:border-\[\#3E3E3A\]:hover{border-color:#3e3e3a}.dark\:hover\:border-\[\#62605b\]:hover{border-color:#62605b}.dark\:hover\:border-white:hover{border-color:var(--color-white)}.dark\:hover\:bg-white:hover{background-color:var(--color-white)}}}@starting-style{.starting\:translate-y-4{--tw-translate-y:calc(var(--spacing)*4);translate:var(--tw-translate-x)var(--tw-translate-y)}}@starting-style{.starting\:translate-y-6{--tw-translate-y:calc(var(--spacing)*6);translate:var(--tw-translate-x)var(--tw-translate-y)}}@starting-style{.starting\:opacity-0{opacity:0}}}@keyframes spin{to{transform:rotate(360deg)}}@keyframes ping{75%,to{opacity:0;transform:scale(2)}}@keyframes pulse{50%{opacity:.5}}@keyframes bounce{0%,to{animation-timing-function:cubic-bezier(.8,0,1,1);transform:translateY(-25%)}50%{animation-timing-function:cubic-bezier(0,0,.2,1);transform:none}}@property --tw-translate-x{syntax:"*";inherits:false;initial-value:0}@property --tw-translate-y{syntax:"*";inherits:false;initial-value:0}@property --tw-translate-z{syntax:"*";inherits:false;initial-value:0}@property --tw-rotate-x{syntax:"*";inherits:false;initial-value:rotateX(0)}@property --tw-rotate-y{syntax:"*";inherits:false;initial-value:rotateY(0)}@property --tw-rotate-z{syntax:"*";inherits:false;initial-value:rotateZ(0)}@property --tw-skew-x{syntax:"*";inherits:false;initial-value:skewX(0)}@property --tw-skew-y{syntax:"*";inherits:false;initial-value:skewY(0)}@property --tw-space-x-reverse{syntax:"*";inherits:false;initial-value:0}@property --tw-border-style{syntax:"*";inherits:false;initial-value:solid}@property --tw-leading{syntax:"*";inherits:false}@property --tw-font-weight{syntax:"*";inherits:false}@property --tw-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-shadow-color{syntax:"*";inherits:false}@property --tw-inset-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-inset-shadow-color{syntax:"*";inherits:false}@property --tw-ring-color{syntax:"*";inherits:false}@property --tw-ring-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-inset-ring-color{syntax:"*";inherits:false}@property --tw-inset-ring-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-ring-inset{syntax:"*";inherits:false}@property --tw-ring-offset-width{syntax:"<length>";inherits:false;initial-value:0}@property --tw-ring-offset-color{syntax:"*";inherits:false;initial-value:#fff}@property --tw-ring-offset-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-blur{syntax:"*";inherits:false}@property --tw-brightness{syntax:"*";inherits:false}@property --tw-contrast{syntax:"*";inherits:false}@property --tw-grayscale{syntax:"*";inherits:false}@property --tw-hue-rotate{syntax:"*";inherits:false}@property --tw-invert{syntax:"*";inherits:false}@property --tw-opacity{syntax:"*";inherits:false}@property --tw-saturate{syntax:"*";inherits:false}@property --tw-sepia{syntax:"*";inherits:false}@property --tw-drop-shadow{syntax:"*";inherits:false}@property --tw-duration{syntax:"*";inherits:false}@property --tw-content{syntax:"*";inherits:false;initial-value:""}
-            </style>
-        @endif
-    </head>
-    <body class="bg-[#FDFDFC] dark:bg-[#0a0a0a] text-[#1b1b18] flex p-6 lg:p-8 items-center lg:justify-center min-h-screen flex-col">
-        <header class="w-full lg:max-w-4xl max-w-[335px] text-sm mb-6 not-has-[nav]:hidden">
-            @if (Route::has('login'))
-                <nav class="flex items-center justify-end gap-4">
-                    @auth
-                        <a
-                            href="{{ url('/dashboard') }}"
-                            class="inline-block px-5 py-1.5 dark:text-[#EDEDEC] border-[#19140035] hover:border-[#1915014a] border text-[#1b1b18] dark:border-[#3E3E3A] dark:hover:border-[#62605b] rounded-sm text-sm leading-normal"
-                        >
-                            Dashboard
-                        </a>
-                    @else
-                        <a
-                            href="{{ route('login') }}"
-                            class="inline-block px-5 py-1.5 dark:text-[#EDEDEC] text-[#1b1b18] border border-transparent hover:border-[#19140035] dark:hover:border-[#3E3E3A] rounded-sm text-sm leading-normal"
-                        >
-                            Log in
-                        </a>
-
-                        @if (Route::has('register'))
-                            <a
-                                href="{{ route('register') }}"
-                                class="inline-block px-5 py-1.5 dark:text-[#EDEDEC] border-[#19140035] hover:border-[#1915014a] border text-[#1b1b18] dark:border-[#3E3E3A] dark:hover:border-[#62605b] rounded-sm text-sm leading-normal">
-                                Register
-                            </a>
-                        @endif
-                    @endauth
-                </nav>
-            @endif
-        </header>
-        <div class="flex items-center justify-center w-full transition-opacity opacity-100 duration-750 lg:grow starting:opacity-0">
-            <main class="flex max-w-[335px] w-full flex-col-reverse lg:max-w-4xl lg:flex-row">
-                <div class="text-[13px] leading-[20px] flex-1 p-6 pb-12 lg:p-20 bg-white dark:bg-[#161615] dark:text-[#EDEDEC] shadow-[inset_0px_0px_0px_1px_rgba(26,26,0,0.16)] dark:shadow-[inset_0px_0px_0px_1px_#fffaed2d] rounded-bl-lg rounded-br-lg lg:rounded-tl-lg lg:rounded-br-none">
-                    <h1 class="mb-1 font-medium">Let's get started</h1>
-                    <p class="mb-2 text-[#706f6c] dark:text-[#A1A09A]">Laravel has an incredibly rich ecosystem. <br>We suggest starting with the following.</p>
-                    <ul class="flex flex-col mb-4 lg:mb-6">
-                        <li class="flex items-center gap-4 py-2 relative before:border-l before:border-[#e3e3e0] dark:before:border-[#3E3E3A] before:top-1/2 before:bottom-0 before:left-[0.4rem] before:absolute">
-                            <span class="relative py-1 bg-white dark:bg-[#161615]">
-                                <span class="flex items-center justify-center rounded-full bg-[#FDFDFC] dark:bg-[#161615] shadow-[0px_0px_1px_0px_rgba(0,0,0,0.03),0px_1px_2px_0px_rgba(0,0,0,0.06)] w-3.5 h-3.5 border dark:border-[#3E3E3A] border-[#e3e3e0]">
-                                    <span class="rounded-full bg-[#dbdbd7] dark:bg-[#3E3E3A] w-1.5 h-1.5"></span>
-                                </span>
-                            </span>
-                            <span>
-                                Read the
-                                <a href="https://laravel.com/docs" target="_blank" class="inline-flex items-center space-x-1 font-medium underline underline-offset-4 text-[#f53003] dark:text-[#FF4433] ml-1">
-                                    <span>Documentation</span>
-                                    <svg
-                                        width="10"
-                                        height="11"
-                                        viewBox="0 0 10 11"
-                                        fill="none"
-                                        xmlns="http://www.w3.org/2000/svg"
-                                        class="w-2.5 h-2.5"
-                                    >
-                                        <path
-                                            d="M7.70833 6.95834V2.79167H3.54167M2.5 8L7.5 3.00001"
-                                            stroke="currentColor"
-                                            stroke-linecap="square"
-                                        />
-                                    </svg>
-                                </a>
-                            </span>
-                        </li>
-                        <li class="flex items-center gap-4 py-2 relative before:border-l before:border-[#e3e3e0] dark:before:border-[#3E3E3A] before:bottom-1/2 before:top-0 before:left-[0.4rem] before:absolute">
-                            <span class="relative py-1 bg-white dark:bg-[#161615]">
-                                <span class="flex items-center justify-center rounded-full bg-[#FDFDFC] dark:bg-[#161615] shadow-[0px_0px_1px_0px_rgba(0,0,0,0.03),0px_1px_2px_0px_rgba(0,0,0,0.06)] w-3.5 h-3.5 border dark:border-[#3E3E3A] border-[#e3e3e0]">
-                                    <span class="rounded-full bg-[#dbdbd7] dark:bg-[#3E3E3A] w-1.5 h-1.5"></span>
-                                </span>
-                            </span>
-                            <span>
-                                Watch video tutorials at
-                                <a href="https://laracasts.com" target="_blank" class="inline-flex items-center space-x-1 font-medium underline underline-offset-4 text-[#f53003] dark:text-[#FF4433] ml-1">
-                                    <span>Laracasts</span>
-                                    <svg
-                                        width="10"
-                                        height="11"
-                                        viewBox="0 0 10 11"
-                                        fill="none"
-                                        xmlns="http://www.w3.org/2000/svg"
-                                        class="w-2.5 h-2.5"
-                                    >
-                                        <path
-                                            d="M7.70833 6.95834V2.79167H3.54167M2.5 8L7.5 3.00001"
-                                            stroke="currentColor"
-                                            stroke-linecap="square"
-                                        />
-                                    </svg>
-                                </a>
-                            </span>
-                        </li>
-                    </ul>
-                    <ul class="flex gap-3 text-sm leading-normal">
-                        <li>
-                            <a href="https://cloud.laravel.com" target="_blank" class="inline-block dark:bg-[#eeeeec] dark:border-[#eeeeec] dark:text-[#1C1C1A] dark:hover:bg-white dark:hover:border-white hover:bg-black hover:border-black px-5 py-1.5 bg-[#1b1b18] rounded-sm border border-black text-white text-sm leading-normal">
-                                Deploy now
-                            </a>
-                        </li>
-                    </ul>
-                </div>
-                <div class="bg-[#fff2f2] dark:bg-[#1D0002] relative lg:-ml-px -mb-px lg:mb-0 rounded-t-lg lg:rounded-t-none lg:rounded-r-lg aspect-[335/376] lg:aspect-auto w-full lg:w-[438px] shrink-0 overflow-hidden">
-                    {{-- Laravel Logo --}}
-                    <svg class="w-full text-[#F53003] dark:text-[#F61500] transition-all translate-y-0 opacity-100 max-w-none duration-750 starting:opacity-0 starting:translate-y-6" viewBox="0 0 438 104" fill="none" xmlns="http://www.w3.org/2000/svg">
-                        <path d="M17.2036 -3H0V102.197H49.5189V86.7187H17.2036V-3Z" fill="currentColor" />
-                        <path d="M110.256 41.6337C108.061 38.1275 104.945 35.3731 100.905 33.3681C96.8667 31.3647 92.8016 30.3618 88.7131 30.3618C83.4247 30.3618 78.5885 31.3389 74.201 33.2923C69.8111 35.2456 66.0474 37.928 62.9059 41.3333C59.7643 44.7401 57.3198 48.6726 55.5754 53.1293C53.8287 57.589 52.9572 62.274 52.9572 67.1813C52.9572 72.1925 53.8287 76.8995 55.5754 81.3069C57.3191 85.7173 59.7636 89.6241 62.9059 93.0293C66.0474 96.4361 69.8119 99.1155 74.201 101.069C78.5885 103.022 83.4247 103.999 88.7131 103.999C92.8016 103.999 96.8667 102.997 100.905 100.994C104.945 98.9911 108.061 96.2359 110.256 92.7282V102.195H126.563V32.1642H110.256V41.6337ZM108.76 75.7472C107.762 78.4531 106.366 80.8078 104.572 82.8112C102.776 84.8161 100.606 86.4183 98.0637 87.6206C95.5202 88.823 92.7004 89.4238 89.6103 89.4238C86.5178 89.4238 83.7252 88.823 81.2324 87.6206C78.7388 86.4183 76.5949 84.8161 74.7998 82.8112C73.004 80.8078 71.6319 78.4531 70.6856 75.7472C69.7356 73.0421 69.2644 70.1868 69.2644 67.1821C69.2644 64.1758 69.7356 61.3205 70.6856 58.6154C71.6319 55.9102 73.004 53.5571 74.7998 51.5522C76.5949 49.5495 78.738 47.9451 81.2324 46.7427C83.7252 45.5404 86.5178 44.9396 89.6103 44.9396C92.7012 44.9396 95.5202 45.5404 98.0637 46.7427C100.606 47.9451 102.776 49.5487 104.572 51.5522C106.367 53.5571 107.762 55.9102 108.76 58.6154C109.756 61.3205 110.256 64.1758 110.256 67.1821C110.256 70.1868 109.756 73.0421 108.76 75.7472Z" fill="currentColor" />
-                        <path d="M242.805 41.6337C240.611 38.1275 237.494 35.3731 233.455 33.3681C229.416 31.3647 225.351 30.3618 221.262 30.3618C215.974 30.3618 211.138 31.3389 206.75 33.2923C202.36 35.2456 198.597 37.928 195.455 41.3333C192.314 44.7401 189.869 48.6726 188.125 53.1293C186.378 57.589 185.507 62.274 185.507 67.1813C185.507 72.1925 186.378 76.8995 188.125 81.3069C189.868 85.7173 192.313 89.6241 195.455 93.0293C198.597 96.4361 202.361 99.1155 206.75 101.069C211.138 103.022 215.974 103.999 221.262 103.999C225.351 103.999 229.416 102.997 233.455 100.994C237.494 98.9911 240.611 96.2359 242.805 92.7282V102.195H259.112V32.1642H242.805V41.6337ZM241.31 75.7472C240.312 78.4531 238.916 80.8078 237.122 82.8112C235.326 84.8161 233.156 86.4183 230.614 87.6206C228.07 88.823 225.251 89.4238 222.16 89.4238C219.068 89.4238 216.275 88.823 213.782 87.6206C211.289 86.4183 209.145 84.8161 207.35 82.8112C205.554 80.8078 204.182 78.4531 203.236 75.7472C202.286 73.0421 201.814 70.1868 201.814 67.1821C201.814 64.1758 202.286 61.3205 203.236 58.6154C204.182 55.9102 205.554 53.5571 207.35 51.5522C209.145 49.5495 211.288 47.9451 213.782 46.7427C216.275 45.5404 219.068 44.9396 222.16 44.9396C225.251 44.9396 228.07 45.5404 230.614 46.7427C233.156 47.9451 235.326 49.5487 237.122 51.5522C238.917 53.5571 240.312 55.9102 241.31 58.6154C242.306 61.3205 242.806 64.1758 242.806 67.1821C242.805 70.1868 242.305 73.0421 241.31 75.7472Z" fill="currentColor" />
-                        <path d="M438 -3H421.694V102.197H438V-3Z" fill="currentColor" />
-                        <path d="M139.43 102.197H155.735V48.2834H183.712V32.1665H139.43V102.197Z" fill="currentColor" />
-                        <path d="M324.49 32.1665L303.995 85.794L283.498 32.1665H266.983L293.748 102.197H314.242L341.006 32.1665H324.49Z" fill="currentColor" />
-                        <path d="M376.571 30.3656C356.603 30.3656 340.797 46.8497 340.797 67.1828C340.797 89.6597 356.094 104 378.661 104C391.29 104 399.354 99.1488 409.206 88.5848L398.189 80.0226C398.183 80.031 389.874 90.9895 377.468 90.9895C363.048 90.9895 356.977 79.3111 356.977 73.269H411.075C413.917 50.1328 398.775 30.3656 376.571 30.3656ZM357.02 61.0967C357.145 59.7487 359.023 43.3761 376.442 43.3761C393.861 43.3761 395.978 59.7464 396.099 61.0967H357.02Z" fill="currentColor" />
-                    </svg>
-
-                    {{-- Light Mode 12 SVG --}}
-                    <svg class="w-[448px] max-w-none relative -mt-[4.9rem] -ml-8 lg:ml-0 lg:-mt-[6.6rem] dark:hidden" viewBox="0 0 440 376" fill="none" xmlns="http://www.w3.org/2000/svg">
-                        <g class="transition-all delay-300 translate-y-0 opacity-100 duration-750 starting:opacity-0 starting:translate-y-4">
-                            <path d="M188.263 355.73L188.595 355.73C195.441 348.845 205.766 339.761 219.569 328.477C232.93 317.193 242.978 308.205 249.714 301.511C256.34 294.626 260.867 287.358 263.296 279.708C265.725 272.058 264.565 264.121 259.816 255.896C254.516 246.716 247.062 239.352 237.454 233.805C227.957 228.067 217.908 225.198 207.307 225.198C196.927 225.197 190.136 227.97 186.934 233.516C183.621 238.872 184.726 246.331 190.247 255.894L125.647 255.891C116.371 239.825 112.395 225.481 113.72 212.858C115.265 200.235 121.559 190.481 132.602 183.596C143.754 176.52 158.607 172.982 177.159 172.983C196.594 172.984 215.863 176.523 234.968 183.6C253.961 190.486 271.299 200.241 286.98 212.864C302.661 225.488 315.14 239.833 324.416 255.899C333.03 270.817 336.841 283.918 335.847 295.203C335.075 306.487 331.376 316.336 324.75 324.751C318.346 333.167 308.408 343.494 294.936 355.734L377.094 355.737L405.917 405.656L217.087 405.649L188.263 355.73Z" fill="black" />
-                            <path d="M9.11884 226.339L-13.7396 226.338L-42.7286 176.132L43.0733 176.135L175.595 405.649L112.651 405.647L9.11884 226.339Z" fill="black" />
-                            <path d="M188.263 355.73L188.595 355.73C195.441 348.845 205.766 339.761 219.569 328.477C232.93 317.193 242.978 308.205 249.714 301.511C256.34 294.626 260.867 287.358 263.296 279.708C265.725 272.058 264.565 264.121 259.816 255.896C254.516 246.716 247.062 239.352 237.454 233.805C227.957 228.067 217.908 225.198 207.307 225.198C196.927 225.197 190.136 227.97 186.934 233.516C183.621 238.872 184.726 246.331 190.247 255.894L125.647 255.891C116.371 239.825 112.395 225.481 113.72 212.858C115.265 200.235 121.559 190.481 132.602 183.596C143.754 176.52 158.607 172.982 177.159 172.983C196.594 172.984 215.863 176.523 234.968 183.6C253.961 190.486 271.299 200.241 286.98 212.864C302.661 225.488 315.14 239.833 324.416 255.899C333.03 270.817 336.841 283.918 335.847 295.203C335.075 306.487 331.376 316.336 324.75 324.751C318.346 333.167 308.408 343.494 294.936 355.734L377.094 355.737L405.917 405.656L217.087 405.649L188.263 355.73Z" stroke="#1B1B18" stroke-width="1" />
-                            <path d="M9.11884 226.339L-13.7396 226.338L-42.7286 176.132L43.0733 176.135L175.595 405.649L112.651 405.647L9.11884 226.339Z" stroke="#1B1B18" stroke-width="1" />
-                            <path d="M204.592 327.449L204.923 327.449C211.769 320.564 222.094 311.479 235.897 300.196C249.258 288.912 259.306 279.923 266.042 273.23C272.668 266.345 277.195 259.077 279.624 251.427C282.053 243.777 280.893 235.839 276.145 227.615C270.844 218.435 263.39 211.071 253.782 205.524C244.285 199.786 234.236 196.917 223.635 196.916C213.255 196.916 206.464 199.689 203.262 205.235C199.949 210.59 201.054 218.049 206.575 227.612L141.975 227.61C132.699 211.544 128.723 197.2 130.048 184.577C131.593 171.954 137.887 162.2 148.93 155.315C160.083 148.239 174.935 144.701 193.487 144.702C212.922 144.703 232.192 148.242 251.296 155.319C270.289 162.205 287.627 171.96 303.308 184.583C318.989 197.207 331.468 211.552 340.745 227.618C349.358 242.536 353.169 255.637 352.175 266.921C351.403 278.205 347.704 288.055 341.078 296.47C334.674 304.885 324.736 315.213 311.264 327.453L393.422 327.456L422.246 377.375L233.415 377.368L204.592 327.449Z" fill="#F8B803" />
-                            <path d="M25.447 198.058L2.58852 198.057L-26.4005 147.851L59.4015 147.854L191.923 377.368L128.979 377.365L25.447 198.058Z" fill="#F8B803" />
-                            <path d="M204.592 327.449L204.923 327.449C211.769 320.564 222.094 311.479 235.897 300.196C249.258 288.912 259.306 279.923 266.042 273.23C272.668 266.345 277.195 259.077 279.624 251.427C282.053 243.777 280.893 235.839 276.145 227.615C270.844 218.435 263.39 211.071 253.782 205.524C244.285 199.786 234.236 196.917 223.635 196.916C213.255 196.916 206.464 199.689 203.262 205.235C199.949 210.59 201.054 218.049 206.575 227.612L141.975 227.61C132.699 211.544 128.723 197.2 130.048 184.577C131.593 171.954 137.887 162.2 148.93 155.315C160.083 148.239 174.935 144.701 193.487 144.702C212.922 144.703 232.192 148.242 251.296 155.319C270.289 162.205 287.627 171.96 303.308 184.583C318.989 197.207 331.468 211.552 340.745 227.618C349.358 242.536 353.169 255.637 352.175 266.921C351.403 278.205 347.704 288.055 341.078 296.47C334.674 304.885 324.736 315.213 311.264 327.453L393.422 327.456L422.246 377.375L233.415 377.368L204.592 327.449Z" stroke="#1B1B18" stroke-width="1" />
-                            <path d="M25.447 198.058L2.58852 198.057L-26.4005 147.851L59.4015 147.854L191.923 377.368L128.979 377.365L25.447 198.058Z" stroke="#1B1B18" stroke-width="1" />
-                        </g>
-                        <g style="mix-blend-mode: hard-light" class="transition-all delay-300 translate-y-0 opacity-100 duration-750 starting:opacity-0 starting:translate-y-4">
-                            <path d="M217.342 305.363L217.673 305.363C224.519 298.478 234.844 289.393 248.647 278.11C262.008 266.826 272.056 257.837 278.792 251.144C285.418 244.259 289.945 236.991 292.374 229.341C294.803 221.691 293.643 213.753 288.895 205.529C283.594 196.349 276.14 188.985 266.532 183.438C257.035 177.7 246.986 174.831 236.385 174.83C226.005 174.83 219.214 177.603 216.012 183.149C212.699 188.504 213.804 195.963 219.325 205.527L154.725 205.524C145.449 189.458 141.473 175.114 142.798 162.491C144.343 149.868 150.637 140.114 161.68 133.229C172.833 126.153 187.685 122.615 206.237 122.616C225.672 122.617 244.942 126.156 264.046 133.233C283.039 140.119 300.377 149.874 316.058 162.497C331.739 175.121 344.218 189.466 353.495 205.532C362.108 220.45 365.919 233.551 364.925 244.835C364.153 256.12 360.454 265.969 353.828 274.384C347.424 282.799 337.486 293.127 324.014 305.367L406.172 305.37L434.996 355.289L246.165 355.282L217.342 305.363Z" fill="#F0ACB8" />
-                            <path d="M38.197 175.972L15.3385 175.971L-13.6505 125.765L72.1515 125.768L204.673 355.282L141.729 355.279L38.197 175.972Z" fill="#F0ACB8" />
-                            <path d="M217.342 305.363L217.673 305.363C224.519 298.478 234.844 289.393 248.647 278.11C262.008 266.826 272.056 257.837 278.792 251.144C285.418 244.259 289.945 236.991 292.374 229.341C294.803 221.691 293.643 213.753 288.895 205.529C283.594 196.349 276.14 188.985 266.532 183.438C257.035 177.7 246.986 174.831 236.385 174.83C226.005 174.83 219.214 177.603 216.012 183.149C212.699 188.504 213.804 195.963 219.325 205.527L154.725 205.524C145.449 189.458 141.473 175.114 142.798 162.491C144.343 149.868 150.637 140.114 161.68 133.229C172.833 126.153 187.685 122.615 206.237 122.616C225.672 122.617 244.942 126.156 264.046 133.233C283.039 140.119 300.377 149.874 316.058 162.497C331.739 175.121 344.218 189.466 353.495 205.532C362.108 220.45 365.919 233.551 364.925 244.835C364.153 256.12 360.454 265.969 353.828 274.384C347.424 282.799 337.486 293.127 324.014 305.367L406.172 305.37L434.996 355.289L246.165 355.282L217.342 305.363Z" stroke="#1B1B18" stroke-width="1" />
-                            <path d="M38.197 175.972L15.3385 175.971L-13.6505 125.765L72.1515 125.768L204.673 355.282L141.729 355.279L38.197 175.972Z" stroke="#1B1B18" stroke-width="1" />
-                        </g>
-                        <g style="mix-blend-mode: plus-darker" class="transition-all delay-300 translate-y-0 opacity-100 duration-750 starting:opacity-0 starting:translate-y-4">
-                            <path d="M230.951 281.792L231.282 281.793C238.128 274.907 248.453 265.823 262.256 254.539C275.617 243.256 285.666 234.267 292.402 227.573C299.027 220.688 303.554 213.421 305.983 205.771C308.412 198.12 307.253 190.183 302.504 181.959C297.203 172.778 289.749 165.415 280.142 159.868C270.645 154.13 260.596 151.26 249.995 151.26C239.615 151.26 232.823 154.033 229.621 159.579C226.309 164.934 227.413 172.393 232.935 181.956L168.335 181.954C159.058 165.888 155.082 151.543 156.407 138.92C157.953 126.298 164.247 116.544 175.289 109.659C186.442 102.583 201.294 99.045 219.846 99.0457C239.281 99.0464 258.551 102.585 277.655 109.663C296.649 116.549 313.986 126.303 329.667 138.927C345.349 151.551 357.827 165.895 367.104 181.961C375.718 196.88 379.528 209.981 378.535 221.265C377.762 232.549 374.063 242.399 367.438 250.814C361.033 259.229 351.095 269.557 337.624 281.796L419.782 281.8L448.605 331.719L259.774 331.712L230.951 281.792Z" fill="#F3BEC7" />
-                            <path d="M51.8063 152.402L28.9479 152.401L-0.0411453 102.195L85.7608 102.198L218.282 331.711L155.339 331.709L51.8063 152.402Z" fill="#F3BEC7" />
-                            <path d="M230.951 281.792L231.282 281.793C238.128 274.907 248.453 265.823 262.256 254.539C275.617 243.256 285.666 234.267 292.402 227.573C299.027 220.688 303.554 213.421 305.983 205.771C308.412 198.12 307.253 190.183 302.504 181.959C297.203 172.778 289.749 165.415 280.142 159.868C270.645 154.13 260.596 151.26 249.995 151.26C239.615 151.26 232.823 154.033 229.621 159.579C226.309 164.934 227.413 172.393 232.935 181.956L168.335 181.954C159.058 165.888 155.082 151.543 156.407 138.92C157.953 126.298 164.247 116.544 175.289 109.659C186.442 102.583 201.294 99.045 219.846 99.0457C239.281 99.0464 258.551 102.585 277.655 109.663C296.649 116.549 313.986 126.303 329.667 138.927C345.349 151.551 357.827 165.895 367.104 181.961C375.718 196.88 379.528 209.981 378.535 221.265C377.762 232.549 374.063 242.399 367.438 250.814C361.033 259.229 351.095 269.557 337.624 281.796L419.782 281.8L448.605 331.719L259.774 331.712L230.951 281.792Z" stroke="#1B1B18" stroke-width="1" />
-                            <path d="M51.8063 152.402L28.9479 152.401L-0.0411453 102.195L85.7608 102.198L218.282 331.711L155.339 331.709L51.8063 152.402Z" stroke="#1B1B18" stroke-width="1" />
-                        </g>
-                        <g class="transition-all delay-300 translate-y-0 opacity-100 duration-750 starting:opacity-0 starting:translate-y-4">
-                            <path d="M188.467 355.363L188.798 355.363C195.644 348.478 205.969 339.393 219.772 328.11C233.133 316.826 243.181 307.837 249.917 301.144C253.696 297.217 256.792 293.166 259.205 288.991C261.024 285.845 262.455 282.628 263.499 279.341C265.928 271.691 264.768 263.753 260.02 255.529C254.719 246.349 247.265 238.985 237.657 233.438C228.16 227.7 218.111 224.831 207.51 224.83C197.13 224.83 190.339 227.603 187.137 233.149C183.824 238.504 184.929 245.963 190.45 255.527L125.851 255.524C116.574 239.458 112.598 225.114 113.923 212.491C114.615 206.836 116.261 201.756 118.859 197.253C122.061 191.704 126.709 187.03 132.805 183.229C143.958 176.153 158.81 172.615 177.362 172.616C196.797 172.617 216.067 176.156 235.171 183.233C254.164 190.119 271.502 199.874 287.183 212.497C302.864 225.121 315.343 239.466 324.62 255.532C333.233 270.45 337.044 283.551 336.05 294.835C335.46 303.459 333.16 311.245 329.151 318.194C327.915 320.337 326.515 322.4 324.953 324.384C318.549 332.799 308.611 343.127 295.139 355.367L377.297 355.37L406.121 405.289L217.29 405.282L188.467 355.363Z" stroke="#1B1B18" stroke-width="1" stroke-linejoin="bevel" />
-                            <path d="M9.32197 225.972L-13.5365 225.971L-42.5255 175.765L43.2765 175.768L175.798 405.282L112.854 405.279L9.32197 225.972Z" stroke="#1B1B18" stroke-width="1" stroke-linejoin="bevel" />
-                            <path d="M345.247 111.915C329.566 99.2919 312.229 89.5371 293.235 82.6512L235.167 183.228C254.161 190.114 271.498 199.869 287.179 212.492L345.247 111.915Z" stroke="#1B1B18" stroke-width="1" stroke-linejoin="bevel" />
-                            <path d="M382.686 154.964C373.41 138.898 360.931 124.553 345.25 111.93L287.182 212.506C302.863 225.13 315.342 239.475 324.618 255.541L382.686 154.964Z" stroke="#1B1B18" stroke-width="1" stroke-linejoin="bevel" />
-                            <path d="M293.243 82.6472C274.139 75.57 254.869 72.031 235.434 72.0303L177.366 172.607C196.801 172.608 216.071 176.147 235.175 183.224L293.243 82.6472Z" stroke="#1B1B18" stroke-width="1" stroke-linejoin="bevel" />
-                            <path d="M394.118 194.257C395.112 182.973 391.301 169.872 382.688 154.953L324.619 255.53C333.233 270.448 337.044 283.55 336.05 294.834L394.118 194.257Z" stroke="#1B1B18" stroke-width="1" stroke-linejoin="bevel" />
-                            <path d="M235.432 72.0311C216.88 72.0304 202.027 75.5681 190.875 82.6442L132.806 183.221C143.959 176.145 158.812 172.607 177.363 172.608L235.432 72.0311Z" stroke="#1B1B18" stroke-width="1" stroke-linejoin="bevel" />
-                            <path d="M265.59 124.25C276.191 124.251 286.24 127.12 295.737 132.858L237.669 233.435C228.172 227.697 218.123 224.828 207.522 224.827L265.59 124.25Z" stroke="#1B1B18" stroke-width="1" stroke-linejoin="bevel" />
-                            <path d="M295.719 132.859C305.326 138.406 312.78 145.77 318.081 154.95L260.013 255.527C254.712 246.347 247.258 238.983 237.651 233.436L295.719 132.859Z" stroke="#1B1B18" stroke-width="1" stroke-linejoin="bevel" />
-                            <path d="M387.218 217.608C391.227 210.66 393.527 202.874 394.117 194.25L336.049 294.827C335.459 303.451 333.159 311.237 329.15 318.185L387.218 217.608Z" stroke="#1B1B18" stroke-width="1" stroke-linejoin="bevel" />
-                            <path d="M245.211 132.577C248.413 127.03 255.204 124.257 265.584 124.258L207.516 224.835C197.136 224.834 190.345 227.607 187.143 233.154L245.211 132.577Z" stroke="#1B1B18" stroke-width="1" stroke-linejoin="bevel" />
-                            <path d="M318.094 154.945C322.842 163.17 324.002 171.107 321.573 178.757L263.505 279.334C265.934 271.684 264.774 263.746 260.026 255.522L318.094 154.945Z" stroke="#1B1B18" stroke-width="1" stroke-linejoin="bevel" />
-                            <path d="M176.925 96.6737C180.127 91.1249 184.776 86.4503 190.871 82.6499L132.803 183.227C126.708 187.027 122.059 191.702 118.857 197.25L176.925 96.6737Z" stroke="#1B1B18" stroke-width="1" stroke-linejoin="bevel" />
-                            <path d="M387.226 217.606C385.989 219.749 384.59 221.813 383.028 223.797L324.96 324.373C326.522 322.39 327.921 320.326 329.157 318.183L387.226 217.606Z" stroke="#1B1B18" stroke-width="1" stroke-linejoin="bevel" />
-                            <path d="M317.269 188.408C319.087 185.262 320.519 182.045 321.562 178.758L263.494 279.335C262.451 282.622 261.019 285.839 259.201 288.985L317.269 188.408Z" stroke="#1B1B18" stroke-width="1" stroke-linejoin="bevel" />
-                            <path d="M245.208 132.573C241.895 137.928 243 145.387 248.522 154.95L190.454 255.527C184.932 245.964 183.827 238.505 187.14 233.15L245.208 132.573Z" stroke="#1B1B18" stroke-width="1" stroke-linejoin="bevel" />
-                            <path d="M176.93 96.6719C174.331 101.175 172.686 106.255 171.993 111.91L113.925 212.487C114.618 206.831 116.263 201.752 118.862 197.249L176.93 96.6719Z" stroke="#1B1B18" stroke-width="1" stroke-linejoin="bevel" />
-                            <path d="M317.266 188.413C314.853 192.589 311.757 196.64 307.978 200.566L249.91 301.143C253.689 297.216 256.785 293.166 259.198 288.99L317.266 188.413Z" stroke="#1B1B18" stroke-width="1" stroke-linejoin="bevel" />
-                            <path d="M464.198 304.708L435.375 254.789L377.307 355.366L406.13 405.285L464.198 304.708Z" stroke="#1B1B18" stroke-width="1" stroke-linejoin="bevel" />
-                            <path d="M353.209 254.787C366.68 242.548 376.618 232.22 383.023 223.805L324.955 324.382C318.55 332.797 308.612 343.124 295.141 355.364L353.209 254.787Z" stroke="#1B1B18" stroke-width="1" stroke-linejoin="bevel" />
-                            <path d="M435.37 254.787L353.212 254.784L295.144 355.361L377.302 355.364L435.37 254.787Z" stroke="#1B1B18" stroke-width="1" stroke-linejoin="bevel" />
-                            <path d="M183.921 154.947L248.521 154.95L190.453 255.527L125.853 255.524L183.921 154.947Z" stroke="#1B1B18" stroke-width="1" stroke-linejoin="bevel" />
-                            <path d="M171.992 111.914C170.668 124.537 174.643 138.881 183.92 154.947L125.852 255.524C116.575 239.458 112.599 225.114 113.924 212.491L171.992 111.914Z" stroke="#1B1B18" stroke-width="1" stroke-linejoin="bevel" />
-                            <path d="M307.987 200.562C301.251 207.256 291.203 216.244 277.842 227.528L219.774 328.105C233.135 316.821 243.183 307.832 249.919 301.139L307.987 200.562Z" stroke="#1B1B18" stroke-width="1" stroke-linejoin="bevel" />
-                            <path d="M15.5469 75.1797L44.5359 125.386L-13.5321 225.963L-42.5212 175.756L15.5469 75.1797Z" stroke="#1B1B18" stroke-width="1" stroke-linejoin="bevel" />
-                            <path d="M277.836 227.536C264.033 238.82 253.708 247.904 246.862 254.789L188.794 355.366C195.64 348.481 205.965 339.397 219.768 328.113L277.836 227.536Z" stroke="#1B1B18" stroke-width="1" stroke-linejoin="bevel" />
-                            <path d="M275.358 304.706L464.189 304.713L406.12 405.29L217.29 405.283L275.358 304.706Z" stroke="#1B1B18" stroke-width="1" stroke-linejoin="bevel" />
-                            <path d="M44.5279 125.39L67.3864 125.39L9.31834 225.967L-13.5401 225.966L44.5279 125.39Z" stroke="#1B1B18" stroke-width="1" stroke-linejoin="bevel" />
-                            <path d="M101.341 75.1911L233.863 304.705L175.795 405.282L43.2733 175.768L101.341 75.1911ZM15.5431 75.19L-42.525 175.767L43.277 175.77L101.345 75.1932L15.5431 75.19Z" stroke="#1B1B18" stroke-width="1" stroke-linejoin="bevel" />
-                            <path d="M246.866 254.784L246.534 254.784L188.466 355.361L188.798 355.361L246.866 254.784Z" stroke="#1B1B18" stroke-width="1" stroke-linejoin="bevel" />
-                            <path d="M246.539 254.781L275.362 304.701L217.294 405.277L188.471 355.358L246.539 254.781Z" stroke="#1B1B18" stroke-width="1" stroke-linejoin="bevel" />
-                            <path d="M67.3906 125.391L170.923 304.698L112.855 405.275L9.32257 225.967L67.3906 125.391Z" stroke="#1B1B18" stroke-width="1" stroke-linejoin="bevel" />
-                            <path d="M170.921 304.699L233.865 304.701L175.797 405.278L112.853 405.276L170.921 304.699Z" stroke="#1B1B18" stroke-width="1" stroke-linejoin="bevel" />
-                        </g>
-                        <g style="mix-blend-mode: hard-light" class="transition-all delay-300 translate-y-0 opacity-100 duration-750 starting:opacity-0 starting:translate-y-4">
-                            <path d="M246.544 254.79L246.875 254.79C253.722 247.905 264.046 238.82 277.849 227.537C291.21 216.253 301.259 207.264 307.995 200.57C314.62 193.685 319.147 186.418 321.577 178.768C324.006 171.117 322.846 163.18 318.097 154.956C312.796 145.775 305.342 138.412 295.735 132.865C286.238 127.127 276.189 124.258 265.588 124.257C255.208 124.257 248.416 127.03 245.214 132.576C241.902 137.931 243.006 145.39 248.528 154.953L183.928 154.951C174.652 138.885 170.676 124.541 172 111.918C173.546 99.2946 179.84 89.5408 190.882 82.6559C202.035 75.5798 216.887 72.0421 235.439 72.0428C254.874 72.0435 274.144 75.5825 293.248 82.6598C312.242 89.5457 329.579 99.3005 345.261 111.924C360.942 124.548 373.421 138.892 382.697 154.958C391.311 169.877 395.121 182.978 394.128 194.262C393.355 205.546 389.656 215.396 383.031 223.811C376.627 232.226 366.688 242.554 353.217 254.794L435.375 254.797L464.198 304.716L275.367 304.709L246.544 254.79Z" fill="#F0ACB8" />
-                            <path d="M246.544 254.79L246.875 254.79C253.722 247.905 264.046 238.82 277.849 227.537C291.21 216.253 301.259 207.264 307.995 200.57C314.62 193.685 319.147 186.418 321.577 178.768C324.006 171.117 322.846 163.18 318.097 154.956C312.796 145.775 305.342 138.412 295.735 132.865C286.238 127.127 276.189 124.258 265.588 124.257C255.208 124.257 248.416 127.03 245.214 132.576C241.902 137.931 243.006 145.39 248.528 154.953L183.928 154.951C174.652 138.885 170.676 124.541 172 111.918C173.546 99.2946 179.84 89.5408 190.882 82.6559C202.035 75.5798 216.887 72.0421 235.439 72.0428C254.874 72.0435 274.144 75.5825 293.248 82.6598C312.242 89.5457 329.579 99.3005 345.261 111.924C360.942 124.548 373.421 138.892 382.697 154.958C391.311 169.877 395.121 182.978 394.128 194.262C393.355 205.546 389.656 215.396 383.031 223.811C376.627 232.226 366.688 242.554 353.217 254.794L435.375 254.797L464.198 304.716L275.367 304.709L246.544 254.79Z" stroke="#1B1B18" stroke-width="1" stroke-linejoin="round" />
-                        </g>
-                        <g style="mix-blend-mode: hard-light" class="transition-all delay-300 translate-y-0 opacity-100 duration-750 starting:opacity-0 starting:translate-y-4">
-                            <path d="M67.41 125.402L44.5515 125.401L15.5625 75.1953L101.364 75.1985L233.886 304.712L170.942 304.71L67.41 125.402Z" fill="#F0ACB8" />
-                            <path d="M67.41 125.402L44.5515 125.401L15.5625 75.1953L101.364 75.1985L233.886 304.712L170.942 304.71L67.41 125.402Z" stroke="#1B1B18" stroke-width="1" />
-                        </g>
-                    </svg>
-
-                    {{-- Dark Mode 12 SVG --}}
-                    <svg class="w-[448px] max-w-none relative -mt-[4.9rem] -ml-8 lg:ml-0 lg:-mt-[6.6rem] hidden dark:block" viewBox="0 0 440 376" fill="none" xmlns="http://www.w3.org/2000/svg">
-                        <g class="transition-all delay-300 translate-y-0 opacity-100 duration-750 starting:opacity-0 starting:translate-y-4">
-                            <path d="M188.263 355.73L188.595 355.73C195.441 348.845 205.766 339.761 219.569 328.477C232.93 317.193 242.978 308.205 249.714 301.511C256.34 294.626 260.867 287.358 263.296 279.708C265.725 272.058 264.565 264.121 259.816 255.896C254.516 246.716 247.062 239.352 237.454 233.805C227.957 228.067 217.908 225.198 207.307 225.198C196.927 225.197 190.136 227.97 186.934 233.516C183.621 238.872 184.726 246.331 190.247 255.894L125.647 255.891C116.371 239.825 112.395 225.481 113.72 212.858C115.265 200.235 121.559 190.481 132.602 183.596C143.754 176.52 158.607 172.982 177.159 172.983C196.594 172.984 215.863 176.523 234.968 183.6C253.961 190.486 271.299 200.241 286.98 212.864C302.661 225.488 315.14 239.833 324.416 255.899C333.03 270.817 336.841 283.918 335.847 295.203C335.075 306.487 331.376 316.336 324.75 324.751C318.346 333.167 308.408 343.494 294.936 355.734L377.094 355.737L405.917 405.656L217.087 405.649L188.263 355.73Z" fill="black"/>
-                            <path d="M9.11884 226.339L-13.7396 226.338L-42.7286 176.132L43.0733 176.135L175.595 405.649L112.651 405.647L9.11884 226.339Z" fill="black"/>
-                            <path d="M188.263 355.73L188.595 355.73C195.441 348.845 205.766 339.761 219.569 328.477C232.93 317.193 242.978 308.205 249.714 301.511C256.34 294.626 260.867 287.358 263.296 279.708C265.725 272.058 264.565 264.121 259.816 255.896C254.516 246.716 247.062 239.352 237.454 233.805C227.957 228.067 217.908 225.198 207.307 225.198C196.927 225.197 190.136 227.97 186.934 233.516C183.621 238.872 184.726 246.331 190.247 255.894L125.647 255.891C116.371 239.825 112.395 225.481 113.72 212.858C115.265 200.235 121.559 190.481 132.602 183.596C143.754 176.52 158.607 172.982 177.159 172.983C196.594 172.984 215.863 176.523 234.968 183.6C253.961 190.486 271.299 200.241 286.98 212.864C302.661 225.488 315.14 239.833 324.416 255.899C333.03 270.817 336.841 283.918 335.847 295.203C335.075 306.487 331.376 316.336 324.75 324.751C318.346 333.167 308.408 343.494 294.936 355.734L377.094 355.737L405.917 405.656L217.087 405.649L188.263 355.73Z" stroke="#FF750F" stroke-width="1"/>
-                            <path d="M9.11884 226.339L-13.7396 226.338L-42.7286 176.132L43.0733 176.135L175.595 405.649L112.651 405.647L9.11884 226.339Z" stroke="#FF750F" stroke-width="1"/>
-                            <path d="M204.592 327.449L204.923 327.449C211.769 320.564 222.094 311.479 235.897 300.196C249.258 288.912 259.306 279.923 266.042 273.23C272.668 266.345 277.195 259.077 279.624 251.427C282.053 243.777 280.893 235.839 276.145 227.615C270.844 218.435 263.39 211.071 253.782 205.524C244.285 199.786 234.236 196.917 223.635 196.916C213.255 196.916 206.464 199.689 203.262 205.235C199.949 210.59 201.054 218.049 206.575 227.612L141.975 227.61C132.699 211.544 128.723 197.2 130.048 184.577C131.593 171.954 137.887 162.2 148.93 155.315C160.083 148.239 174.935 144.701 193.487 144.702C212.922 144.703 232.192 148.242 251.296 155.319C270.289 162.205 287.627 171.96 303.308 184.583C318.989 197.207 331.468 211.552 340.745 227.618C349.358 242.536 353.169 255.637 352.175 266.921C351.403 278.205 347.704 288.055 341.078 296.47C334.674 304.885 324.736 315.213 311.264 327.453L393.422 327.456L422.246 377.375L233.415 377.368L204.592 327.449Z" fill="#391800"/>
-                            <path d="M25.447 198.058L2.58852 198.057L-26.4005 147.851L59.4015 147.854L191.923 377.368L128.979 377.365L25.447 198.058Z" fill="#391800"/>
-                            <path d="M204.592 327.449L204.923 327.449C211.769 320.564 222.094 311.479 235.897 300.196C249.258 288.912 259.306 279.923 266.042 273.23C272.668 266.345 277.195 259.077 279.624 251.427C282.053 243.777 280.893 235.839 276.145 227.615C270.844 218.435 263.39 211.071 253.782 205.524C244.285 199.786 234.236 196.917 223.635 196.916C213.255 196.916 206.464 199.689 203.262 205.235C199.949 210.59 201.054 218.049 206.575 227.612L141.975 227.61C132.699 211.544 128.723 197.2 130.048 184.577C131.593 171.954 137.887 162.2 148.93 155.315C160.083 148.239 174.935 144.701 193.487 144.702C212.922 144.703 232.192 148.242 251.296 155.319C270.289 162.205 287.627 171.96 303.308 184.583C318.989 197.207 331.468 211.552 340.745 227.618C349.358 242.536 353.169 255.637 352.175 266.921C351.403 278.205 347.704 288.055 341.078 296.47C334.674 304.885 324.736 315.213 311.264 327.453L393.422 327.456L422.246 377.375L233.415 377.368L204.592 327.449Z" stroke="#FF750F" stroke-width="1"/>
-                            <path d="M25.447 198.058L2.58852 198.057L-26.4005 147.851L59.4015 147.854L191.923 377.368L128.979 377.365L25.447 198.058Z" stroke="#FF750F" stroke-width="1"/>
-                        </g>
-                        <g class="transition-all delay-300 translate-y-0 opacity-100 duration-750 starting:opacity-0 starting:translate-y-4" style="mix-blend-mode:hard-light">
-                            <path d="M217.342 305.363L217.673 305.363C224.519 298.478 234.844 289.393 248.647 278.11C262.008 266.826 272.056 257.837 278.792 251.144C285.418 244.259 289.945 236.991 292.374 229.341C294.803 221.691 293.643 213.753 288.895 205.529C283.594 196.349 276.14 188.985 266.532 183.438C257.035 177.7 246.986 174.831 236.385 174.83C226.005 174.83 219.214 177.603 216.012 183.149C212.699 188.504 213.804 195.963 219.325 205.527L154.725 205.524C145.449 189.458 141.473 175.114 142.798 162.491C144.343 149.868 150.637 140.114 161.68 133.229C172.833 126.153 187.685 122.615 206.237 122.616C225.672 122.617 244.942 126.156 264.046 133.233C283.039 140.119 300.377 149.874 316.058 162.497C331.739 175.121 344.218 189.466 353.495 205.532C362.108 220.45 365.919 233.551 364.925 244.835C364.153 256.12 360.454 265.969 353.828 274.384C347.424 282.799 337.486 293.127 324.014 305.367L406.172 305.37L434.996 355.289L246.165 355.282L217.342 305.363Z" fill="#733000"/>
-                            <path d="M38.197 175.972L15.3385 175.971L-13.6505 125.765L72.1515 125.768L204.673 355.282L141.729 355.279L38.197 175.972Z" fill="#733000"/>
-                            <path d="M217.342 305.363L217.673 305.363C224.519 298.478 234.844 289.393 248.647 278.11C262.008 266.826 272.056 257.837 278.792 251.144C285.418 244.259 289.945 236.991 292.374 229.341C294.803 221.691 293.643 213.753 288.895 205.529C283.594 196.349 276.14 188.985 266.532 183.438C257.035 177.7 246.986 174.831 236.385 174.83C226.005 174.83 219.214 177.603 216.012 183.149C212.699 188.504 213.804 195.963 219.325 205.527L154.725 205.524C145.449 189.458 141.473 175.114 142.798 162.491C144.343 149.868 150.637 140.114 161.68 133.229C172.833 126.153 187.685 122.615 206.237 122.616C225.672 122.617 244.942 126.156 264.046 133.233C283.039 140.119 300.377 149.874 316.058 162.497C331.739 175.121 344.218 189.466 353.495 205.532C362.108 220.45 365.919 233.551 364.925 244.835C364.153 256.12 360.454 265.969 353.828 274.384C347.424 282.799 337.486 293.127 324.014 305.367L406.172 305.37L434.996 355.289L246.165 355.282L217.342 305.363Z" stroke="#FF750F" stroke-width="1"/>
-                            <path d="M38.197 175.972L15.3385 175.971L-13.6505 125.765L72.1515 125.768L204.673 355.282L141.729 355.279L38.197 175.972Z" stroke="#FF750F" stroke-width="1"/>
-                        </g>
-                        <g class="transition-all delay-300 translate-y-0 opacity-100 duration-750 starting:opacity-0 starting:translate-y-4">
-                            <path d="M217.342 305.363L217.673 305.363C224.519 298.478 234.844 289.393 248.647 278.11C262.008 266.826 272.056 257.837 278.792 251.144C285.418 244.259 289.945 236.991 292.374 229.341C294.803 221.691 293.643 213.753 288.895 205.529C283.594 196.349 276.14 188.985 266.532 183.438C257.035 177.7 246.986 174.831 236.385 174.83C226.005 174.83 219.214 177.603 216.012 183.149C212.699 188.504 213.804 195.963 219.325 205.527L154.726 205.524C145.449 189.458 141.473 175.114 142.798 162.491C144.343 149.868 150.637 140.114 161.68 133.229C172.833 126.153 187.685 122.615 206.237 122.616C225.672 122.617 244.942 126.156 264.046 133.233C283.039 140.119 300.377 149.874 316.058 162.497C331.739 175.121 344.218 189.466 353.495 205.532C362.108 220.45 365.919 233.551 364.925 244.835C364.153 256.12 360.454 265.969 353.828 274.384C347.424 282.799 337.486 293.127 324.014 305.367L406.172 305.37L434.996 355.289L246.165 355.282L217.342 305.363Z" stroke="#FF750F" stroke-width="1"/>
-                            <path d="M38.197 175.972L15.3385 175.971L-13.6505 125.765L72.1515 125.768L204.673 355.282L141.729 355.279L38.197 175.972Z" stroke="#FF750F" stroke-width="1"/>
-                        </g>
-                        <g class="transition-all delay-300 translate-y-0 opacity-100 duration-750 starting:opacity-0 starting:translate-y-4">
-                            <path d="M188.467 355.363L188.798 355.363C195.644 348.478 205.969 339.393 219.772 328.11C233.133 316.826 243.181 307.837 249.917 301.144C253.696 297.217 256.792 293.166 259.205 288.991C261.024 285.845 262.455 282.628 263.499 279.341C265.928 271.691 264.768 263.753 260.02 255.529C254.719 246.349 247.265 238.985 237.657 233.438C228.16 227.7 218.111 224.831 207.51 224.83C197.13 224.83 190.339 227.603 187.137 233.149C183.824 238.504 184.929 245.963 190.45 255.527L125.851 255.524C116.574 239.458 112.598 225.114 113.923 212.491C114.615 206.836 116.261 201.756 118.859 197.253C122.061 191.704 126.709 187.03 132.805 183.229C143.958 176.153 158.81 172.615 177.362 172.616C196.797 172.617 216.067 176.156 235.171 183.233C254.164 190.119 271.502 199.874 287.183 212.497C302.864 225.121 315.343 239.466 324.62 255.532C333.233 270.45 337.044 283.551 336.05 294.835C335.46 303.459 333.16 311.245 329.151 318.194C327.915 320.337 326.515 322.4 324.953 324.384C318.549 332.799 308.611 343.127 295.139 355.367L377.297 355.37L406.121 405.289L217.29 405.282L188.467 355.363Z" stroke="#FF750F" stroke-width="1" stroke-linejoin="bevel"/>
-                            <path d="M9.32197 225.972L-13.5365 225.971L-42.5255 175.765L43.2765 175.768L175.798 405.282L112.854 405.279L9.32197 225.972Z" stroke="#FF750F" stroke-width="1" stroke-linejoin="bevel"/>
-                            <path d="M345.247 111.915C329.566 99.2919 312.229 89.5371 293.235 82.6512L235.167 183.228C254.161 190.114 271.498 199.869 287.179 212.492L345.247 111.915Z" stroke="#FF750F" stroke-width="1" stroke-linejoin="bevel"/>
-                            <path d="M382.686 154.964C373.41 138.898 360.931 124.553 345.25 111.93L287.182 212.506C302.863 225.13 315.342 239.475 324.618 255.541L382.686 154.964Z" stroke="#FF750F" stroke-width="1" stroke-linejoin="bevel"/>
-                            <path d="M293.243 82.6472C274.139 75.57 254.869 72.031 235.434 72.0303L177.366 172.607C196.801 172.608 216.071 176.147 235.175 183.224L293.243 82.6472Z" stroke="#FF750F" stroke-width="1" stroke-linejoin="bevel"/>
-                            <path d="M394.118 194.257C395.112 182.973 391.301 169.872 382.688 154.953L324.619 255.53C333.233 270.448 337.044 283.55 336.05 294.834L394.118 194.257Z" stroke="#FF750F" stroke-width="1" stroke-linejoin="bevel"/>
-                            <path d="M235.432 72.0311C216.88 72.0304 202.027 75.5681 190.875 82.6442L132.806 183.221C143.959 176.145 158.812 172.607 177.363 172.608L235.432 72.0311Z" stroke="#FF750F" stroke-width="1" stroke-linejoin="bevel"/>
-                            <path d="M265.59 124.25C276.191 124.251 286.24 127.12 295.737 132.858L237.669 233.435C228.172 227.697 218.123 224.828 207.522 224.827L265.59 124.25Z" stroke="#FF750F" stroke-width="1" stroke-linejoin="bevel"/>
-                            <path d="M295.719 132.859C305.326 138.406 312.78 145.77 318.081 154.95L260.013 255.527C254.712 246.347 247.258 238.983 237.651 233.436L295.719 132.859Z" stroke="#FF750F" stroke-width="1" stroke-linejoin="bevel"/>
-                            <path d="M387.218 217.608C391.227 210.66 393.527 202.874 394.117 194.25L336.049 294.827C335.459 303.451 333.159 311.237 329.15 318.185L387.218 217.608Z" stroke="#FF750F" stroke-width="1" stroke-linejoin="bevel"/>
-                            <path d="M245.211 132.577C248.413 127.03 255.204 124.257 265.584 124.258L207.516 224.835C197.136 224.834 190.345 227.607 187.143 233.154L245.211 132.577Z" stroke="#FF750F" stroke-width="1" stroke-linejoin="bevel"/>
-                            <path d="M318.094 154.945C322.842 163.17 324.002 171.107 321.573 178.757L263.505 279.334C265.934 271.684 264.774 263.746 260.026 255.522L318.094 154.945Z" stroke="#FF750F" stroke-width="1" stroke-linejoin="bevel"/>
-                            <path d="M176.925 96.6737C180.127 91.1249 184.776 86.4503 190.871 82.6499L132.803 183.227C126.708 187.027 122.059 191.702 118.857 197.25L176.925 96.6737Z" stroke="#FF750F" stroke-width="1" stroke-linejoin="bevel"/>
-                            <path d="M387.226 217.606C385.989 219.749 384.59 221.813 383.028 223.797L324.96 324.373C326.522 322.39 327.921 320.326 329.157 318.183L387.226 217.606Z" stroke="#FF750F" stroke-width="1" stroke-linejoin="bevel"/>
-                            <path d="M317.269 188.408C319.087 185.262 320.519 182.045 321.562 178.758L263.494 279.335C262.451 282.622 261.019 285.839 259.201 288.985L317.269 188.408Z" stroke="#FF750F" stroke-width="1" stroke-linejoin="bevel"/>
-                            <path d="M245.208 132.573C241.895 137.928 243 145.387 248.522 154.95L190.454 255.527C184.932 245.964 183.827 238.505 187.14 233.15L245.208 132.573Z" stroke="#FF750F" stroke-width="1" stroke-linejoin="bevel"/>
-                            <path d="M176.93 96.6719C174.331 101.175 172.686 106.255 171.993 111.91L113.925 212.487C114.618 206.831 116.263 201.752 118.862 197.249L176.93 96.6719Z" stroke="#FF750F" stroke-width="1" stroke-linejoin="bevel"/>
-                            <path d="M317.266 188.413C314.853 192.589 311.757 196.64 307.978 200.566L249.91 301.143C253.689 297.216 256.785 293.166 259.198 288.99L317.266 188.413Z" stroke="#FF750F" stroke-width="1" stroke-linejoin="bevel"/>
-                            <path d="M464.198 304.708L435.375 254.789L377.307 355.366L406.13 405.285L464.198 304.708Z" stroke="#FF750F" stroke-width="1" stroke-linejoin="bevel"/>
-                            <path d="M353.209 254.787C366.68 242.548 376.618 232.22 383.023 223.805L324.955 324.382C318.55 332.797 308.612 343.124 295.141 355.364L353.209 254.787Z" stroke="#FF750F" stroke-width="1" stroke-linejoin="bevel"/>
-                            <path d="M435.37 254.787L353.212 254.784L295.144 355.361L377.302 355.364L435.37 254.787Z" stroke="#FF750F" stroke-width="1" stroke-linejoin="bevel"/>
-                            <path d="M183.921 154.947L248.521 154.95L190.453 255.527L125.853 255.524L183.921 154.947Z" stroke="#FF750F" stroke-width="1" stroke-linejoin="bevel"/>
-                            <path d="M171.992 111.914C170.668 124.537 174.643 138.881 183.92 154.947L125.852 255.524C116.575 239.458 112.599 225.114 113.924 212.491L171.992 111.914Z" stroke="#FF750F" stroke-width="1" stroke-linejoin="bevel"/>
-                            <path d="M307.987 200.562C301.251 207.256 291.203 216.244 277.842 227.528L219.774 328.105C233.135 316.821 243.183 307.832 249.919 301.139L307.987 200.562Z" stroke="#FF750F" stroke-width="1" stroke-linejoin="bevel"/>
-                            <path d="M15.5469 75.1797L44.5359 125.386L-13.5321 225.963L-42.5212 175.756L15.5469 75.1797Z" stroke="#FF750F" stroke-width="1" stroke-linejoin="bevel"/>
-                            <path d="M277.836 227.536C264.033 238.82 253.708 247.904 246.862 254.789L188.794 355.366C195.64 348.481 205.965 339.397 219.768 328.113L277.836 227.536Z" stroke="#FF750F" stroke-width="1" stroke-linejoin="bevel"/>
-                            <path d="M275.358 304.706L464.189 304.713L406.12 405.29L217.29 405.283L275.358 304.706Z" stroke="#FF750F" stroke-width="1" stroke-linejoin="bevel"/>
-                            <path d="M44.5279 125.39L67.3864 125.39L9.31834 225.967L-13.5401 225.966L44.5279 125.39Z" stroke="#FF750F" stroke-width="1" stroke-linejoin="bevel"/>
-                            <path d="M101.341 75.1911L233.863 304.705L175.795 405.282L43.2733 175.768L101.341 75.1911ZM15.5431 75.19L-42.525 175.767L43.277 175.77L101.345 75.1932L15.5431 75.19Z" stroke="#FF750F" stroke-width="1" stroke-linejoin="bevel"/>
-                            <path d="M246.866 254.784L246.534 254.784L188.466 355.361L188.798 355.361L246.866 254.784Z" stroke="#FF750F" stroke-width="1" stroke-linejoin="bevel"/>
-                            <path d="M246.539 254.781L275.362 304.701L217.294 405.277L188.471 355.358L246.539 254.781Z" stroke="#FF750F" stroke-width="1" stroke-linejoin="bevel"/>
-                            <path d="M67.3906 125.391L170.923 304.698L112.855 405.275L9.32257 225.967L67.3906 125.391Z" stroke="#FF750F" stroke-width="1" stroke-linejoin="bevel"/>
-                            <path d="M170.921 304.699L233.865 304.701L175.797 405.278L112.853 405.276L170.921 304.699Z" stroke="#FF750F" stroke-width="1" stroke-linejoin="bevel"/>
-                        </g>
-                        <g class="transition-all delay-300 translate-y-0 opacity-100 duration-750 starting:opacity-0 starting:translate-y-4" style="mix-blend-mode:hard-light">
-                            <path d="M246.544 254.79L246.875 254.79C253.722 247.905 264.046 238.82 277.849 227.537C291.21 216.253 301.259 207.264 307.995 200.57C314.62 193.685 319.147 186.418 321.577 178.768C324.006 171.117 322.846 163.18 318.097 154.956C312.796 145.775 305.342 138.412 295.735 132.865C286.238 127.127 276.189 124.258 265.588 124.257C255.208 124.257 248.416 127.03 245.214 132.576C241.902 137.931 243.006 145.39 248.528 154.953L183.928 154.951C174.652 138.885 170.676 124.541 172 111.918C173.546 99.2946 179.84 89.5408 190.882 82.6559C202.035 75.5798 216.887 72.0421 235.439 72.0428C254.874 72.0435 274.144 75.5825 293.248 82.6598C312.242 89.5457 329.579 99.3005 345.261 111.924C360.942 124.548 373.421 138.892 382.697 154.958C391.311 169.877 395.121 182.978 394.128 194.262C393.355 205.546 389.656 215.396 383.031 223.811C376.627 232.226 366.688 242.554 353.217 254.794L435.375 254.797L464.198 304.716L275.367 304.709L246.544 254.79Z" fill="#4B0600"/>
-                            <path d="M246.544 254.79L246.875 254.79C253.722 247.905 264.046 238.82 277.849 227.537C291.21 216.253 301.259 207.264 307.995 200.57C314.62 193.685 319.147 186.418 321.577 178.768C324.006 171.117 322.846 163.18 318.097 154.956C312.796 145.775 305.342 138.412 295.735 132.865C286.238 127.127 276.189 124.258 265.588 124.257C255.208 124.257 248.416 127.03 245.214 132.576C241.902 137.931 243.006 145.39 248.528 154.953L183.928 154.951C174.652 138.885 170.676 124.541 172 111.918C173.546 99.2946 179.84 89.5408 190.882 82.6559C202.035 75.5798 216.887 72.0421 235.439 72.0428C254.874 72.0435 274.144 75.5825 293.248 82.6598C312.242 89.5457 329.579 99.3005 345.261 111.924C360.942 124.548 373.421 138.892 382.697 154.958C391.311 169.877 395.121 182.978 394.128 194.262C393.355 205.546 389.656 215.396 383.031 223.811C376.627 232.226 366.688 242.554 353.217 254.794L435.375 254.797L464.198 304.716L275.367 304.709L246.544 254.79Z" stroke="#FF750F" stroke-width="1" stroke-linejoin="round"/>
-                        </g>
-                        <g class="transition-all delay-300 translate-y-0 opacity-100 duration-750 starting:opacity-0 starting:translate-y-4" style="mix-blend-mode:hard-light">
-                            <path d="M67.41 125.402L44.5515 125.401L15.5625 75.1953L101.364 75.1985L233.886 304.712L170.942 304.71L67.41 125.402Z" fill="#4B0600"/>
-                            <path d="M67.41 125.402L44.5515 125.401L15.5625 75.1953L101.364 75.1985L233.886 304.712L170.942 304.71L67.41 125.402Z" stroke="#FF750F" stroke-width="1"/>
-                        </g>
-                    </svg>
-                    <div class="absolute inset-0 rounded-t-lg lg:rounded-t-none lg:rounded-r-lg shadow-[inset_0px_0px_0px_1px_rgba(26,26,0,0.16)] dark:shadow-[inset_0px_0px_0px_1px_#fffaed2d]"></div>
-                </div>
-            </main>
-        </div>
-
-        @if (Route::has('login'))
-            <div class="h-14.5 hidden lg:block"></div>
-        @endif
-    </body>
-</html>

From 0d62fe992f04aad3c4cb53b3b30f7071efb3e7ff Mon Sep 17 00:00:00 2001
From: Lucian Behind The Scenes <silviulucian@gmail.com>
Date: Fri, 20 Feb 2026 12:30:23 +0200
Subject: [PATCH 7/8] fixup

---
 app/Services/DocsOutputCacheService.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/app/Services/DocsOutputCacheService.php b/app/Services/DocsOutputCacheService.php
index 20349d7..7145264 100644
--- a/app/Services/DocsOutputCacheService.php
+++ b/app/Services/DocsOutputCacheService.php
@@ -19,7 +19,7 @@ public function __construct(
     public function key(string $namespace, array $segments = []): string
     {
         $normalizedSegments = array_map(
-            fn (mixed $segment): string => $this->normalizeSegment($segment),
+            $this->normalizeSegment(...),
             $segments,
         );
 

From 02f024fc53096c7ddd5c81e14e3a81399fa399f6 Mon Sep 17 00:00:00 2001
From: Lucian Behind The Scenes <silviulucian@gmail.com>
Date: Fri, 20 Feb 2026 12:37:57 +0200
Subject: [PATCH 8/8] fixup

---
 resources/views/components/docs/toc.blade.php |  8 +---
 .../icon/square-arrow-out-up-right.blade.php  | 45 -------------------
 2 files changed, 1 insertion(+), 52 deletions(-)
 delete mode 100644 resources/views/flux/icon/square-arrow-out-up-right.blade.php

diff --git a/resources/views/components/docs/toc.blade.php b/resources/views/components/docs/toc.blade.php
index 7a32f00..f65c13e 100644
--- a/resources/views/components/docs/toc.blade.php
+++ b/resources/views/components/docs/toc.blade.php
@@ -15,12 +15,6 @@
     @endforeach
 
     <flux:navlist.group heading="Index">
-        <flux:navlist.item href="{{ route('command-index') }}" wire:navigate :current="$currentPath === 'command-index'">
-            <div class="flex items-center gap-2">
-                <span>Command Index</span>
-
-                <flux:icon.square-arrow-out-up-right class="size-3" />
-            </div>
-        </flux:navlist.item>
+        <flux:navlist.item href="{{ route('command-index') }}" wire:navigate :current="$currentPath === 'command-index'">Command Index</flux:navlist.item>
     </flux:navlist.group>
 </flux:navlist>
diff --git a/resources/views/flux/icon/square-arrow-out-up-right.blade.php b/resources/views/flux/icon/square-arrow-out-up-right.blade.php
deleted file mode 100644
index bb331eb..0000000
--- a/resources/views/flux/icon/square-arrow-out-up-right.blade.php
+++ /dev/null
@@ -1,45 +0,0 @@
-@blaze
-
-{{-- Credit: Lucide (https://lucide.dev) --}}
-
-@props([
-    'variant' => 'outline',
-])
-
-@php
-if ($variant === 'solid') {
-    throw new \Exception('The "solid" variant is not supported in Lucide.');
-}
-
-$classes = Flux::classes('shrink-0')
-    ->add(match($variant) {
-        'outline' => '[:where(&)]:size-6',
-        'solid' => '[:where(&)]:size-6',
-        'mini' => '[:where(&)]:size-5',
-        'micro' => '[:where(&)]:size-4',
-    });
-
-$strokeWidth = match ($variant) {
-    'outline' => 2,
-    'mini' => 2.25,
-    'micro' => 2.5,
-};
-@endphp
-
-<svg
-    {{ $attributes->class($classes) }}
-    data-flux-icon
-    xmlns="http://www.w3.org/2000/svg"
-    viewBox="0 0 24 24"
-    fill="none"
-    stroke="currentColor"
-    stroke-width="{{ $strokeWidth }}"
-    stroke-linecap="round"
-    stroke-linejoin="round"
-    aria-hidden="true"
-    data-slot="icon"
->
-  <path d="M21 13v6a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h6" />
-  <path d="m21 3-9 9" />
-  <path d="M15 3h6v6" />
-</svg>