From 0f4588908839a0317c0149687e76809895560033 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Felipe=20Say=C3=A3o=20Lobato=20Abreu?=
 <github@mentordosnerds.com>
Date: Sun, 19 Apr 2026 18:48:38 -0300
Subject: [PATCH 1/8] Redirect homepage to guides when available

---
 README.md       |  3 +-
 index.html.twig | 90 ++++++++++++++++++++++++++++++++++++-------------
 2 files changed, 68 insertions(+), 25 deletions(-)

diff --git a/README.md b/README.md
index b41f922..7b9c5b0 100644
--- a/README.md
+++ b/README.md
@@ -17,6 +17,7 @@ A clean and modern Bootstrap-based template for phpDocumentor, designed to impro
 - Responsive and mobile-friendly
 - Styled code blocks and documentation elements
 - Improved tables of contents and element listings
+- Automatic homepage redirect to the guides index when guides are available
 
 ## Installation
 
@@ -88,4 +89,4 @@ Contributions are welcome. Please open an issue or submit a pull request.
 
 ## 📄 License
 
-This package is licensed under the MIT License. See the [LICENSE](LICENSE) file for more details.
\ No newline at end of file
+This package is licensed under the MIT License. See the [LICENSE](LICENSE) file for more details.
diff --git a/index.html.twig b/index.html.twig
index 5f8ede8..b780526 100644
--- a/index.html.twig
+++ b/index.html.twig
@@ -1,28 +1,70 @@
 {% extends 'base.html.twig' %}
 
+{% set guideHome = null %}
+{% set guideFallback = null %}
+
+{% for version in project.versions if guideHome is null %}
+    {% for documentation in version.documentationSets if guideHome is null %}
+        {% for guide in documentation.documents|default([]) %}
+            {% if guideFallback is null %}
+                {% set guideFallback = link(guide) %}
+            {% endif %}
+
+            {% if guideHome is null and (guide.file == 'index' or guide.file ends with '/index') %}
+                {% set guideHome = link(guide) %}
+            {% endif %}
+        {% endfor %}
+    {% endfor %}
+{% endfor %}
+
+{% if guideHome is null %}
+    {% set guideHome = guideFallback %}
+{% endif %}
+
+{% block head %}
+    {% if guideHome %}
+        <meta http-equiv="refresh" content="0;url={{ guideHome }}">
+        <link rel="canonical" href="{{ guideHome }}">
+    {% endif %}
+    {{ parent() }}
+{% endblock %}
+
 {% block content %}
-    <section class="jumbotron jumbotron-fluid bg-white p-0">
-        <div class="container">
-            <h1 class="display-3">Documentation</h1>
-            <p class="lead">Welcome to the <strong>{{ project.name }}</strong> API documentation.</p>
-            <hr class="my-4">
-        </div>
-    </section>
-
-    <section>
-        {% set node = project.namespace %}
-
-        {{
-        include(
-            'components/table-of-contents.html.twig',
-            {
-                'node': project.namespace,
-                'namespaces': usesNamespaces or not usesPackages ? node.children : [],
-                'packages': usesPackages ? project.package.children : []
-            }
-        )
-        }}
-        {{ include('components/constants.html.twig', {'node': project.namespace}) }}
-        {{ include('components/functions.html.twig', {'node': project.namespace}) }}
-    </section>
+    {% if guideHome %}
+        <section class="jumbotron jumbotron-fluid bg-white p-0">
+            <div class="container">
+                <h1 class="display-3">Documentation</h1>
+                <p class="lead">Redirecting to the guide home for <strong>{{ project.name }}</strong>.</p>
+                <hr class="my-4">
+                <p class="mb-0">
+                    <a class="btn btn-primary" href="{{ guideHome }}">Open guide home</a>
+                </p>
+            </div>
+        </section>
+    {% else %}
+        <section class="jumbotron jumbotron-fluid bg-white p-0">
+            <div class="container">
+                <h1 class="display-3">Documentation</h1>
+                <p class="lead">Welcome to the <strong>{{ project.name }}</strong> API documentation.</p>
+                <hr class="my-4">
+            </div>
+        </section>
+
+        <section>
+            {% set node = project.namespace %}
+
+            {{
+            include(
+                'components/table-of-contents.html.twig',
+                {
+                    'node': project.namespace,
+                    'namespaces': usesNamespaces or not usesPackages ? node.children : [],
+                    'packages': usesPackages ? project.package.children : []
+                }
+            )
+            }}
+            {{ include('components/constants.html.twig', {'node': project.namespace}) }}
+            {{ include('components/functions.html.twig', {'node': project.namespace}) }}
+        </section>
+    {% endif %}
 {% endblock %}

