From c849003aa5a672b8fbf591e704e5dbcf0347c15d Mon Sep 17 00:00:00 2001
From: Mark Dumay <61946753+markdumay@users.noreply.github.com>
Date: Sun, 12 Jul 2026 08:37:02 +0200
Subject: [PATCH 1/2] feat(padding): compose padding via PaddingClasses helper

Swap the section-level padding interpolations (page shells, headers,
footer, navbar) to mod-utils' PaddingClasses partial, enabling the
opt-in [*.padding.mobile] config. Output is byte-identical when no
mobile padding is configured.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
---
 layouts/_partials/assets/navbar.html | 2 +-
 layouts/_partials/footer/social.html | 2 +-
 layouts/docs/all.html                | 2 +-
 layouts/docs/header.html             | 2 +-
 layouts/form/single.html             | 2 +-
 layouts/header.html                  | 2 +-
 layouts/list.html                    | 4 ++--
 layouts/minimal/header.html          | 2 +-
 layouts/single.html                  | 2 +-
 layouts/tags/list.html               | 2 +-
 10 files changed, 11 insertions(+), 11 deletions(-)

diff --git a/layouts/_partials/assets/navbar.html b/layouts/_partials/assets/navbar.html
index d81daf873..69ccf0aea 100644
--- a/layouts/_partials/assets/navbar.html
+++ b/layouts/_partials/assets/navbar.html
@@ -130,7 +130,7 @@
 {{/* Main code */}}
 <div class="container-fluid {{ if $args.fixed }}fixed-top{{ else if $overlay }}navbar-overlay{{ end }} p-0{{ with $class }} {{ . }}{{ end }}">
     {{- partial "assets/page-alert.html" (dict "page" $page) -}}
-    <nav class="navbar px-{{ $padding.x }} py-{{ $padding.y }} navbar-fs-{{ $fs }} navbar-{{ $args.breakpoint }}-fs
+    <nav class="navbar {{ partial "utilities/PaddingClasses.html" (dict "padding" $padding "axis" "x") }} {{ partial "utilities/PaddingClasses.html" (dict "padding" $padding "axis" "y") }} navbar-fs-{{ $fs }} navbar-{{ $args.breakpoint }}-fs
         {{- if not $overlay }}{{ with $color }} bg-{{ . }}{{ end }}{{ end -}}
         {{ if $args.fixed }} navbar-fixed-top{{ end }} navbar-expand-{{ $args.breakpoint -}}
         {{ if $contrast }} navbar-contrast{{ end }}"
diff --git a/layouts/_partials/footer/social.html b/layouts/_partials/footer/social.html
index e681fba33..f976a50ac 100644
--- a/layouts/_partials/footer/social.html
+++ b/layouts/_partials/footer/social.html
@@ -2,7 +2,7 @@
     {{- $padding := partial "utilities/GetPadding.html" -}}
     {{- $tab := site.Params.main.externalLinks.tab -}}
     <div class="container-fluid bg-primary bg-opacity-{{ .Site.Params.style.themeOpacity | default "25" | safeHTML }}">
-        <div class="container-xxl px-{{ $padding.x }} px-xxl-0">
+        <div class="container-xxl {{ partial "utilities/PaddingClasses.html" (dict "padding" $padding "axis" "x") }} px-xxl-0">
             <div class="row row-cols-2 py-3 align-items-center">
                 <div class="col col-6">
                     <div class="row justify-content-end p-0">
diff --git a/layouts/docs/all.html b/layouts/docs/all.html
index 841273cff..6929af14a 100644
--- a/layouts/docs/all.html
+++ b/layouts/docs/all.html
@@ -15,7 +15,7 @@
     {{- partial "page/sidebar-offcanvas.html" (dict "section" $.Section "raw" $sidebar) -}}
 
     {{/* Render the page content using responsive columns */}}
-    <div class="container-xxl flex-fill py-{{ $padding.y }} px-{{ $padding.x }} px-xxl-0">
+    <div class="container-xxl flex-fill {{ partial "utilities/PaddingClasses.html" (dict "padding" $padding "axis" "y") }} {{ partial "utilities/PaddingClasses.html" (dict "padding" $padding "axis" "x") }} px-xxl-0">
         <div class="row row-cols-1 row-cols-{{ $breakpoint.current }}-2 row-cols-{{ $breakpoint.next }}-3">
             <div class="col col-{{ $breakpoint.next }}-2 d-none d-{{ $breakpoint.next }}-block sidebar-overflow sticky-top p-0">
                 {{ $sidebar | safeHTML }}
diff --git a/layouts/docs/header.html b/layouts/docs/header.html
index 6e08ea6bc..f58b15309 100644
--- a/layouts/docs/header.html
+++ b/layouts/docs/header.html
@@ -27,7 +27,7 @@
 
 {{/* Display description */}}
 {{ with .Description }}
