diff --git a/assets/custom.scss b/assets/custom.scss
new file mode 100644
index 00000000..fa48021a
--- /dev/null
+++ b/assets/custom.scss
@@ -0,0 +1,25 @@
+/*
+  Hugo Book theme custom overrides.
+  This file is loaded by themes/book/assets/book.scss via @import "custom".
+  Keep landing icon dimensions constrained so homepage SVG icons do not inherit oversized defaults.
+*/
+
+.feature-icon,
+.doctype-icon,
+.usecase-icon {
+  width: 2.5rem;
+  height: 2.5rem;
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+}
+
+.feature-icon svg,
+.doctype-icon svg,
+.usecase-icon svg {
+  width: 1.5rem;
+  height: 1.5rem;
+  max-width: 1.5rem;
+  max-height: 1.5rem;
+  display: block;
+}
diff --git a/content.en/_index.md b/content.en/_index.md
index 99e37b52..79c547a3 100644
--- a/content.en/_index.md
+++ b/content.en/_index.md
@@ -59,7 +59,7 @@ A Frappe/ERPNext extension for **centralized Party Master identity**, role-aware
 [{{< badge style="info" title="Version" value="1.0" >}}](https://github.com/Sendipad/uph/releases)
 [{{< badge style="default" title="License" value="MIT" >}}](https://github.com/Sendipad/uph/blob/main/LICENSE)
 
-{{< button href="/uph/en/docs/" >}}Read Technical Docs{{< /button >}}
+{{< button href="/docs/" >}}Read Technical Docs{{< /button >}}
 
   <section>
     <h2>Architecture & Modules</h2>
@@ -120,7 +120,7 @@ Then configure **Party Master Settings** to map target doctypes and party types.
 
 ## API Reference
 
-See [API Reference](/uph/en/docs/api/) for whitelisted/search/report function entry points extracted from current implementation.
+See [API Reference]({{< relref "/docs/api/_index.md" >}}) for whitelisted/search/report function entry points extracted from current implementation.
 
 ---
 
diff --git a/content.en/docs/_index.md b/content.en/docs/_index.md
index e75a74df..28282430 100644
--- a/content.en/docs/_index.md
+++ b/content.en/docs/_index.md
@@ -18,8 +18,8 @@ This documentation is generated from the **current branch implementation**. Beca
 
 ## Sections
 
-- [Introduction](/uph/en/docs/introduction/)
-- [Architecture](/uph/en/docs/architecture/)
-- [Modules](/uph/en/docs/modules/)
-- [API Reference](/uph/en/docs/api/)
-- [Operations](/uph/en/docs/operations/)
+- [Introduction]({{< relref "/docs/introduction/_index.md" >}})
+- [Architecture]({{< relref "/docs/architecture/_index.md" >}})
+- [Modules]({{< relref "/docs/modules/_index.md" >}})
+- [API Reference]({{< relref "/docs/api/_index.md" >}})
+- [Operations]({{< relref "/docs/operations/_index.md" >}})
diff --git a/content.en/docs/api/_index.md b/content.en/docs/api/_index.md
index ec63b398..00c1312c 100644
--- a/content.en/docs/api/_index.md
+++ b/content.en/docs/api/_index.md
@@ -8,4 +8,4 @@ bookCollapseSection: true
 Technical details for all whitelisted API endpoints in the UPH application.
 
 
-See also: [Verification Status (Current Branch vs Legacy API Docs)](/uph/en/docs/api/verification-status/).
+See also: [Verification Status (Current Branch vs Legacy API Docs)]({{< relref "/docs/api/verification-status.md" >}}).
diff --git a/layouts/_partials/docs/menu.html b/layouts/_partials/docs/menu.html
index 0e32c850..b19c121f 100644
--- a/layouts/_partials/docs/menu.html
+++ b/layouts/_partials/docs/menu.html
@@ -19,8 +19,8 @@
   <div class="custom-links-wrapper">
     <ul class="custom-links">
       <li class="static-text">{{ i18n "learnSectionLabel" }}</li>
-      <li><a href="/uph/{{ .Lang }}/posts/">Learn by Use Cases</a></li>
-      <li><a href="/uph/{{ .Lang }}/showcases/">Showcases</a></li>
+      <li><a href="{{ "/posts/" | relLangURL }}">Learn by Use Cases</a></li>
+      <li><a href="{{ "/showcases/" | relLangURL }}">Showcases</a></li>
       <li><a href="https://github.com/Sendipad/uph/" target="_blank">GitHub</a></li>
     </ul>
   </div>
diff --git a/layouts/shortcodes/button.html b/layouts/shortcodes/button.html
index 08ba94b5..9d0b85b2 100644
--- a/layouts/shortcodes/button.html
+++ b/layouts/shortcodes/button.html
@@ -1,4 +1,7 @@
 {{- $href := .Get "href" -}}
+{{- if and $href (not ((urls.Parse $href).IsAbs)) (hasPrefix $href "/") -}}
+  {{- $href = $href | relLangURL -}}
+{{- end -}}
 {{- $isRemote := (urls.Parse $href).IsAbs -}}
 {{- $class := "book-btn" -}}
 {{- $target := "" -}}