From 4bec8bdeeb911a751ce5be5069ba32f57f258220 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Felipe=20Say=C3=A3o=20Lobato=20Abreu?=
 <github@mentordosnerds.com>
Date: Sun, 19 Apr 2026 18:51:26 -0300
Subject: [PATCH 2/8] Render guide homepage content inline

---
 README.md       |  2 +-
 index.html.twig | 40 +++++++++++++++++++---------------------
 2 files changed, 20 insertions(+), 22 deletions(-)

diff --git a/README.md b/README.md
index 7b9c5b0..1384e0b 100644
--- a/README.md
+++ b/README.md
@@ -17,7 +17,7 @@ A clean and modern Bootstrap-based template for phpDocumentor, designed to impro
 - Responsive and mobile-friendly
 - Styled code blocks and documentation elements
 - Improved tables of contents and element listings
-- Automatic homepage redirect to the guides index when guides are available
+- Automatic homepage rendering of the guides index when guides are available
 
 ## Installation
 
diff --git a/index.html.twig b/index.html.twig
index b780526..419c0ee 100644
--- a/index.html.twig
+++ b/index.html.twig
@@ -3,18 +3,22 @@
 {% set guideHome = null %}
 {% set guideFallback = null %}
 
-{% for version in project.versions if guideHome is null %}
-    {% for documentation in version.documentationSets if guideHome is null %}
-        {% for guide in documentation.documents|default([]) %}
-            {% if guideFallback is null %}
-                {% set guideFallback = link(guide) %}
-            {% endif %}
+{% for version in project.versions %}
+    {% if guideHome is null %}
+        {% for documentation in version.documentationSets %}
+            {% if guideHome is null %}
+                {% for guide in documentation.documents|default([]) %}
+                    {% if guideFallback is null %}
+                        {% set guideFallback = guide %}
+                    {% endif %}
 
-            {% if guideHome is null and (guide.file == 'index' or guide.file ends with '/index') %}
-                {% set guideHome = link(guide) %}
+                    {% if guideHome is null and (guide.file == 'index' or guide.file ends with '/index') %}
+                        {% set guideHome = guide %}
+                    {% endif %}
+                {% endfor %}
             {% endif %}
         {% endfor %}
-    {% endfor %}
+    {% endif %}
 {% endfor %}
 
 {% if guideHome is null %}
@@ -23,24 +27,18 @@
 
 {% block head %}
     {% if guideHome %}
-        <meta http-equiv="refresh" content="0;url={{ guideHome }}">
-        <link rel="canonical" href="{{ guideHome }}">
+        {% for headerNode in guideHome.documentNode.headerNodes %}
+            {{ renderNode(headerNode) }}
+        {% endfor %}
     {% endif %}
     {{ parent() }}
 {% endblock %}
 
 {% block content %}
     {% if guideHome %}
