create-berna-stencil 2.5.0 → 2.6.0

package/.eleventy.js

@@ -87,7 +87,7 @@ module.exports = function (eleventyConfig) {
       input: "src/frontend",
       output: OUTPUT_DIR,
       includes: "components",
-      layouts: "components/layouts",
+      layouts: "layouts",
       data: "data",
     },
   };

package/README.md

@@ -1,18 +1,22 @@
 # ✏️ Berna-Stencil
 **Berna-Stencil** is an open source static site generator built on top of [Eleventy](https://www.11ty.dev/), designed with one clear mission: make web development simple, approachable, and enjoyable — for everyone.
 
+Berna-Stencil stays deliberately close to plain, vanilla web development — you work with real HTML, CSS, and JavaScript, not a heavy abstraction layer to learn first. That means a gentle, fast learning curve: the skills you build here are the same ones you'd use anywhere on the web.
+
 Whether you're a seasoned developer looking for a clean starting point or a beginner taking your first steps into the world of web creation, Berna-Stencil gives you everything you need, right out of the box. No complicated setup, no hours spent reading documentation, no frustration — just a solid, well-structured foundation ready to become your next website.
 
 ### ✨ Why Berna-Stencil?
 
 Building a website from scratch involves a lot of moving parts: templating engines, build pipelines, asset management, backend logic, project structure. Berna-Stencil takes care of all of that for you, so you can focus on what actually matters — **your content and your ideas**.
 
+Because it keeps you close to the fundamentals instead of hiding them, you spend your time actually learning the web — not memorizing a framework's conventions that stop being useful the moment you switch tool.
+
 - 🔧 **Zero-config ready** — clone, install, and you're live in minutes
 - 🔗 **Integrated backend** — essential server-side functionality included, no extra setup required
 - 📁 **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.5.0-blue)
