ultimate-jekyll-manager 1.9.8 → 1.9.10

package/CLAUDE.md

@@ -193,6 +193,7 @@ All `npm install` calls in CLI commands (`npx mgr i`, `npx mgr setup`) route thr
 - **No backwards compatibility** unless explicitly requested.
 - **Don't add `?.` paranoia.** Framework internals (`manager.config`, `manager.webManager`) deref directly. `?.` belongs only on user-supplied config sub-fields, optional return values from regex matches, caught exceptions, and pre-init state.
 - **Use `process.cwd()` (not hardcoded paths) for consumer-project resolution** in gulp tasks + commands. UJM runs inside the consumer's working directory.
+- **All `<img src>` tags MUST have a cachebreaker** — append `?cb={{ site.uj.cache_breaker }}` to image `src` attributes in includes and layouts. This applies to logos, brandmarks, rating images, and any other image rendered via Liquid variables. External third-party URLs (YouTube embeds, analytics pixels, placeholder services) are exempt. `data-lazy="@src"` is handled at the JS layer, not here. See [docs/common-mistakes.md](docs/common-mistakes.md).
 
 ## Doc-update parity
 

package/dist/defaults/dist/_includes/core/foot.html

@@ -107,7 +107,7 @@
 </script>
 
 <!-- JS Bundle -->
-<script type="text/javascript" src="{{ site.url }}/assets/js/main.bundle.js?cb={{ site.uj.cache_breaker }}" async></script>
+<script type="text/javascript" src="{{ site.url | append: '/assets/js/main.bundle.js' | uj_cachebreak }}" async></script>
 
 <!-- Script to quickly handle nav user state -->
 <script type="text/javascript">

package/dist/defaults/dist/_includes/core/head.html

@@ -172,13 +172,13 @@
 <link rel="alternate" href="{{ page.canonical.url }}" hreflang="{{ page-translation-default }}"/>
 
 <!-- Favicon -->
-<link rel="apple-touch-icon" sizes="180x180" href="{{ favicon-path }}/apple-touch-icon.png?cb={{ site.uj.cache_breaker }}"/>
-<link rel="icon" type="image/png" sizes="32x32" href="{{ favicon-path }}/favicon-32x32.png?cb={{ site.uj.cache_breaker }}"/>
-<link rel="icon" type="image/png" sizes="16x16" href="{{ favicon-path }}/favicon-16x16.png?cb={{ site.uj.cache_breaker }}"/>
-<link rel="mask-icon" href="{{ favicon-path }}/safari-pinned-tab.svg?cb={{ site.uj.cache_breaker }}" color="{{ page.resolved.favicon.safari-pinned-tab }}"/>
-<link rel="shortcut icon" type="image/x-icon" href="{{ favicon-path }}/favicon.ico?cb={{ site.uj.cache_breaker }}"/>
+<link rel="apple-touch-icon" sizes="180x180" href="{{ favicon-path | append: '/apple-touch-icon.png' | uj_cachebreak }}"/>
+<link rel="icon" type="image/png" sizes="32x32" href="{{ favicon-path | append: '/favicon-32x32.png' | uj_cachebreak }}"/>
+<link rel="icon" type="image/png" sizes="16x16" href="{{ favicon-path | append: '/favicon-16x16.png' | uj_cachebreak }}"/>
+<link rel="mask-icon" href="{{ favicon-path | append: '/safari-pinned-tab.svg' | uj_cachebreak }}" color="{{ page.resolved.favicon.safari-pinned-tab }}"/>
+<link rel="shortcut icon" type="image/x-icon" href="{{ favicon-path | append: '/favicon.ico' | uj_cachebreak }}"/>
 <meta name="msapplication-TileColor" content="{{ page.resolved.favicon.msapp-tile-color }}"/>
-<meta name="msapplication-config" content="{{ favicon-path }}/browserconfig.xml?cb={{ site.uj.cache_breaker }}"/>
+<meta name="msapplication-config" content="{{ favicon-path | append: '/browserconfig.xml' | uj_cachebreak }}"/>
 <meta name="theme-color" content="{{ page.resolved.favicon.theme-color }}"/>
 
 <!-- Browser Support -->
@@ -193,17 +193,17 @@
 <!-- Note: media="print" onload="this.media='all'" does NOT improve performance -->
 <!-- Fetch specific bundle if it's requested -->
 {% iftruthy page.resolved.theme.css.bundle %}