-        <section class="jumbotron jumbotron-fluid bg-white p-0">
-            <div class="container">
-                <h1 class="display-3">Documentation</h1>
-                <p class="lead">Redirecting to the guide home for <strong>{{ project.name }}</strong>.</p>
-                <hr class="my-4">
-                <p class="mb-0">
-                    <a class="btn btn-primary" href="{{ guideHome }}">Open guide home</a>
-                </p>
-            </div>
-        </section>
+        {% for child in guideHome.documentNode.children %}
+            {{ renderNode(child) }}
+        {% endfor %}
     {% else %}
         <section class="jumbotron jumbotron-fluid bg-white p-0">
             <div class="container">

From d666391746cca35ddea76791afc7c6cb6d6bdc9e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Felipe=20Say=C3=A3o=20Lobato=20Abreu?=
 <github@mentordosnerds.com>
Date: Sun, 19 Apr 2026 18:54:08 -0300
Subject: [PATCH 3/8] Load guide homepage content inline

---
 README.md       |  2 +-
 index.html.twig | 95 +++++++++++++++++++++++++++++++++++++------------
 2 files changed, 73 insertions(+), 24 deletions(-)

diff --git a/README.md b/README.md
index 1384e0b..4aca125 100644
--- a/README.md
+++ b/README.md
@@ -17,7 +17,7 @@ A clean and modern Bootstrap-based template for phpDocumentor, designed to impro
 - Responsive and mobile-friendly
 - Styled code blocks and documentation elements
 - Improved tables of contents and element listings
-- Automatic homepage rendering of the guides index when guides are available
+- Automatic homepage loading of the guides index content when guides are available
 
 ## Installation
 
diff --git a/index.html.twig b/index.html.twig
index 419c0ee..c7ca214 100644
--- a/index.html.twig
+++ b/index.html.twig
@@ -1,19 +1,21 @@
 {% extends 'base.html.twig' %}
 
-{% set guideHome = null %}
-{% set guideFallback = null %}
+{% set guideHomeUrl = null %}
+{% set guideFallbackUrl = null %}
 
 {% for version in project.versions %}
-    {% if guideHome is null %}
+    {% if guideHomeUrl is null %}
         {% for documentation in version.documentationSets %}
-            {% if guideHome is null %}
+            {% if guideHomeUrl is null %}
                 {% for guide in documentation.documents|default([]) %}
-                    {% if guideFallback is null %}
-                        {% set guideFallback = guide %}
+                    {% set guideUrl = link(guide) %}
+
+                    {% if guideFallbackUrl is null and guideUrl %}
+                        {% set guideFallbackUrl = guideUrl %}
                     {% endif %}
 
-                    {% if guideHome is null and (guide.file == 'index' or guide.file ends with '/index') %}
-                        {% set guideHome = guide %}
+                    {% if guideHomeUrl is null and guideUrl and (guide.file == 'index' or guide.file ends with '/index') %}
+                        {% set guideHomeUrl = guideUrl %}
                     {% endif %}
                 {% endfor %}
             {% endif %}
@@ -21,24 +23,71 @@
     {% endif %}
 {% endfor %}
 
-{% if guideHome is null %}
-    {% set guideHome = guideFallback %}
+{% if guideHomeUrl is null %}
+    {% set guideHomeUrl = guideFallbackUrl %}
 {% endif %}
 
-{% block head %}
-    {% if guideHome %}
-        {% for headerNode in guideHome.documentNode.headerNodes %}
-            {{ renderNode(headerNode) }}
-        {% endfor %}
-    {% endif %}
-    {{ parent() }}
-{% endblock %}
-
 {% block content %}