+![Version](https://img.shields.io/badge/version-2.6.0-blue)
 ![License](https://img.shields.io/badge/license-Apache--2.0-blue)
 ![Eleventy](https://img.shields.io/badge/11ty-v3.1.2-black)
 

package/_tools/modules/updateIncludes.js

@@ -1,17 +1,17 @@
 const fileSystem = require('fs');
 const { toCamelCase } = require('./utils');
 
-const INCLUDES_PATH = 'src/frontend/components/layouts/includes.njk';
+const PAGE_COMPONENTS_PATH = 'src/frontend/layouts/pageComponents.njk';
 
 // --- Helpers ---
 
 function readIncludes() {
-    if (!fileSystem.existsSync(INCLUDES_PATH)) return null;
-    return fileSystem.readFileSync(INCLUDES_PATH, 'utf8');
+    if (!fileSystem.existsSync(PAGE_COMPONENTS_PATH)) return null;
+    return fileSystem.readFileSync(PAGE_COMPONENTS_PATH, 'utf8');
 }
 
 function writeIncludes(content) {
-    fileSystem.writeFileSync(INCLUDES_PATH, content);
+    fileSystem.writeFileSync(PAGE_COMPONENTS_PATH, content);
 }
 
 function buildElifRegex(camelName) {
@@ -32,7 +32,7 @@ function addLayout(pageName) {
 
     const newElif =
         `{% elif title == "${camelName}" %}\n` +
-        `  {# Insert your includes under this page #}\n` +
+        `  {# Insert your components under this page #}\n` +
         `  {#{% include "component.njk" %}#}\n\n`;
 
     writeIncludes(content.replace('{% else %}', `${newElif}{% else %}`));

package/_tools/res/templates/template.njk

@@ -1,9 +1,9 @@
 ---
 title: ""
 permalink: ""
-layout: includes.njk
+layout: pageComponents.njk
 ---
 
 <!-- !IMPORTANT -->
 <!-- DO NOT ADD ANYTHING HERE -->
-<!-- You should create a new component.njk into src/frontend/components and include that in components/layouts/includes.njk -->
+<!-- You should create a new component.njk into src/frontend and include that in layouts/pageComponents.njk -->

package/bin/create.js

@@ -121,7 +121,7 @@ src/backend/config.php
 
 const PROJECT_PACKAGE = {
     name:      path.basename(targetDir),
-    version:   '2.5.0',
+    version:   '2.6.0',
     private:   true,
     outputDir: 'out',
     "scripts": {
@@ -226,7 +226,7 @@ function applyFramework(framework) {
         fs.writeFileSync(globalScssPath, content);
     }
 
-    const baseNjkPath = path.join(targetDir, 'src/frontend/components/layouts/base.njk');
+    const baseNjkPath = path.join(targetDir, 'src/frontend/layouts/base.njk');
     if (fs.existsSync(baseNjkPath)) {
         let content = fs.readFileSync(baseNjkPath, 'utf8');
         ALL_FRAMEWORKS.forEach(fw => {

package/docs/Assistant CLI.md

@@ -31,7 +31,7 @@ For a page named `my-page`, the following files are created:
 | `src/frontend/js/pages/myPage.js` | JS entry point |
 | `src/frontend/_routes/my-page.njk` | Nunjucks template |
 
-It also adds an `elif` block in `includes.njk` and a stub entry in `site.json`:
+It also adds an `elif` block in `pageComponents.njk` and a stub entry in `site.json`:
 
 ```json
 "myPage": {
@@ -48,11 +48,11 @@ It also adds an `elif` block in `includes.njk` and a stub entry in `site.json`:
 
 ## Remove page
 
-Deletes all source files for the page and cleans up the output directory, `includes.njk`, and `site.json`.
+Deletes all source files for the page and cleans up the output directory, `pageComponents.njk`, and `site.json`.
 
 ## Rename page
 
-Renames all three source files, updates the `elif` block in `includes.njk`, and renames the record in `site.json` while preserving all existing fields.
+Renames all three source files, updates the `elif` block in `pageComponents.njk`, and renames the record in `site.json` while preserving all existing fields.
 
 ## Configure output path
 

package/docs/Components.md

@@ -19,9 +19,9 @@ src/frontend/components/
 
 ## Include a component
 
-To render a component inside a page, navigate to `src/frontend/components/layouts/` and edit `includes.njk`
+To render a component inside a page, navigate to `src/frontend/layouts/` and edit `pageComponents.njk`
 
-### includes.njk <small>(`src/frontend/components/layouts/`)</small>
+### pageComponents.njk <small>(`src/frontend/layouts/`)</small>
 
 ```js
 {% if title == "homepage" %}
@@ -41,7 +41,7 @@ Add a new `{% elif %}` block for each page, listing its components in order. If
 
 > ⚠️ A new `elif` block is automatically added when you create a page via the Assistant CLI
 
-> ⚠️ If you move or delete a component, always update `includes.njk` or the site will break
+> ⚠️ If you move or delete a component, always update `pageComponents.njk` or the site will break
 
 ### Using Markdown files in components
 
@@ -75,7 +75,7 @@ Header and footer live in `src/frontend/components/global/` and are automaticall
 
 ## Site data in components
 
-All values defined in `src/data/site.json` are globally available in every component via `{{ site.* }}`
+All values defined in `src/frontend/data/site.json` are globally available in every component via `{{ site.* }}`
 
 ### site.json <small>(`src/data/`)</small>
 ```json

package/docs/Creating pages.md

@@ -9,14 +9,14 @@ For a page named `my-page`:
 
 | File | Purpose |
 |---|---|
-| `src/frontend/pages/my-page.njk` | Template with front matter |
+| `src/frontend/_routes_/my-page.njk` | Template with front matter |
 | `src/frontend/scss/pages/myPage.scss` | Imports framework + modules |
 | `src/frontend/js/pages/myPage.js` | Imports JS modules |
 
 ## Adding content
 
 1. Create a component in `src/frontend/components/` (e.g. `_myPage.njk`)
-2. Include it in `src/frontend/components/layouts/includes.njk` inside the generated `elif` block:
+2. Include it in `src/frontend/layouts/pageComponents.njk` inside the generated `elif` block:
 
 ```njk
 {% elif title == "myPage" %}
@@ -37,7 +37,7 @@ To create a URL like `domain.it/about/team`, edit the `permalink` in `src/fronte
 ---
 title: "team"
 permalink: "about/team/"
-layout: includes.njk
+layout: pageComponents.njk
 ---
 ```
 

package/docs/Styling with SCSS.md

@@ -97,7 +97,7 @@ To enable/disable them you have to modify 3 files around the project by just com
 // @import "../modules/frameworks/uikit";
 ```
 
-### 2. base.njk <small>(`src/frontend/components/layouts/`)</small>
+### 2. base.njk <small>(`src/frontend/layouts/`)</small>
 
 ```html
 {# Bootstrap JS #}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-berna-stencil",
-  "version": "2.5.0",
+  "version": "2.6.0",
   "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",

package/src/frontend/index.njk

@@ -1,9 +1,9 @@
 ---
 title: homepage
 permalink: /
-layout: includes.njk
+layout: pageComponents.njk
 ---
 
 <!-- !IMPORTANT -->
 <!-- DO NOT ADD ANYTHING HERE -->
-<!-- You should create a new component.njk into src/components and include that in components/layouts/includes.njk -->
+<!-- You should create a new component.njk into src/components and include that in layouts/pageComponents.njk -->

package/src/frontend/{components/layouts → layouts}/base.njk

@@ -43,7 +43,7 @@
         <meta name="twitter:image" content="{{ site.url }}{{ site.logo }}">
 
       {#╔══════════════════════════════════════════╗
-        ║   JSON-LD — Structured data for SEO/AI  ║
+        ║   JSON-LD — Structured data for SEO/AI   ║
         ╚══════════════════════════════════════════╝#}
 
         <script type="application/ld+json">