-  <link rel="stylesheet" type="text/css" href="{{ site.url }}/assets/css/{{ page.resolved.theme.css.bundle }}.bundle.css?cb={{ site.uj.cache_breaker }}"/>
+  <link rel="stylesheet" type="text/css" href="{{ site.url | append: '/assets/css/' | append: page.resolved.theme.css.bundle | append: '.bundle.css' | uj_cachebreak }}"/>
 {% endiftruthy %}
 
 <!-- Otherwise, fetch main bundle -->
 {% iffalsy page.resolved.theme.css.bundle %}
-  <link rel="stylesheet" type="text/css" href="{{ site.url }}/assets/css/main.bundle.css?cb={{ site.uj.cache_breaker }}"/>
+  <link rel="stylesheet" type="text/css" href="{{ site.url | append: '/assets/css/main.bundle.css' | uj_cachebreak }}"/>
 {% endiffalsy %}
 
 <!-- Then, fetch any page specific bundles -->
 {% iffile page-css-path %}
-  <link rel="stylesheet" type="text/css" href="{{ site.url }}{{ page-css-path }}?cb={{ site.uj.cache_breaker }}"/>
+  <link rel="stylesheet" type="text/css" href="{{ site.url | append: page-css-path | uj_cachebreak }}"/>
 
   <!-- Dev log -->
   {% if jekyll.environment == "development" %}
@@ -217,7 +217,7 @@
      Only present when the theme ships page CSS for this path — otherwise nothing loads
      and the theme's component/general styles handle the page. No fallback needed. -->
 {% iffile page-css-theme-path %}
-  <link rel="stylesheet" type="text/css" href="{{ site.url }}{{ page-css-theme-path }}?cb={{ site.uj.cache_breaker }}"/>
+  <link rel="stylesheet" type="text/css" href="{{ site.url | append: page-css-theme-path | uj_cachebreak }}"/>
 
   <!-- Dev log -->
   {% if jekyll.environment == "development" %}

package/dist/defaults/dist/_includes/modules/adunits/adsense.html

@@ -47,7 +47,7 @@
 <!-- Inject Ad -->
 {%- iftruthy page-adsense-client -%}
   <div data-lazy='@script {