-    {% if guideHome %}
-        {% for child in guideHome.documentNode.children %}
-            {{ renderNode(child) }}
-        {% endfor %}
+    {% if guideHomeUrl %}
+        <div
+            data-guide-home
+            data-guide-url="{{ guideHomeUrl }}"
+            aria-live="polite"
+        >
+            <section class="jumbotron jumbotron-fluid bg-white p-0">
+                <div class="container">
+                    <h1 class="display-3">Documentation</h1>
+                    <p class="lead">Loading the guide home for <strong>{{ project.name }}</strong>.</p>
+                    <hr class="my-4">
+                    <p class="mb-0">
+                        <a class="btn btn-primary" href="{{ guideHomeUrl }}">Open guide home</a>
+                    </p>
+                </div>
+            </section>
+        </div>
+
+        <script>
+            (function () {
+                const container = document.querySelector('[data-guide-home]');
+
+                if (!container) {
+                    return;
+                }
+
+                const guideUrl = container.getAttribute('data-guide-url');
+
+                if (!guideUrl) {
+                    return;
+                }
+
+                fetch(guideUrl)
+                    .then(function (response) {
+                        if (!response.ok) {
+                            throw new Error('Failed to load guide home');
+                        }
+
+                        return response.text();
+                    })
+                    .then(function (html) {
+                        const parser = new DOMParser();
+                        const documentHtml = parser.parseFromString(html, 'text/html');
+                        const guideContent = documentHtml.querySelector('#content .bg-body.rounded-4');
+
+                        if (!guideContent) {
+                            throw new Error('Guide content container not found');
+                        }
+
+                        container.innerHTML = guideContent.innerHTML;
+
+                        if (documentHtml.title) {
+                            document.title = documentHtml.title;
+                        }
+                    })
+                    .catch(function () {
+                        // Keep the fallback CTA visible when inline loading fails.
+                    });
+            }());
+        </script>
     {% else %}
         <section class="jumbotron jumbotron-fluid bg-white p-0">
             <div class="container">

From 35c2a461d4edc81f6fbb413873cf2e59b45a79fb Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Felipe=20Say=C3=A3o=20Lobato=20Abreu?=
 <github@mentordosnerds.com>
Date: Sun, 19 Apr 2026 18:58:19 -0300
Subject: [PATCH 4/8] Use guide output location for homepage loading

---
 index.html.twig | 13 +++++++++----
 1 file changed, 9 insertions(+), 4 deletions(-)

diff --git a/index.html.twig b/index.html.twig
index c7ca214..c16334d 100644
--- a/index.html.twig
+++ b/index.html.twig
@@ -8,7 +8,11 @@
         {% for documentation in version.documentationSets %}
             {% if guideHomeUrl is null %}
                 {% for guide in documentation.documents|default([]) %}
-                    {% set guideUrl = link(guide) %}
+                    {% set guideUrl = guide.file ~ '.html' %}
+
+                    {% if documentation.outputLocation != '' and documentation.outputLocation != '.' %}
+                        {% set guideUrl = documentation.outputLocation ~ '/' ~ guideUrl %}
+                    {% endif %}
 
                     {% if guideFallbackUrl is null and guideUrl %}
                         {% set guideFallbackUrl = guideUrl %}
@@ -39,13 +43,14 @@
                     <h1 class="display-3">Documentation</h1>
                     <p class="lead">Loading the guide home for <strong>{{ project.name }}</strong>.</p>
                     <hr class="my-4">
-                    <p class="mb-0">
-                        <a class="btn btn-primary" href="{{ guideHomeUrl }}">Open guide home</a>
-                    </p>
                 </div>
             </section>
         </div>
 
