create-berna-stencil 1.0.49 → 1.0.51

package/_tools/modules/updateIncludes.js

@@ -15,7 +15,7 @@ function addLayout(pageName) {
 
     if (content.includes(`{% elif title == "${camelName}" %}`)) return;
 
-    const newElif = `{% elif title == "${camelName}" %}\n  {#{% include "component.njk" %}#}\n\n`;
+    const newElif = `{% elif title == "${camelName}" %}\n  {# Insert your includes under this page #}\n  {#{% include "component.njk" %}#}\n\n`;
     const updatedContent = content.replace('{% else %}', `${newElif}{% else %}`);
 
     fileSystem.writeFileSync(INCLUDES_PATH, updatedContent);

package/bin/create.js

@@ -19,11 +19,11 @@ const PROJECT_PACKAGE = {
     version: '1.0.47',
     private: true,
     scripts: {
-        "build:css": "sass src/frontend/scss:out/css --no-source-map --style=compressed --quiet",
+        "build:css": "sass src/frontend/scss:out/css --no-source-map --style=compressed --quiet --load-path=node_modules",
         "build:js": "esbuild \"src/frontend/js/pages/*.js\" --bundle --outdir=out/js/pages --minify",
         "build:11ty": "eleventy",
         "build": "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:css": "sass --watch src/frontend/scss:out/css --no-source-map --quiet --load-path=node_modules",
         "serve:js": "esbuild \"src/frontend/js/pages/*.js\" --bundle --outdir=out/js/pages --watch",
         "serve:11ty": "eleventy --serve --quiet",
         "clean": "node _tools/cleanOutput.js",

package/docs/Components.md

@@ -1,62 +1,83 @@
-# To be finished...
+# Nunjucks (HTML) Components
 
-# Components
+## What is Nunjucks
+
+Nunjucks (`.njk`) is an HTML file that supports logic like variables, `if` statements, and `for` loops. It can extend a base layout and include other `.njk` components
 
 ## Create a component
 
-Add a Nunjucks file in `src/components/`:
+Create a new `.njk` file anywhere inside `src/frontend/components/`. You can organize them into subfolders freely
 
 ```
-src/components/myComponent.njk
+src/frontend/components/
+├── global/
+├── layouts/
+├── modals/
+│   └── privacyModal.njk # You can move it to a modals/subfolder
+├── welcome.njk
 ```
 
-## Subfolders
+## Include a component
 
-Components can be organized into subfolders freely. Some examples:
+To render a component inside a page, navigate to `src/frontend/components/layouts/` and edit `includes.njk`
 
-```
-src/components/
-├── global/          # Header, footer — included in every page
-├── pages/           # Page-specific components
-│   ├── homepage.njk
-│   └── contactUs.njk
-└── modals/          # Shared modals (privacy, cookies, etc.)
-    └── privacyModal.njk
-```
+### includes.njk <small>(`src/frontend/components/layouts/`)</small>
+
+```js
+{% if title == "homepage" %}
+  {% include "welcome.njk" %}
 
-The include path must reflect the subfolder:
+{% elif title == "examplePage" %}
+  {% include "exampleComponent1.njk" %}
+  {% include "subfolder/exampleComponent2.njk" %}
 
-```njk
-{% include "pages/homepage.njk" %}
-{% include "modals/privacyModal.njk" %}
+{% else %}
+  {% include "404/_404.njk" %}
+  {{ content | safe }}
+{% endif %}
 ```
 
-## Register it for a page
+Add a new `{% elif %}` block for each page, listing its components in order. If a component lives in a subfolder, specify the relative path accordingly
 
-In `src/layouts/includes.njk`, find the `elif` block for your page and include the component:
+> ⚠️ A new `elif` block is automatically added when you create a page via the Assistant CLI
 
-```njk
-{% elif title == "myPage" %}
-  {% include "myComponent.njk" %}
-```
+> ⚠️ If you move or delete a component, always update `includes.njk` or the site will break
+
+## Nest components
 
-Multiple components can be included in the same block:
+A component can include other components. This is useful for breaking complex sections into smaller, reusable pieces.
 
-```njk
-{% elif title == "myPage" %}
-  {% include "hero.njk" %}
-  {% include "features.njk" %}
+### exampleComponent.njk
+```js
+<section class="hero">
+  {% include "ui/heroTitle.njk" %}
+  {% include "ui/heroButton.njk" %}
+</section>
 ```
 
+> The same path rules apply: if the included component is in a subfolder, specify the full relative path.
+
 ## Global components
 
-Header and footer live in `src/components/global/` and are automatically included in every page via `base.njk`. Edit them to change the site-wide layout.
+Header and footer live in `src/frontend/components/global/` and are automatically included in every page via `base.njk`. Edit them to change the site-wide layout
 
 ## Site data in components
 
-All values from `src/data/site.json` are available as `{{ site.* }}`:
+All values defined in `src/data/site.json` are globally available in every component via `{{ site.* }}`
+
+### site.json <small>(`src/data/`)</small>
+```json
+{
+  "title": "My Site",
+  "logo": "/img/logo.png",
+  "legal": {
+    "privacy": "/privacy"
+  }
+}
+```
 
-```njk
+### Usage in any `.njk` file
+```js
 <p>{{ site.title }}</p>
 <a href="{{ site.legal.privacy }}">Privacy Policy</a>
 <img src="{{ site.logo }}" alt="{{ site.title }}">

package/docs/Head and SEO.md

@@ -1,9 +1,9 @@
 # Head & SEO
 
 
-`src/frontend/data/site.json` holds global settings used across all pages in `base.njk` and other components:
+This json holds global settings used across all pages in `base.njk` and other components:
 
-### site.json
+### site.json <small>`src/frontend/data/`</small>
 ```json
 "site_name": "Site name",
 "title": "Site title",
@@ -25,7 +25,7 @@ Each page entry is keyed by its camelCase `title` from the front matter:
 
 If you don't want to use a particular cdn inserting it in `base.njk` for all pages, you can add extra specific cdn (css, js) by inserting the link in each page of site.json separating them with a `,` and setting them in ""
 
-### site.json
+### site.json <small>`src/frontend/data/`</small>
 ```json
 "pages": {
     ...
@@ -35,10 +35,37 @@ If you don't want to use a particular cdn inserting it in `base.njk` for all pag
         "description": "description"
       },
       "cdn": {
-        "css": [],
-        "js": []
+        // You can leave the [] empty
+        "css": ["https://example1.com/lib.min.css", "https://example2.com/lib.min.css"],
+        "js": ["https://example1.com/lib.min.js", "https://example2.com/lib.min.js"]
       }
     }
     ...
 }
-```
+```
+
+## AI & SEO bots
+
+`llms.txt` and `robots.txt` are generated automatically from `site.json` via their respective `.njk` files — no manual editing needed.
+
+| File | Purpose | Reachable at |
+|---|---|---|
+| `llms.njk` | Tells AI models what your site is about | `yoursite.com/llms.txt` |
+| `robots.njk` | Controls search engine crawling | `yoursite.com/robots.txt` |
+
+To customize them, edit `src/llms.njk` or `src/robots.njk` directly.
+
+## Configuration field description
+
+| Field | Purpose |
+|---|---|
+| `site_name` | Brand name (used in meta tags) |
+| `title` | Default page title |
+| `description` | Default meta description |
+| `keywords` | Default meta keywords |
+| `domain` / `url` | Used for canonical URLs and og:url |
+| `lang` | HTML `lang` attribute |
+| `author` | Meta author tag |
+| `data_bs_theme` | Bootstrap color scheme (`light` / `dark`) |
+| `favicon` | Path to the favicon |
+| `logo` | Path to the logo (available as `{{ site.logo }}`) |

package/docs/Styling with SCSS.md

@@ -61,7 +61,7 @@ To enable/disable them you have to modify 3 files around the project by just com
 {# Bulma — no JS needed #}
 ```
 
-### 3. `.eleventy.js`
+### 3. .eleventy.js
 
 ```javascript
 eleventyConfig.addPassthroughCopy({
@@ -83,8 +83,8 @@ eleventyConfig.addPassthroughCopy({
 ### Reducing bundle size
 To reduce the bundle size, open the corresponding framework file (`src/frontend/scss/modules/frameworks/`) and comment out any modules you don't need
 ```scss
-@import "../../../../../node_modules/bootstrap/scss/card"; // Cards
-@import "../../../../../node_modules/bootstrap/scss/carousel"; // Carousel
+@import "bootstrap/scss/card"; // Cards
+@import "bootstrap/scss/carousel"; // Carousel
 ```
 
 ## Global Variables
@@ -131,8 +131,10 @@ body {
 |---|---|
 | `_root.scss` | Global variables (colors, spacing) |
 | `_global.scss` | Site-wide base rules and frameworks |
-| `_animations.scss` | Keyframe animations (`fade-in`, `spin`) |
+| `_typography.scss` | Font rules
 | `_header.scss` | Header styles |
 | `_footer.scss` | Footer styles |
-| `_notification.scss` | Notification component style |
-| `_mobile.scss` | Media query rules |
+| `_mobile.scss` | Media query rules |
+| `_buttons.scss` | Style and hovers for buttons 
+| `_animations.scss` | Keyframe animations (`fade-in`, `spin`) |
+| `_notification.scss` | Notification component style |

package/package.json

@@ -1,63 +1,59 @@
-{
-  "name": "create-berna-stencil",
-  "version": "1.0.49",
-  "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": "MIT",
-  "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/",
-    "src/_routes",
-    "src/assets/files",
-    "src/assets/videos",
-    "src/assets/images",
-    "_tools/",
-    ".eleventy.js",
-    ".eleventyignore",
-    ".gitignore"
-  ],
-  "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 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": "1.0.51",
+  "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": "MIT",
+  "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"
+  ],
+  "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 --load-path=node_modules",
+    "build:js": "esbuild \"src/frontend/js/pages/*.js\" --bundle --outdir=out/js/pages --minify",
+    "build:11ty": "eleventy",
+    "build": "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 --load-path=node_modules",
+    "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": "dist",
+            "installation-source": "source",
             "autoload": {
                 "psr-4": {
                     "GrahamCampbell\\ResultType\\": "src/"
@@ -98,7 +98,7 @@
                     "dev-master": "1.9-dev"
                 }
             },
-            "installation-source": "dist",
+            "installation-source": "source",
             "autoload": {
                 "psr-4": {
                     "PhpOption\\": "src/PhpOption/"
@@ -175,7 +175,7 @@
                     "name": "symfony/polyfill"
                 }
             },
-            "installation-source": "dist",
+            "installation-source": "source",
             "autoload": {
                 "files": [
                     "bootstrap.php"
@@ -262,7 +262,7 @@
                     "name": "symfony/polyfill"
                 }
             },
-            "installation-source": "dist",
+            "installation-source": "source",
             "autoload": {
                 "files": [
                     "bootstrap.php"
@@ -343,7 +343,7 @@
                     "name": "symfony/polyfill"
                 }
             },
-            "installation-source": "dist",
+            "installation-source": "source",
             "autoload": {
                 "files": [
                     "bootstrap.php"
@@ -447,7 +447,7 @@
                     "dev-master": "5.6-dev"
                 }
             },
-            "installation-source": "dist",
+            "installation-source": "source",
             "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' => 'abd41735fb0323798fbaca8b317b15190d4c5da6',
+        'reference' => '4da27b8f50bb1a801f88ad46a9e9eafa51c1bb34',
         'type' => 'library',
         'install_path' => __DIR__ . '/../../',
         'aliases' => array(),
@@ -13,7 +13,7 @@
         '__root__' => array(
             'pretty_version' => 'dev-main',
             'version' => 'dev-main',
-            'reference' => 'abd41735fb0323798fbaca8b317b15190d4c5da6',
+            'reference' => '4da27b8f50bb1a801f88ad46a9e9eafa51c1bb34',
             'type' => 'library',
             'install_path' => __DIR__ . '/../../',
             'aliases' => array(),

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

@@ -0,0 +1,9 @@
+* text=auto
+
+/tests export-ignore
+/.gitattributes export-ignore
+/.github export-ignore
+/.gitignore export-ignore
+/phpunit.xml.dist export-ignore
+/CHANGELOG.md export-ignore
+/README.md export-ignore

package/src/backend/_core/vendor/graham-campbell/result-type/.github/CODE_OF_CONDUCT.md

@@ -0,0 +1,132 @@
+# CONTRIBUTOR COVENANT CODE OF CONDUCT
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, caste, color, religion, or sexual identity
+and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming,
+diverse, inclusive, and healthy community.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment for our
+community include:
+
+* Demonstrating empathy and kindness toward other people
+* Being respectful of differing opinions, viewpoints, and experiences
+* Giving and gracefully accepting constructive feedback
+* Accepting responsibility and apologizing to those affected by our mistakes,
+  and learning from the experience
+* Focusing on what is best not just for us as individuals, but for the
+  overall community
+
+Examples of unacceptable behavior include:
+
+* The use of sexualized language or imagery, and sexual attention or
+  advances of any kind
+* Trolling, insulting or derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or email
+  address, without their explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Enforcement Responsibilities
+
+Community leaders are responsible for clarifying and enforcing our standards of
+acceptable behavior and will take appropriate and fair corrective action in
+response to any behavior that they deem inappropriate, threatening, offensive,
+or harmful.
+
+Community leaders have the right and responsibility to remove, edit, or reject
+comments, commits, code, wiki edits, issues, and other contributions that are
+not aligned to this Code of Conduct, and will communicate reasons for moderation
+decisions when appropriate.
+
+## Scope
+
+This Code of Conduct applies within all community spaces, and also applies when
+an individual is officially representing the community in public spaces.
+Examples of representing our community include using an official e-mail address,
+posting via an official social media account, or acting as an appointed
+representative at an online or offline event.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to the community leaders responsible for enforcement at
+hello@gjcampbell.co.uk.
+All complaints will be reviewed and investigated promptly and fairly.
+
+All community leaders are obligated to respect the privacy and security of the
+reporter of any incident.
+
+## Enforcement Guidelines
+
+Community leaders will follow these Community Impact Guidelines in determining
+the consequences for any action they deem in violation of this Code of Conduct:
+
+### 1. Correction
+
+**Community Impact**: Use of inappropriate language or other behavior deemed
+unprofessional or unwelcome in the community.
+
+**Consequence**: A private, written warning from community leaders, providing
+clarity around the nature of the violation and an explanation of why the
+behavior was inappropriate. A public apology may be requested.
+
+### 2. Warning
+
+**Community Impact**: A violation through a single incident or series
+of actions.
+
+**Consequence**: A warning with consequences for continued behavior. No
+interaction with the people involved, including unsolicited interaction with
+those enforcing the Code of Conduct, for a specified period of time. This
+includes avoiding interactions in community spaces as well as external channels
+like social media. Violating these terms may lead to a temporary or
+permanent ban.
+
+### 3. Temporary Ban
+
+**Community Impact**: A serious violation of community standards, including
+sustained inappropriate behavior.
+
+**Consequence**: A temporary ban from any sort of interaction or public
+communication with the community for a specified period of time. No public or
+private interaction with the people involved, including unsolicited interaction
+with those enforcing the Code of Conduct, is allowed during this period.
+Violating these terms may lead to a permanent ban.
+
+### 4. Permanent Ban
+
+**Community Impact**: Demonstrating a pattern of violation of community
+standards, including sustained inappropriate behavior,  harassment of an
+individual, or aggression toward or disparagement of classes of individuals.
+
+**Consequence**: A permanent ban from any sort of public interaction within
+the community.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 2.1, available at
+[https://www.contributor-covenant.org/version/2/1/code_of_conduct.html][v2.1].
+
+Community Impact Guidelines were inspired by
+[Mozilla's code of conduct enforcement ladder][Mozilla CoC].
+
+For answers to common questions about this code of conduct, see the FAQ at
+[https://www.contributor-covenant.org/faq][FAQ]. Translations are available
+at [https://www.contributor-covenant.org/translations][translations].
+
+[homepage]: https://www.contributor-covenant.org
+[v2.1]: https://www.contributor-covenant.org/version/2/1/code_of_conduct.html
+[Mozilla CoC]: https://github.com/mozilla/diversity
+[FAQ]: https://www.contributor-covenant.org/faq
+[translations]: https://www.contributor-covenant.org/translations