-    "src": "{{ site.url }}/assets/js/modules/vert.bundle.js?cb={{ site.uj.cache_breaker }}",
+    "src": "{{ site.url | append: '/assets/js/modules/vert.bundle.js' | uj_cachebreak }}",
     "attributes": {
       "data-ad-client": "{{ page-adsense-client }}",
       "data-ad-type": "{{ type }}",

package/dist/defaults/dist/_includes/modules/adunits/promo-server.html

@@ -6,7 +6,7 @@
 {% assign vert-style = include.style | default: "" %}
 
 <div data-lazy='@script {
-  "src": "{{ site.url }}/assets/js/modules/vert.bundle.js?cb={{ site.uj.cache_breaker }}",
+  "src": "{{ site.url | append: '/assets/js/modules/vert.bundle.js' | uj_cachebreak }}",
   "attributes": {
     "data-ad-type": "custom",
     "data-ad-size": "{{ vert-size }}",

package/dist/defaults/dist/_includes/themes/classy/backend/sections/sidebar.html

@@ -10,7 +10,7 @@
     <a href="{{ logo_href }}" class="d-flex align-items-center text-decoration-none text-body">
       {% iftruthy logo_src %}
         <div class="avatar avatar-md me-2 {{ logo_class }}">
-          <img src="{{ logo_src }}" alt="{{ logo_text }} Logo"/>
+          <img src="{{ logo_src | uj_cachebreak }}" alt="{{ logo_text }} Logo"/>
         </div>
       {% endiftruthy %}
       {% iftruthy logo_text %}
@@ -186,7 +186,7 @@
     <h5 class="offcanvas-title d-flex align-items-center" id="mobileSidebarLabel">
       {% iftruthy logo_src %}
         <div class="avatar avatar-md me-2">
-          <img src="{{ logo_src }}" alt="{{ logo_text }} Logo"/>
+          <img src="{{ logo_src | uj_cachebreak }}" alt="{{ logo_text }} Logo"/>
         </div>
       {% endiftruthy %}
       {% iftruthy logo_text %}

package/dist/defaults/dist/_includes/themes/classy/frontend/sections/nav.html

@@ -9,10 +9,10 @@
     <a class="navbar-brand d-inline-flex align-items-center py-0" href="{{ logo_href }}">
       {% iftruthy logo_src %}
         {% if data.logo.type == 'wordmark' %}
-          <img src="{{ logo_src }}" alt="{{ logo_text }} Logo" class="{{ logo_class }}" style="height: 2rem; width: auto;"/>
+          <img src="{{ logo_src | uj_cachebreak }}" alt="{{ logo_text }} Logo" class="{{ logo_class }}" style="height: 2rem; width: auto;"/>
         {% else %}
           <div class="avatar avatar-md me-2 {{ logo_class }}">
-            <img src="{{ logo_src }}" alt="{{ logo_text }} Logo"/>
+            <img src="{{ logo_src | uj_cachebreak }}" alt="{{ logo_text }} Logo"/>
           </div>
         {% endif %}
       {% endiftruthy %}

package/dist/defaults/dist/_layouts/modules/utilities/redirect.html

@@ -20,7 +20,7 @@ meta:
       <div class="text-center mb-3">
         <a href="{{ site.url }}">
           <div class="avatar avatar-xl">
-            <img src="{{ site.brand.images.brandmark }}?cb={{ site.uj.cache_breaker }}" alt="{{ site.brand.name }}"/>
+            <img src="{{ site.brand.images.brandmark | uj_cachebreak }}" alt="{{ site.brand.name }}"/>
           </div>
         </a>
       </div>
@@ -69,4 +69,4 @@ meta:
 </div>
 
 <!-- Load redirect module script -->
-<script type="text/javascript" src="{{ site.url }}/assets/js/modules/redirect.bundle.js?cb={{ site.uj.cache_breaker }}" async></script>
+<script type="text/javascript" src="{{ site.url | append: '/assets/js/modules/redirect.bundle.js' | uj_cachebreak }}" async></script>

package/dist/defaults/dist/_layouts/themes/classy/frontend/pages/account/index.html

@@ -151,7 +151,7 @@ badges:
       <!-- Left: Brand -->
       <a href="/" class="d-flex align-items-center text-decoration-none text-body">
         <span class="avatar avatar-md me-3 filter-adaptive">
-          <img src="{{ site.brand.images.brandmark }}?cb={{ site.uj.cache_breaker }}" alt="{{ site.brand.name }}"/>
+          <img src="{{ site.brand.images.brandmark | uj_cachebreak }}" alt="{{ site.brand.name }}"/>
         </span>
         <h1 class="h5 mb-0 fw-semibold">{{ site.brand.name }} Account</h1>
       </a>
@@ -790,7 +790,7 @@ badges:
                         {% uj_icon method.icon, "fa-3xl" %}
                       {% endiftruthy %}
                       {% iftruthy method.logo %}
-                        <img src="{{ method.logo }}?cb={{ site.uj.cache_breaker }}" class="object-fit-contain" alt="{{ method.name }} Logo"/>
+                        <img src="{{ method.logo | uj_cachebreak }}" class="object-fit-contain" alt="{{ method.name }} Logo"/>
                       {% endiftruthy %}
                     </div>
                     <div>
@@ -958,7 +958,7 @@ badges:
                   <div class="d-flex flex-column flex-sm-row align-items-stretch align-items-sm-center justify-content-between gap-3">
                     <div class="d-flex align-items-center">
                       <div class="d-flex align-items-center justify-content-center me-3 flex-shrink-0 fa fa-3xl">
-                        <img src="{{ connection.logo }}?cb={{ site.uj.cache_breaker }}" class="object-fit-contain" alt="{{ connection.name }} Logo"/>
+                        <img src="{{ connection.logo | uj_cachebreak }}" class="object-fit-contain" alt="{{ connection.name }} Logo"/>
                       </div>
                       <div>
                         <h6 class="mb-0">{{ connection.name }}</h6>

package/dist/defaults/dist/_layouts/themes/classy/frontend/pages/app.html

@@ -15,7 +15,7 @@ app:
       <!-- Logo -->
       <div class="text-center mb-3">
         <div class="avatar avatar-xl">
-          <img src="{{ site.brand.images.brandmark }}?cb={{ site.uj.cache_breaker }}" alt="{{ site.brand.name }} Logo"/>
+          <img src="{{ site.brand.images.brandmark | uj_cachebreak }}" alt="{{ site.brand.name }} Logo"/>
         </div>
       </div>
 

package/dist/defaults/dist/_layouts/themes/classy/frontend/pages/auth/oauth2.html

@@ -11,7 +11,7 @@ layout: themes/[ site.theme.id ]/frontend/core/cover
       <!-- Logo -->
       <div class="text-center mb-3">
         <div class="avatar avatar-xl">
-          <img src="{{ site.brand.images.brandmark }}?cb={{ site.uj.cache_breaker }}" class="filter-adaptive" alt="{{ site.brand.name }} Logo"/>
+          <img src="{{ site.brand.images.brandmark | uj_cachebreak }}" class="filter-adaptive" alt="{{ site.brand.name }} Logo"/>
         </div>
       </div>
 

package/dist/defaults/dist/_layouts/themes/classy/frontend/pages/auth/reset.html

@@ -11,7 +11,7 @@ layout: themes/[ site.theme.id ]/frontend/core/cover
       <!-- Logo -->
       <div class="text-center mb-3">
         <div class="avatar avatar-xl">
-          <img src="{{ site.brand.images.brandmark }}?cb={{ site.uj.cache_breaker }}" class="filter-adaptive" alt="{{ site.brand.name }} Logo"/>
+          <img src="{{ site.brand.images.brandmark | uj_cachebreak }}" class="filter-adaptive" alt="{{ site.brand.name }} Logo"/>
         </div>
       </div>
 

package/dist/defaults/dist/_layouts/themes/classy/frontend/pages/auth/signin.html

@@ -26,7 +26,7 @@ social_signin:
       <!-- Logo -->
       <div class="text-center mb-3">
         <div class="avatar avatar-xl">
-          <img src="{{ site.brand.images.brandmark }}?cb={{ site.uj.cache_breaker }}" class="filter-adaptive" alt="{{ site.brand.name }} Logo"/>
+          <img src="{{ site.brand.images.brandmark | uj_cachebreak }}" class="filter-adaptive" alt="{{ site.brand.name }} Logo"/>
         </div>
       </div>
 
@@ -50,7 +50,7 @@ social_signin:
             <button type="submit" class="btn btn-adaptive _btn-lg w-100 mb-3 d-flex align-items-center justify-content-center" data-provider="{{ provider.id }}">
               {{ initializing_spinner }}
               <span class="avatar avatar-xs me-2">
-                <img src="{{ provider.logo }}?cb={{ site.uj.cache_breaker }}" class="object-fit-contain" alt="{{ provider.name }} Logo"/>
+                <img src="{{ provider.logo | uj_cachebreak }}" class="object-fit-contain" alt="{{ provider.name }} Logo"/>
               </span>
               <span class="button-text">Continue with {{ provider.name }}</span>
             </button>

package/dist/defaults/dist/_layouts/themes/classy/frontend/pages/auth/signup.html

@@ -26,7 +26,7 @@ social_signup:
       <!-- Logo -->
       <div class="text-center mb-3">
         <div class="avatar avatar-xl">
-          <img src="{{ site.brand.images.brandmark }}?cb={{ site.uj.cache_breaker }}" class="filter-adaptive" alt="{{ site.brand.name }} Logo"/>
+          <img src="{{ site.brand.images.brandmark | uj_cachebreak }}" class="filter-adaptive" alt="{{ site.brand.name }} Logo"/>
         </div>
       </div>
 
@@ -50,7 +50,7 @@ social_signup:
             <button type="submit" class="btn btn-adaptive _btn-lg w-100 mb-3 d-flex align-items-center justify-content-center" data-provider="{{ provider.id }}">
               {{ initializing_spinner }}
               <span class="avatar avatar-xs me-2">
-                <img src="{{ provider.logo }}?cb={{ site.uj.cache_breaker }}" class="object-fit-contain" alt="{{ provider.name }} Logo"/>
+                <img src="{{ provider.logo | uj_cachebreak }}" class="object-fit-contain" alt="{{ provider.name }} Logo"/>
               </span>
               <span class="button-text">Sign up with {{ provider.name }}</span>
             </button>

package/dist/defaults/dist/_layouts/themes/classy/frontend/pages/auth/token.html

@@ -9,7 +9,7 @@ layout: themes/[ site.theme.id ]/frontend/core/cover
       <!-- Logo -->
       <div class="text-center mb-3">
         <div class="avatar avatar-xl">
-          <img src="{{ site.brand.images.brandmark }}?cb={{ site.uj.cache_breaker }}" class="filter-adaptive" alt="{{ site.brand.name }} Logo"/>
+          <img src="{{ site.brand.images.brandmark | uj_cachebreak }}" class="filter-adaptive" alt="{{ site.brand.name }} Logo"/>
         </div>
       </div>
 

package/dist/defaults/dist/_layouts/themes/classy/frontend/pages/feedback.html

@@ -20,16 +20,16 @@ feedback_form:
   ratings:
     - id: "dislike"
       label: "Poor"
-      image: "https://cdn.itwcreativeworks.com/assets/general/images/feedback/dislike.png?cb={{ site.uj.cache_breaker }}"
+      image: "https://cdn.itwcreativeworks.com/assets/general/images/feedback/dislike.png"
     - id: "neutral"
       label: "Okay"
-      image: "https://cdn.itwcreativeworks.com/assets/general/images/feedback/neutral.png?cb={{ site.uj.cache_breaker }}"
+      image: "https://cdn.itwcreativeworks.com/assets/general/images/feedback/neutral.png"
     - id: "like"
       label: "Good"
-      image: "https://cdn.itwcreativeworks.com/assets/general/images/feedback/like.png?cb={{ site.uj.cache_breaker }}"
+      image: "https://cdn.itwcreativeworks.com/assets/general/images/feedback/like.png"
     - id: "love"
       label: "Excellent"
-      image: "https://cdn.itwcreativeworks.com/assets/general/images/feedback/love.png?cb={{ site.uj.cache_breaker }}"
+      image: "https://cdn.itwcreativeworks.com/assets/general/images/feedback/love.png"
 
 # Prerender icons for JS
 prerender_icons:
@@ -92,7 +92,7 @@ prerender_icons:
                   {% for rating in page.resolved.feedback_form.ratings %}
                     <div class="col-6 col-sm-3">
                       <button type="button" class="feedback-rating-btn w-100 border rounded-3 bg-body text-center" data-rating="{{ rating.id }}">
-                        <img src="{{ rating.image }}" alt="{{ rating.label }}" class="feedback-rating-img mb-2" width="64" height="64" loading="eager">
+                        <img src="{{ rating.image | uj_cachebreak }}" alt="{{ rating.label }}" class="feedback-rating-img mb-2" width="64" height="64" loading="eager">
                         <span class="d-block small fw-semibold text-muted">{{ rating.label }}</span>
                       </button>
                     </div>
@@ -164,7 +164,7 @@ prerender_icons:
     <div class="modal-content border-0 shadow-lg">
       <div class="modal-body text-center p-5">
         <div class="mb-4">
-          <img src="https://cdn.itwcreativeworks.com/assets/general/images/feedback/love.png?cb={{ site.uj.cache_breaker }}" alt="Thank you" width="80" height="80">
+          <img src="{{ 'https://cdn.itwcreativeworks.com/assets/general/images/feedback/love.png' | uj_cachebreak }}" alt="Thank you" width="80" height="80">
         </div>
         <h3 class="mb-3" id="review-modal-label">You're awesome!</h3>
         <p class="text-muted mb-3">

package/dist/defaults/dist/_layouts/themes/classy/frontend/pages/payment/checkout.html

@@ -379,7 +379,7 @@ web_manager:
                         <div class="d-flex align-items-center wm-binding-skeleton" data-wm-bind="@show checkout">
                           <div class="position-relative me-3">
                             <div class="product-thumbnail bg-light rounded-3 d-flex align-items-center justify-content-center">
-                              <img src="{{ site.brand.images.brandmark }}?cb={{ site.uj.cache_breaker }}" class="img-fluid p-2" alt="{{ site.brand.name }} Plan Icon"/>
+                              <img src="{{ site.brand.images.brandmark | uj_cachebreak }}" class="img-fluid p-2" alt="{{ site.brand.name }} Plan Icon"/>
                             </div>
                             <span class="quantity-badge position-absolute top-0 start-100 translate-middle badge rounded-circle bg-primary">
                               1

package/dist/defaults/dist/_layouts/themes/classy/frontend/pages/portal/email-preferences.html

@@ -14,7 +14,7 @@ prerender_icons:
       <!-- Logo -->
       <div class="text-center mb-3">
         <div class="avatar avatar-xl">
-          <img src="{{ site.brand.images.brandmark }}?cb={{ site.uj.cache_breaker }}" alt="{{ site.brand.name }} Logo"/>
+          <img src="{{ site.brand.images.brandmark | uj_cachebreak }}" alt="{{ site.brand.name }} Logo"/>
         </div>
       </div>
 

package/docs/common-mistakes.md

@@ -13,3 +13,4 @@
 11. **Using native fetch** — always use `wonderful-fetch` or `authorized-fetch`.
 12. **XSS — unescaped dynamic data in innerHTML** — Use `webManager.utilities().escapeHTML()`. Dynamic URLs in `href`/`src`/`action`/`window.location`/`window.open` ALSO need `webManager.utilities().sanitizeURL()` — `escapeHTML` alone lets `javascript:` execute. See [xss-prevention.md](xss-prevention.md).
 13. **Leaving Liquid `{{ }}` or `{% %}` inside moved JS modules** — Jekyll does NOT process `src/assets/js/**/*.js`. Use `data-*` attribute bridges or `<template>` cloning.
+14. **🚫 `<img src>` without cachebreakers** — every `<img src>` in includes/layouts MUST append `?cb={{ site.uj.cache_breaker }}` to the URL. This applies to logos, brandmarks, rating images — any image rendered via a Liquid variable. Without it, browsers serve stale cached versions indefinitely when the image file changes on the CDN. External third-party URLs are exempt. `data-lazy="@src"` is handled at the JS layer, not in the HTML.

package/docs/jekyll-plugin.md

@@ -6,7 +6,7 @@ Ultimate Jekyll uses the `jekyll-uj-powertools` gem for custom Liquid functional
 
 ## Available Features
 
-- **Filters:** `uj_strip_ads`, `uj_json_escape`, `uj_title_case`, `uj_content_format`, `uj_hash`
+- **Filters:** `uj_strip_ads`, `uj_json_escape`, `uj_title_case`, `uj_content_format`, `uj_hash`, `uj_append_param`, `uj_cachebreak`
 - **Tags:** `iftruthy`, `iffalsy`, `uj_icon`, `uj_logo`, `uj_image`, `uj_member`, `uj_post`, `uj_readtime`, `uj_social`, `uj_translation_url`, `uj_fake_comments`, `uj_language`
 - **Global Variables:** `site.uj.cache_breaker`
 - **Page Variables:** `page.random_id`, `page.extension`, `page.layout_data`, `page.resolved`
@@ -28,6 +28,30 @@ Returns a deterministic number between 0 and max (exclusive) based on the input
 {{ site.url | uj_hash: 2 }}          => 0 or 1
 ```
 
+### `uj_append_param`
+
+Intelligently appends a query parameter to a URL, using `?` or `&` depending on whether the URL already has a query string.
+
+```liquid
+{{ "https://example.com/img.png" | uj_append_param: "cb", "123" }}
+<!-- Output: https://example.com/img.png?cb=123 -->
+
+{{ "https://example.com/img.png?w=200" | uj_append_param: "cb", "123" }}
+<!-- Output: https://example.com/img.png?w=200&cb=123 -->
+```
+
+### `uj_cachebreak`
+
+Appends a cache-busting `cb=<timestamp>` query parameter to any URL. Uses the same consistent timestamp as `site.uj.cache_breaker`. Handles URLs with or without existing query strings.
+
+```liquid
+{{ site.brand.images.brandmark | uj_cachebreak }}
+<!-- Output: https://cdn.example.com/logo.svg?cb=1234567890 -->
+
+{{ "/assets/css/main.bundle.css" | uj_cachebreak }}
+<!-- Output: /assets/css/main.bundle.css?cb=1234567890 -->
+```
+
 ### `iftruthy` / `iffalsy`
 
 Custom tags that check JavaScript truthiness (not null, undefined, or empty string).
@@ -67,3 +91,5 @@ asset_path: blog/post
 ```
 
 Uses `/assets/css/pages/{{ asset_path }}.bundle.css` instead of deriving from `page.canonical.path`. Useful when multiple pages share assets (e.g., all blog posts). See also [docs/layouts-and-pages.md](layouts-and-pages.md).
+
+**⚠️ Only set `asset_path` when sharing a module between pages.** Without it, the loader resolves `<pagePath>/index.js` automatically — that's the correct default for pages whose JS lives at `src/assets/js/pages/<pagePath>/index.js`. Setting `asset_path` overrides this to look for an **exact file** (`<asset_path>.js`), NOT a directory's `index.js`. A wrong `asset_path` fails **silently** — the page renders but the module never loads.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ultimate-jekyll-manager",
-  "version": "1.9.8",
+  "version": "1.9.10",
   "description": "Ultimate Jekyll dependency manager",
   "main": "dist/index.js",
   "files": [