+        <noscript>
+            <meta http-equiv="refresh" content="0;url={{ guideHomeUrl }}">
+        </noscript>
+
         <script>
             (function () {
                 const container = document.querySelector('[data-guide-home]');

From f2dd4719b69f17b754be78330f4beca0a200a8ba Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Felipe=20Say=C3=A3o=20Lobato=20Abreu?=
 <github@mentordosnerds.com>
Date: Sun, 19 Apr 2026 19:12:21 -0300
Subject: [PATCH 5/8] Use guides as homepage and harden asset paths

---
 README.md        |  12 +++-
 index.html.twig  | 140 ++++++++---------------------------------------
 layout.html.twig |   8 +--
 template.xml     |   1 -
 4 files changed, 37 insertions(+), 124 deletions(-)

diff --git a/README.md b/README.md
index 4aca125..b8aa8ba 100644
--- a/README.md
+++ b/README.md
@@ -17,7 +17,7 @@ A clean and modern Bootstrap-based template for phpDocumentor, designed to impro
 - Responsive and mobile-friendly
 - Styled code blocks and documentation elements
 - Improved tables of contents and element listings
-- Automatic homepage loading of the guides index content when guides are available
+- Designed for documentation sets that provide guides
 
 ## Installation
 
@@ -29,7 +29,7 @@ composer require --dev fast-forward/phpdoc-bootstrap-template
 
 ## Usage
 
-Reference the template from vendor in your phpdoc.xml:
+Reference the template from vendor in your phpdoc.xml. This template is designed for projects that ship guides, and the guide output should point to the documentation root (`.`) so the guide index becomes the homepage:
 
 ```xml
 <?xml version="1.0" encoding="UTF-8" ?>
@@ -48,6 +48,12 @@ Reference the template from vendor in your phpdoc.xml:
                 <path>src</path>
             </source>
         </api>
+        <guide format="rst">
+            <source dsn=".">
+                <path>docs</path>
+            </source>
+            <output>.</output>
+        </guide>
     </version>
 
     <template name="vendor/fast-forward/phpdoc-bootstrap-template" />
@@ -66,6 +72,8 @@ Or with a config file:
 vendor/bin/phpdoc --config phpdoc.xml
 ```
 
+With this setup, the guide `index` document is rendered as the root `index.html`.
+
 ## Requirements
 
 - PHP 8.3+
diff --git a/index.html.twig b/index.html.twig
index c16334d..5f8ede8 100644
--- a/index.html.twig
+++ b/index.html.twig
@@ -1,122 +1,28 @@
 {% extends 'base.html.twig' %}
 
-{% set guideHomeUrl = null %}
-{% set guideFallbackUrl = null %}
-
-{% for version in project.versions %}
-    {% if guideHomeUrl is null %}
-        {% for documentation in version.documentationSets %}
-            {% if guideHomeUrl is null %}
-                {% for guide in documentation.documents|default([]) %}
-                    {% set guideUrl = guide.file ~ '.html' %}
-
-                    {% if documentation.outputLocation != '' and documentation.outputLocation != '.' %}
-                        {% set guideUrl = documentation.outputLocation ~ '/' ~ guideUrl %}
-                    {% endif %}
-
-                    {% if guideFallbackUrl is null and guideUrl %}
-                        {% set guideFallbackUrl = guideUrl %}
-                    {% endif %}
-
-                    {% if guideHomeUrl is null and guideUrl and (guide.file == 'index' or guide.file ends with '/index') %}
-                        {% set guideHomeUrl = guideUrl %}
-                    {% endif %}
-                {% endfor %}
-            {% endif %}
-        {% endfor %}
-    {% endif %}
-{% endfor %}
-
-{% if guideHomeUrl is null %}
-    {% set guideHomeUrl = guideFallbackUrl %}
-{% endif %}
-
 {% block content %}
-    {% if guideHomeUrl %}
-        <div
-            data-guide-home
-            data-guide-url="{{ guideHomeUrl }}"
-            aria-live="polite"
-        >
-            <section class="jumbotron jumbotron-fluid bg-white p-0">
-                <div class="container">
-                    <h1 class="display-3">Documentation</h1>
-                    <p class="lead">Loading the guide home for <strong>{{ project.name }}</strong>.</p>
-                    <hr class="my-4">
-                </div>
-            </section>
+    <section class="jumbotron jumbotron-fluid bg-white p-0">
+        <div class="container">
+            <h1 class="display-3">Documentation</h1>
+            <p class="lead">Welcome to the <strong>{{ project.name }}</strong> API documentation.</p>
+            <hr class="my-4">
         </div>
-
-        <noscript>
-            <meta http-equiv="refresh" content="0;url={{ guideHomeUrl }}">
-        </noscript>
-
-        <script>
-            (function () {
-                const container = document.querySelector('[data-guide-home]');
-
-                if (!container) {
-                    return;
-                }
-
-                const guideUrl = container.getAttribute('data-guide-url');
-
-                if (!guideUrl) {
-                    return;
-                }
-
-                fetch(guideUrl)
-                    .then(function (response) {
-                        if (!response.ok) {
-                            throw new Error('Failed to load guide home');
-                        }
-
-                        return response.text();
-                    })
-                    .then(function (html) {
-                        const parser = new DOMParser();
-                        const documentHtml = parser.parseFromString(html, 'text/html');
-                        const guideContent = documentHtml.querySelector('#content .bg-body.rounded-4');
-
-                        if (!guideContent) {
-                            throw new Error('Guide content container not found');
-                        }
-
-                        container.innerHTML = guideContent.innerHTML;
-
-                        if (documentHtml.title) {
-                            document.title = documentHtml.title;
-                        }
-                    })
-                    .catch(function () {
-                        // Keep the fallback CTA visible when inline loading fails.
-                    });
-            }());
-        </script>
-    {% else %}
-        <section class="jumbotron jumbotron-fluid bg-white p-0">
-            <div class="container">
-                <h1 class="display-3">Documentation</h1>
-                <p class="lead">Welcome to the <strong>{{ project.name }}</strong> API documentation.</p>
-                <hr class="my-4">
-            </div>
-        </section>
-
-        <section>
-            {% set node = project.namespace %}
-
-            {{
-            include(
-                'components/table-of-contents.html.twig',
-                {
-                    'node': project.namespace,
-                    'namespaces': usesNamespaces or not usesPackages ? node.children : [],
-                    'packages': usesPackages ? project.package.children : []
-                }
-            )
-            }}
-            {{ include('components/constants.html.twig', {'node': project.namespace}) }}
-            {{ include('components/functions.html.twig', {'node': project.namespace}) }}
-        </section>
-    {% endif %}
+    </section>
+
+    <section>
+        {% set node = project.namespace %}
+
+        {{
+        include(
+            'components/table-of-contents.html.twig',
+            {
+                'node': project.namespace,
+                'namespaces': usesNamespaces or not usesPackages ? node.children : [],
+                'packages': usesPackages ? project.package.children : []
+            }
+        )
+        }}
+        {{ include('components/constants.html.twig', {'node': project.namespace}) }}
+        {{ include('components/functions.html.twig', {'node': project.namespace}) }}
+    </section>
 {% endblock %}
diff --git a/layout.html.twig b/layout.html.twig
index fceb201..7f91eb7 100644
--- a/layout.html.twig
+++ b/layout.html.twig
@@ -20,7 +20,7 @@
 
         <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.9.0/styles/default.min.css">
 
-        <link rel="stylesheet" href="{{ template_path }}css/base.css">
+        <link rel="stylesheet" href="{{ path('css/base.css') }}">
     {% endblock %}
 </head>
 <body>
@@ -84,9 +84,9 @@
 
         <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.9.0/highlight.min.js"></script>
 
-        <script src="js/template.js"></script>
-        <script src="js/search.js"></script>
-        <script defer src="js/searchIndex.js"></script>
+        <script src="{{ path('js/template.js') }}"></script>
+        <script src="{{ path('js/search.js') }}"></script>
+        <script defer src="{{ path('js/searchIndex.js') }}"></script>
     {% endblock %}
 </body>
 </html>
diff --git a/template.xml b/template.xml
index 749aede..51dcec7 100644
--- a/template.xml
+++ b/template.xml
@@ -5,7 +5,6 @@
   <email>github@mentordosnerds.com</email>
   <version>1.0.0</version>
   <transformations>
-    <transformation writer="twig" source="index.html.twig" artifact="index.html"/>
     <transformation writer="twig" query="files" source="file.html.twig" />
     <transformation writer="sourcecode" query="files" source="source/file.source.txt.twig" artifact="files/{{path}}.txt" />
     <transformation writer="twig" query="indexes.namespaces" source="namespace.html.twig" />

From 38a9bf05fed26ff62fc62b479c605228e1a6827f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Felipe=20Say=C3=A3o=20Lobato=20Abreu?=
 <github@mentordosnerds.com>
Date: Sun, 19 Apr 2026 19:21:32 -0300
Subject: [PATCH 6/8] Remove base href dependency from local assets

---
 components/sidebar.html.twig | 12 ++++++------
 graphs/class.html.twig       |  5 ++---
 js/searchIndex.js.twig       |  1 -
 layout.html.twig             |  1 -
 4 files changed, 8 insertions(+), 11 deletions(-)

diff --git a/components/sidebar.html.twig b/components/sidebar.html.twig
index 4da80e5..79e326c 100644
--- a/components/sidebar.html.twig
+++ b/components/sidebar.html.twig
@@ -26,26 +26,26 @@
             <ul class="nav nav-pills flex-column">
                 {% if project.settings.custom['graphs.enabled'] %}
                     <li class="nav-item">
-                        <a class="nav-link link-body-emphasis d-flex align-items-center gap-2" href="graphs/classes.html">
+                        <a class="nav-link link-body-emphasis d-flex align-items-center gap-2" href="{{ path('graphs/classes.html') }}">
                             <i class="fas fa-project-diagram text-primary"></i>
                             <span>Class Diagram</span>
                         </a>
                     </li>
                 {% endif %}
                 <li class="nav-item">
-                    <a class="nav-link link-body-emphasis d-flex align-items-center gap-2" href="reports/deprecated.html">
+                    <a class="nav-link link-body-emphasis d-flex align-items-center gap-2" href="{{ path('reports/deprecated.html') }}">
                         <i class="fas fa-exclamation-triangle text-warning"></i>
                         <span>Deprecated</span>
                     </a>
                 </li>
                 <li class="nav-item">
-                    <a class="nav-link link-body-emphasis d-flex align-items-center gap-2" href="reports/errors.html">
+                    <a class="nav-link link-body-emphasis d-flex align-items-center gap-2" href="{{ path('reports/errors.html') }}">
                         <i class="fas fa-bug text-danger"></i>
                         <span>Errors</span>
                     </a>
                 </li>
                 <li class="nav-item">
-                    <a class="nav-link link-body-emphasis d-flex align-items-center gap-2" href="reports/markers.html">
+                    <a class="nav-link link-body-emphasis d-flex align-items-center gap-2" href="{{ path('reports/markers.html') }}">
                         <i class="fas fa-bookmark text-info"></i>
                         <span>Markers</span>
                     </a>
@@ -61,7 +61,7 @@
 
             <ul class="nav nav-pills flex-column">
                 <li class="nav-item">
-                    <a class="nav-link link-body-emphasis d-flex align-items-center gap-2" href="indices/files.html">
+                    <a class="nav-link link-body-emphasis d-flex align-items-center gap-2" href="{{ path('indices/files.html') }}">
                         <i class="fas fa-file-code text-secondary"></i>
                         <span>Files</span>
                     </a>
@@ -69,4 +69,4 @@
             </ul>
         </li>
     </ul>
-</nav>
\ No newline at end of file
+</nav>
diff --git a/graphs/class.html.twig b/graphs/class.html.twig
index 0385623..c866fd2 100644
--- a/graphs/class.html.twig
+++ b/graphs/class.html.twig
@@ -1,5 +1,4 @@
 {% extends 'base.html.twig' %}
-{% set baseUrl = renderBaseUrlHeader() %}
 
 {% block stylesheets %}
 {% endblock %}
@@ -40,7 +39,7 @@
                 id="graph-container"
             >
                 <img
-                    src="graphs/classes.svg"
+                    src="{{ path('graphs/classes.svg') }}"
                     id="scene"
                     alt="Class diagram"
                     class="img-fluid d-block mx-auto"
@@ -88,4 +87,4 @@
             });
         })();
     </script>
