create-berna-stencil 2.0.7 → 2.0.9

package/.eleventy.js

@@ -1,6 +1,7 @@
 const esbuild = require("esbuild");
 const glob = require("glob");
 const Image = require("@11ty/eleventy-img");
+const markdownIt = require('markdown-it');
 const fs = require("fs");
 const path = require("path");
 
@@ -9,32 +10,50 @@ const OUTPUT_DIR = "out";
 module.exports = function (eleventyConfig) {
 
   function copyRecursiveSync(src, dest) {
-  if (!fs.existsSync(src)) return;
-  if (src.includes('.git')) return;
-  const stat = fs.statSync(src);
-  if (stat.isDirectory()) {
-    fs.mkdirSync(dest, { recursive: true });
-    for (const child of fs.readdirSync(src)) {
-      copyRecursiveSync(path.join(src, child), path.join(dest, child));
+    if (!fs.existsSync(src)) return;
+    if (src.includes('.git')) return;
+    const stat = fs.statSync(src);
+    if (stat.isDirectory()) {
+      fs.mkdirSync(dest, { recursive: true });
+      for (const child of fs.readdirSync(src)) {
+        copyRecursiveSync(path.join(src, child), path.join(dest, child));
+      }
+    } else {
+      fs.mkdirSync(path.dirname(dest), { recursive: true });
+      fs.copyFileSync(src, dest);
     }
-  } else {
-    fs.mkdirSync(path.dirname(dest), { recursive: true });
-    fs.copyFileSync(src, dest);
   }
-}
+
+  // =====================================================
+  // SHORTCODE — Markdown file renderer
+  // =====================================================
+  const md = markdownIt({ html: true });
+
+  eleventyConfig.addShortcode('mdFile', function(filePath) {
+    const content = fs.readFileSync(filePath, 'utf8');
+    return md.render(content);
+  });
+
+  // =====================================================
+  // SHORTCODE — Markdown css
+  // =====================================================
+  eleventyConfig.addPassthroughCopy({
+    "node_modules/github-markdown-css/github-markdown-dark.css": "css/github-markdown-dark.css",
+    "node_modules/github-markdown-css/github-markdown-light.css": "css/github-markdown-light.css",
+  });
 
   // =====================================================
   // ESBUILD — Bundles and minifies JS files before build
   // =====================================================
   eleventyConfig.on("eleventy.before", async () => {
-      const entryPoints = glob.sync("src/frontend/js/pages/*.js");
-      await esbuild.build({
-        entryPoints,
-        bundle: true,
-        outdir: `${OUTPUT_DIR}/js/pages`,
-        minify: true,
-      });
-      copyRecursiveSync("src/backend", `${OUTPUT_DIR}/backend`);
+    const entryPoints = glob.sync("src/frontend/js/pages/*.js");
+    await esbuild.build({
+      entryPoints,
+      bundle: true,
+      outdir: `${OUTPUT_DIR}/js/pages`,
+      minify: true,
+    });
+    copyRecursiveSync("src/backend", `${OUTPUT_DIR}/backend`);
   });
 
   // =====================================================

package/README.md

@@ -12,13 +12,14 @@ Building a website from scratch involves a lot of moving parts: templating engin
 - 📁 **Scalable structure** — a clean, opinionated project layout that grows with your needs
 - 🌍 **Open source** — free to use, free to modify, free to share
 
-![Version](https://img.shields.io/badge/version-2.0.7-blue)
+![Version](https://img.shields.io/badge/version-2.0.9-blue)
 ![License](https://img.shields.io/badge/license-Apache--2.0-blue)
 ![Eleventy](https://img.shields.io/badge/11ty-v3.1.2-black)
 
 ## Prerequisites
 * **Node.js**: v18.0.0 or higher
 * **Composer**: latest stable version
+* #### Optional: Better Nunjucks VS Code extension by Ed Heltzel
 
 ## Installation
 * Open your IDE (e.g. Visual Studio Code), open the folder that contains your websites and open a new terminal

package/bin/create.js

@@ -16,7 +16,7 @@ const COPY_TARGETS = [
 
 const PROJECT_PACKAGE = {
     name: path.basename(targetDir),
-    version: '2.0.7',
+    version: '2.0.9',
     private: true,
     scripts: {
         "build:css": "sass src/frontend/scss:out/css --no-source-map --style=compressed --quiet --load-path=node_modules",
@@ -202,7 +202,7 @@ function applyFramework(framework) {
 function askFramework() {
     return new Promise((resolve) => {
         const choices = [
-            { label: 'Bootstrap', value: 'bootstrap' },
+            { label: 'Bootstrap (default)', value: 'bootstrap' },
             { label: 'Bulma', value: 'bulma' },
             { label: 'Foundation', value: 'foundation' },
             { label: 'UIkit', value: 'uikit' },

package/docs/Components.md

@@ -43,6 +43,18 @@ Add a new `{% elif %}` block for each page, listing its components in order. If
 
 > ⚠️ If you move or delete a component, always update `includes.njk` or the site will break
 
+### Using Markdown files in components
+
+You can also render a `.md` file directly inside any `.njk` component using the `mdFile` shortcode:
+
+```njk
+{% mdFile "docs/your-file.md" %}
+```
+
+The path is relative to the project root (where `.eleventy.js` lives).
+
+> ⚠️ The file is read at build time — changes to the `.md` file trigger a rebuild in watch mode.
+
 ## Nest components
 
 A component can include other components. This is useful for breaking complex sections into smaller, reusable pieces.

package/docs/Creating pages.md

@@ -1,9 +1,8 @@
 # Creating Pages
 
-The recommended way is via the [Assistant CLI](assistant-cli.md).
+The recommended way is via the **Assistant CLI**
 
 ## What gets created
-
 For a page named `my-page`:
 
 | File | Purpose |
@@ -22,7 +21,7 @@ For a page named `my-page`:
   {% include "_myPage.njk" %}
 ```
 
-See [components.md](components.md) for details.
+See **Components** DOC file for more info
 
 ## URL and title
 
@@ -41,4 +40,4 @@ The CLI creates a stub entry in `src/data/site.json`. Fill it in:
 }
 ```
 
-See [head-and-seo.md](head-and-seo.md) for all available options.
+See **Head & SEO** for all available options.

package/docs/Head and SEO.md

@@ -59,21 +59,21 @@ To customize them, edit `src/llms.njk` or `src/robots.njk` directly.
 
 `src/llms.njk` ships with a base template — **replace the placeholders with your own content**:
 
-```markdown
-# Site name
+```
+# {{ site.site_name }}
 
-> Site description
+> {{ site.description }}
 
-Built by Name and surname — https://yoursite.com
+Built by {{ site.author }} — {{ site.url }}
 
 ## Pages
 
-- https://yoursite.com: Homepage
+- {{ site.url }}: Homepage
 
 ## Notes
 
-- Language: en
-- All content may be used for AI indexing unless otherwise stated
+- Language: {{ site.lang }}
+- All content may be used for AI inde   xing unless otherwise stated
 ```
 
 > The more accurate and detailed your `llms.txt`, the better AI models will understand and reference your site.

package/package.json

@@ -1,61 +1,63 @@
-{
-  "name": "create-berna-stencil",
-  "version": "2.0.7",
-  "description": "Eleventy boilerplate with per-page SCSS/JS pipeline, esbuild bundling, multi-framework CSS support and a built-in page management CLI",
-  "keywords": [],
-  "author": "Michele Garofalo",
-  "license": "Apache-2.0",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/rhaastrake/berna-stencil"
-  },
-  "homepage": "https://github.com/rhaastrake/berna-stencil#readme",
-  "bugs": {
-    "url": "https://github.com/rhaastrake/berna-stencil/issues"
-  },
-  "bin": {
-    "create-berna-stencil": "bin/create.js"
-  },
-  "files": [
-    "bin/",
-    "docs/",
-    "src/",
-    "_tools/",
-    ".eleventy.js",
-    ".eleventyignore",
-    ".gitignore",
-    "LICENSE",
-    "NOTICE"
-  ],
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "dependencies": {
-    "@11ty/eleventy": "^3.1.2",
-    "@11ty/eleventy-img": "^6.0.4",
-    "bootstrap": "^5.3.8",
-    "bootstrap-icons": "^1.13.1",
-    "bulma": "^1.0.4",
-    "foundation-sites": "^6.9.0",
-    "glob": "^13.0.6",
-    "uikit": "^3.25.13"
-  },
-  "devDependencies": {
-    "concurrently": "^9.2.1",
-    "esbuild": "^0.27.3",
-    "sass": "^1.77.0"
-  },
-  "scripts": {
-    "build:css": "sass src/frontend/scss:out/css --no-source-map --style=compressed --quiet",
-    "build:js": "esbuild \"src/frontend/js/pages/*.js\" --bundle --outdir=out/js/pages --minify",
-    "build:11ty": "eleventy",
-    "build": "npm run clean && npm run build:css && npm run build:js && npm run build:11ty",
-    "serve:css": "sass --watch src/frontend/scss:out/css --no-source-map --quiet",
-    "serve:js": "esbuild \"src/frontend/js/pages/*.js\" --bundle --outdir=out/js/pages --watch",
-    "serve:11ty": "eleventy --serve --quiet",
-    "clean": "node _tools/cleanOutput.js",
-    "serve": "npm run clean && concurrently \"npm run serve:11ty\" \"npm run serve:css\" \"npm run serve:js\"",
-    "assistant": "node _tools/assistant.js",
-    "postinstall": "cd src/backend/_core && composer install --quiet"
-  }
-}
+{
+  "name": "create-berna-stencil",
+  "version": "2.0.9",
+  "description": "Eleventy boilerplate with per-page SCSS/JS pipeline, esbuild bundling, multi-framework CSS support and a built-in page management CLI",
+  "keywords": [],
+  "author": "Michele Garofalo",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/rhaastrake/berna-stencil"
+  },
+  "homepage": "https://github.com/rhaastrake/berna-stencil#readme",
+  "bugs": {
+    "url": "https://github.com/rhaastrake/berna-stencil/issues"
+  },
+  "bin": {
+    "create-berna-stencil": "bin/create.js"
+  },
+  "files": [
+    "bin/",
+    "docs/",
+    "src/",
+    "_tools/",
+    ".eleventy.js",
+    ".eleventyignore",
+    ".gitignore",
+    "LICENSE",
+    "NOTICE"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@11ty/eleventy": "^3.1.2",
+    "@11ty/eleventy-img": "^6.0.4",
+    "bootstrap": "^5.3.8",
+    "bootstrap-icons": "^1.13.1",
+    "bulma": "^1.0.4",
+    "foundation-sites": "^6.9.0",
+    "github-markdown-css": "^5.9.0",
+    "glob": "^13.0.6",
+    "markdown-it": "^14.2.0",
+    "uikit": "^3.25.13"
+  },
+  "devDependencies": {
+    "concurrently": "^9.2.1",
+    "esbuild": "^0.27.3",
+    "sass": "^1.77.0"
+  },
+  "scripts": {
+    "build:css": "sass src/frontend/scss:out/css --no-source-map --style=compressed --quiet",
+    "build:js": "esbuild \"src/frontend/js/pages/*.js\" --bundle --outdir=out/js/pages --minify",
+    "build:11ty": "eleventy",
+    "build": "npm run clean && npm run build:css && npm run build:js && npm run build:11ty",
+    "serve:css": "sass --watch src/frontend/scss:out/css --no-source-map --quiet",
+    "serve:js": "esbuild \"src/frontend/js/pages/*.js\" --bundle --outdir=out/js/pages --watch",
+    "serve:11ty": "eleventy --serve --quiet",
+    "clean": "node _tools/cleanOutput.js",
+    "serve": "npm run clean && concurrently \"npm run serve:11ty\" \"npm run serve:css\" \"npm run serve:js\"",
+    "assistant": "node _tools/assistant.js",
+    "postinstall": "cd src/backend/_core && composer install --quiet"
+  }
+}

package/src/backend/_core/vendor/composer/autoload_static.php

@@ -13,48 +13,48 @@ class ComposerStaticInit108be68e4e2b97fed51d36a10eed0849
     );
 
     public static $prefixLengthsPsr4 = array (
-        'S' => 
+        'S' =>
         array (
             'Symfony\\Polyfill\\Php80\\' => 23,
             'Symfony\\Polyfill\\Mbstring\\' => 26,
             'Symfony\\Polyfill\\Ctype\\' => 23,
         ),
-        'P' => 
+        'P' =>
         array (
             'PhpOption\\' => 10,
         ),
-        'G' => 
+        'G' =>
         array (
             'GrahamCampbell\\ResultType\\' => 26,
         ),
-        'D' => 
+        'D' =>
         array (
             'Dotenv\\' => 7,
         ),
     );
 
     public static $prefixDirsPsr4 = array (
-        'Symfony\\Polyfill\\Php80\\' => 
+        'Symfony\\Polyfill\\Php80\\' =>
         array (
             0 => __DIR__ . '/..' . '/symfony/polyfill-php80',
         ),
-        'Symfony\\Polyfill\\Mbstring\\' => 
+        'Symfony\\Polyfill\\Mbstring\\' =>
         array (
             0 => __DIR__ . '/..' . '/symfony/polyfill-mbstring',
         ),
-        'Symfony\\Polyfill\\Ctype\\' => 
+        'Symfony\\Polyfill\\Ctype\\' =>
         array (
             0 => __DIR__ . '/..' . '/symfony/polyfill-ctype',
         ),
-        'PhpOption\\' => 
+        'PhpOption\\' =>
         array (
             0 => __DIR__ . '/..' . '/phpoption/phpoption/src/PhpOption',
         ),
-        'GrahamCampbell\\ResultType\\' => 
+        'GrahamCampbell\\ResultType\\' =>
         array (
             0 => __DIR__ . '/..' . '/graham-campbell/result-type/src',
         ),
-        'Dotenv\\' => 
+        'Dotenv\\' =>
         array (
             0 => __DIR__ . '/..' . '/vlucas/phpdotenv/src',
         ),

package/src/backend/_core/vendor/composer/installed.json

@@ -24,7 +24,7 @@
             },
             "time": "2025-12-27T19:43:20+00:00",
             "type": "library",
-            "installation-source": "source",
+            "installation-source": "dist",
             "autoload": {
                 "psr-4": {
                     "GrahamCampbell\\ResultType\\": "src/"
@@ -98,7 +98,7 @@
                     "dev-master": "1.9-dev"
                 }
             },
-            "installation-source": "source",
+            "installation-source": "dist",
             "autoload": {
                 "psr-4": {
                     "PhpOption\\": "src/PhpOption/"
@@ -175,7 +175,7 @@
                     "name": "symfony/polyfill"
                 }
             },
-            "installation-source": "source",
+            "installation-source": "dist",
             "autoload": {
                 "files": [
                     "bootstrap.php"
@@ -262,7 +262,7 @@
                     "name": "symfony/polyfill"
                 }
             },
-            "installation-source": "source",
+            "installation-source": "dist",
             "autoload": {
                 "files": [
                     "bootstrap.php"
@@ -343,7 +343,7 @@
                     "name": "symfony/polyfill"
                 }
             },
-            "installation-source": "source",
+            "installation-source": "dist",
             "autoload": {
                 "files": [
                     "bootstrap.php"
@@ -447,7 +447,7 @@
                     "dev-master": "5.6-dev"
                 }
             },
-            "installation-source": "source",
+            "installation-source": "dist",
             "autoload": {
                 "psr-4": {
                     "Dotenv\\": "src/"

package/src/backend/_core/vendor/composer/installed.php

@@ -3,7 +3,7 @@
         'name' => '__root__',
         'pretty_version' => 'dev-main',
         'version' => 'dev-main',
-        'reference' => '4da27b8f50bb1a801f88ad46a9e9eafa51c1bb34',
+        'reference' => '1914258c0d42371ce0d441bf14d8d5c68fbb542f',
         'type' => 'library',
         'install_path' => __DIR__ . '/../../',
         'aliases' => array(),
@@ -13,7 +13,7 @@
         '__root__' => array(
             'pretty_version' => 'dev-main',
             'version' => 'dev-main',
-            'reference' => '4da27b8f50bb1a801f88ad46a9e9eafa51c1bb34',
+            'reference' => '1914258c0d42371ce0d441bf14d8d5c68fbb542f',
             'type' => 'library',
             'install_path' => __DIR__ . '/../../',
             'aliases' => array(),

package/src/backend/_core/vendor/graham-campbell/result-type/LICENSE

@@ -1,21 +1,21 @@
-The MIT License (MIT)
-
-Copyright (c) 2020-2024 Graham Campbell <hello@gjcampbell.co.uk>
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in
-all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-THE SOFTWARE.
+The MIT License (MIT)
+
+Copyright (c) 2020-2024 Graham Campbell <hello@gjcampbell.co.uk>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/src/backend/_core/vendor/graham-campbell/result-type/composer.json

@@ -1,33 +1,33 @@
-{
-    "name": "graham-campbell/result-type",
-    "description": "An Implementation Of The Result Type",
-    "keywords": ["result", "result-type", "Result", "Result Type", "Result-Type", "Graham Campbell", "GrahamCampbell"],
-    "license": "MIT",
-    "authors": [
-        {
-            "name": "Graham Campbell",
-            "email": "hello@gjcampbell.co.uk",
-            "homepage": "https://github.com/GrahamCampbell"
-        }
-    ],
-    "require": {
-        "php": "^7.2.5 || ^8.0",
-        "phpoption/phpoption": "^1.9.5"
-    },
-    "require-dev": {
-        "phpunit/phpunit": "^8.5.41 || ^9.6.22 || ^10.5.45 || ^11.5.7"
-    },
-    "autoload": {
-        "psr-4": {
-            "GrahamCampbell\\ResultType\\": "src/"
-        }
-    },
-    "autoload-dev": {
-        "psr-4": {
-            "GrahamCampbell\\Tests\\ResultType\\": "tests/"
-        }
-    },
-    "config": {
-        "preferred-install": "dist"
-    }
-}
+{
+    "name": "graham-campbell/result-type",
+    "description": "An Implementation Of The Result Type",
+    "keywords": ["result", "result-type", "Result", "Result Type", "Result-Type", "Graham Campbell", "GrahamCampbell"],
+    "license": "MIT",
+    "authors": [
+        {
+            "name": "Graham Campbell",
+            "email": "hello@gjcampbell.co.uk",
+            "homepage": "https://github.com/GrahamCampbell"
+        }
+    ],
+    "require": {
+        "php": "^7.2.5 || ^8.0",
+        "phpoption/phpoption": "^1.9.5"
+    },
+    "require-dev": {
+        "phpunit/phpunit": "^8.5.41 || ^9.6.22 || ^10.5.45 || ^11.5.7"
+    },
+    "autoload": {
+        "psr-4": {
+            "GrahamCampbell\\ResultType\\": "src/"
+        }
+    },
+    "autoload-dev": {
+        "psr-4": {
+            "GrahamCampbell\\Tests\\ResultType\\": "tests/"
+        }
+    },
+    "config": {
+        "preferred-install": "dist"
+    }
+}