-    <div class="{{ $contentStyle }} py-{{ $padding.y }}">{{ . | $.RenderString | safeHTML }}</div>
+    <div class="{{ $contentStyle }} {{ partial "utilities/PaddingClasses.html" (dict "padding" $padding "axis" "y") }}">{{ . | $.RenderString | safeHTML }}</div>
 {{ end }}
 
 {{/* Display TOC dropdown on smaller screens */}}
diff --git a/layouts/form/single.html b/layouts/form/single.html
index f5e1f1cc5..670c07407 100644
--- a/layouts/form/single.html
+++ b/layouts/form/single.html
@@ -2,7 +2,7 @@
     {{- $padding := partial "utilities/GetPadding.html" -}}
     {{- $formIcon := partial "utilities/GetThemeIcon.html" (dict "id" "formSubmittedIcon" "default" "fa envelope") -}}
     <section class="container-fluid p-0 section-cover d-flex align-items-center">
-        <div class="container-xxl px-xxl-0 px-{{ $padding.x }} py-0 my-auto h-100">
+        <div class="container-xxl px-xxl-0 {{ partial "utilities/PaddingClasses.html" (dict "padding" $padding "axis" "x") }} py-0 my-auto h-100">
             <div class="text-center col-md-6 mx-auto">
                 <span class="text-body fw-bold">
                     {{ partial "assets/icon.html" (dict "icon" $formIcon "class" "fa-10x") }}
diff --git a/layouts/header.html b/layouts/header.html
index ec947c9a0..b6b7106cb 100644
--- a/layouts/header.html
+++ b/layouts/header.html
@@ -29,7 +29,7 @@
 
 {{/* Display description */}}
 {{ with .Description }}
-    <div class="{{ $contentStyle }} py-{{ $padding.y }}">{{ . | $.RenderString | safeHTML }}</div>
+    <div class="{{ $contentStyle }} {{ partial "utilities/PaddingClasses.html" (dict "padding" $padding "axis" "y") }}">{{ . | $.RenderString | safeHTML }}</div>
 {{ end }}
 
 {{/* Display TOC dropdown on smaller screens */}}
diff --git a/layouts/list.html b/layouts/list.html
index 3c3879050..086f568a9 100644
--- a/layouts/list.html
+++ b/layouts/list.html
@@ -8,7 +8,7 @@
         {{- partial "page/blocks.html" . -}}
     {{ else }}
         {{ with partial "page/articles.html" . }}
-            <div class="container-xxl py-{{ $padding.y }} px-xxl-0 px-{{ $padding.x }} py-0 my-auto h-100">
+            <div class="container-xxl {{ partial "utilities/PaddingClasses.html" (dict "padding" $padding "axis" "y") }} px-xxl-0 {{ partial "utilities/PaddingClasses.html" (dict "padding" $padding "axis" "x") }} py-0 my-auto h-100">
                 {{ . | safeHTML }}
             </div>
         {{ end }}
@@ -16,7 +16,7 @@
 
     <!-- Render the list page content as full width, if any -->
     {{ with $content }}
-        <div class="container-xxl flex-fill py-{{ $padding.y }} px-{{ $padding.x }} px-xxl-0">
+        <div class="container-xxl flex-fill {{ partial "utilities/PaddingClasses.html" (dict "padding" $padding "axis" "y") }} {{ partial "utilities/PaddingClasses.html" (dict "padding" $padding "axis" "x") }} px-xxl-0">
             {{ . }}
         </div>
     {{ end }}
diff --git a/layouts/minimal/header.html b/layouts/minimal/header.html
index 38fea0736..9d9944533 100644
--- a/layouts/minimal/header.html
+++ b/layouts/minimal/header.html
@@ -14,5 +14,5 @@
 
 {{/* Display description */}}
 {{ with .Description }}
-    <div class="{{ $contentStyle }} py-{{ $padding.y }}">{{ . | $.RenderString | safeHTML }}</div>
+    <div class="{{ $contentStyle }} {{ partial "utilities/PaddingClasses.html" (dict "padding" $padding "axis" "y") }}">{{ . | $.RenderString | safeHTML }}</div>
 {{ end }}
diff --git a/layouts/single.html b/layouts/single.html
index 50eb66613..ea44c9cab 100644
--- a/layouts/single.html
+++ b/layouts/single.html
@@ -13,7 +13,7 @@
     {{/*    Column 3: sharing buttons and TOC navigation or specials (CTA), visible in large viewports */}}
     {{/*              content is folded into main column (handled by page elements) */}}
     {{ if (gt (len .RawContent) 0) }}