-{% endblock %}
\ No newline at end of file
+{% endblock %}
diff --git a/js/searchIndex.js.twig b/js/searchIndex.js.twig
index 2ae3a4a..fb84c39 100644
--- a/js/searchIndex.js.twig
+++ b/js/searchIndex.js.twig
@@ -1,4 +1,3 @@
-{% set baseUrl = renderBaseUrlHeader() %}
 Search.appendIndex(
     [
         {% for element in project.indexes.elements %}
diff --git a/layout.html.twig b/layout.html.twig
index 7f91eb7..d028ec6 100644
--- a/layout.html.twig
+++ b/layout.html.twig
@@ -7,7 +7,6 @@
     {% endblock %}
 
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    {{ renderBaseUrlHeader() }}
 
     {% block stylesheets %}
         <!-- Bootstrap -->

From 3bfa3ae4655829d1fac0690510407a06ff9893c1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Felipe=20Say=C3=A3o=20Lobato=20Abreu?=
 <github@mentordosnerds.com>
Date: Sun, 19 Apr 2026 19:26:00 -0300
Subject: [PATCH 7/8] Fix search result URLs on local homepage

---
 js/search.js.twig | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/js/search.js.twig b/js/search.js.twig
index f50fc5a..31b5b4f 100644
--- a/js/search.js.twig
+++ b/js/search.js.twig
@@ -65,7 +65,7 @@ var Search = (function () {
         var summary = result.summary ? escapeHtml(result.summary) : '';
         var fqsen = result.fqsen ? escapeHtml(result.fqsen) : '';
         var name = escapeHtml(result.name || 'Untitled');
-        var url = document.baseURI + result.url;
+        var url = result.url;
 
         return '' +
             '<li class="list-group-item px-3 py-3">' +
@@ -208,4 +208,4 @@ window.addEventListener('DOMContentLoaded', function () {
 
 window.addEventListener('load', function () {
     Search.init();
-});
\ No newline at end of file
+});

From d188ce55442afa73d017b1c024932f577aec3931 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Felipe=20Say=C3=A3o=20Lobato=20Abreu?=
 <github@mentordosnerds.com>
Date: Sun, 19 Apr 2026 19:28:48 -0300
Subject: [PATCH 8/8] Compute base href from current destination

---
 layout.html.twig | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/layout.html.twig b/layout.html.twig
index d028ec6..6a653c8 100644
--- a/layout.html.twig
+++ b/layout.html.twig
@@ -6,7 +6,31 @@
         <title>{% block title %}{{ project.name }}{% endblock %}</title>
     {% endblock %}
 
+    {% set currentDestination = destinationPath|default('') %}
+    {% if (currentDestination is empty) and env is not null %}
+        {% set currentDestination = env.currentFileDestination|default('') %}
+    {% endif %}
+
+    {% set normalizedDestination = currentDestination
+        |split('#')|first
+        |split('?')|first
+        |replace({'./': '', '.\\': ''})
+        |trim('/')
+    %}
+
+    {% set destinationDepth = normalizedDestination ? (normalizedDestination|split('/')|length - 1) : 0 %}
+    {% set baseHref = './' %}
+
+    {% if destinationDepth > 0 %}
+        {% set baseSegments = [] %}
+        {% for i in 1..destinationDepth %}
+            {% set baseSegments = baseSegments|merge(['../']) %}
+        {% endfor %}
+        {% set baseHref = baseSegments|join('') %}
+    {% endif %}
+
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <base href="{{ baseHref }}">
 
     {% block stylesheets %}
         <!-- Bootstrap -->