-        <div class="container-xxl flex-fill py-{{ $padding.y }} px-{{ $padding.x }} px-xxl-0">
+        <div class="container-xxl flex-fill {{ partial "utilities/PaddingClasses.html" (dict "padding" $padding "axis" "y") }} {{ partial "utilities/PaddingClasses.html" (dict "padding" $padding "axis" "x") }} px-xxl-0">
             <div class="row row-cols-1 row-cols-{{ $breakpoint.current }}-2 row-cols-{{ $breakpoint.next }}-3">
                 <div class="col col-{{ $breakpoint.next }}-2 d-none d-{{ $breakpoint.next }}-block sidebar-overflow sticky-top p-0">
                     {{ $sidebar | safeHTML }}
diff --git a/layouts/tags/list.html b/layouts/tags/list.html
index 518054375..f0744b437 100644
--- a/layouts/tags/list.html
+++ b/layouts/tags/list.html
@@ -5,7 +5,7 @@
     {{- $padding := partial "utilities/GetPadding.html" -}}
     {{- $pageTitle := .Page.Title }}
     {{ if and site.Params.main.titleCase (not .Page.Params.exact) }}{{ $pageTitle = title $pageTitle }}{{ end }}
-        <div class="container-xxl flex-fill py-{{ $padding.y }} px-{{ $padding.x }} px-xxl-0">
+        <div class="container-xxl flex-fill {{ partial "utilities/PaddingClasses.html" (dict "padding" $padding "axis" "y") }} {{ partial "utilities/PaddingClasses.html" (dict "padding" $padding "axis" "x") }} px-xxl-0">
             <div class="row row-cols-1 row-cols-{{ $breakpoint.current }}-2 row-cols-{{ $breakpoint.next }}-3">
                 <div class="col col-{{ $breakpoint.next }}-2 d-none d-{{ $breakpoint.next }}-block">
                 </div>

From 8a13bcae1b0202c1c1ded39a5a9d9c8a4aa29383 Mon Sep 17 00:00:00 2001
From: Mark Dumay <61946753+markdumay@users.noreply.github.com>
Date: Sun, 12 Jul 2026 10:43:13 +0200
Subject: [PATCH 2/2] build(deps): bump mod-utils to v5.24.0

Pins the release that ships the PaddingClasses partial consumed by
this branch.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
---
 go.mod | 2 +-
 go.sum | 2 ++
 2 files changed, 3 insertions(+), 1 deletion(-)

diff --git a/go.mod b/go.mod
index 6498bab36..accfcefae 100644
--- a/go.mod
+++ b/go.mod
@@ -15,7 +15,7 @@ require (
 	github.com/gethinode/mod-lottie/v2 v2.1.2 // indirect
 	github.com/gethinode/mod-mermaid/v4 v4.10.1 // indirect
 	github.com/gethinode/mod-simple-datatables/v3 v3.1.2 // indirect
-	github.com/gethinode/mod-utils/v5 v5.23.4 // indirect
+	github.com/gethinode/mod-utils/v5 v5.24.0 // indirect
 	github.com/nextapps-de/flexsearch v0.0.0-20260529083235-f7ed963096a0 // indirect
 	github.com/twbs/bootstrap v5.3.8+incompatible // indirect
 )
diff --git a/go.sum b/go.sum
index ab64f16e1..643b49a54 100644
--- a/go.sum
+++ b/go.sum
@@ -156,6 +156,8 @@ github.com/gethinode/mod-utils/v5 v5.23.3 h1:ifcDyTYpmM6HBzc6SbpG+hJMSCfGTZKf/pl
 github.com/gethinode/mod-utils/v5 v5.23.3/go.mod h1:PwQN4oOjA6k/vet11JueJ9asZMgL0DBa3jyS9tPkBWU=
 github.com/gethinode/mod-utils/v5 v5.23.4 h1:/lcKi1MJ2srGfNhCPtdnTRpQgdh2FNBRUAS7Ysz1W34=
 github.com/gethinode/mod-utils/v5 v5.23.4/go.mod h1:PwQN4oOjA6k/vet11JueJ9asZMgL0DBa3jyS9tPkBWU=
+github.com/gethinode/mod-utils/v5 v5.24.0 h1:dqqRn6qaEehEHZjo74pxbzvVdCn++XuZk18jxeUvwwA=
+github.com/gethinode/mod-utils/v5 v5.24.0/go.mod h1:PwQN4oOjA6k/vet11JueJ9asZMgL0DBa3jyS9tPkBWU=
 github.com/nextapps-de/flexsearch v0.0.0-20250907103239-defb38b083f0 h1:55phPhe6fDjfjG0jX4+br3nLORKgjgx8abZUdI0YJRA=
 github.com/nextapps-de/flexsearch v0.0.0-20250907103239-defb38b083f0/go.mod h1:5GdMfPAXzbA2gXBqTjC6l27kioSYzHlqDMh0+wyx7sU=
 github.com/nextapps-de/flexsearch v0.0.0-20260529083235-f7ed963096a0 h1:QDKcU3q39lFGzdVwM6kgCGnW3ibbMfYIi0Rwl62iJpo=