create-berna-stencil 2.3.0 → 2.4.0

package/README.md

@@ -12,7 +12,7 @@ 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.3.0-blue)
+![Version](https://img.shields.io/badge/version-2.4.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/bin/create.js

@@ -120,7 +120,7 @@ src/backend/config.php
 
 const PROJECT_PACKAGE = {
     name:      path.basename(targetDir),
-    version:   '2.3.0',
+    version:   '2.4.0',
     private:   true,
     outputDir: 'out',
     "scripts": {

package/docs/Backend.md

@@ -1,5 +1,11 @@
 # Backend
 
+> **PHP requirement** — the backend runs only on servers with PHP support:
+> - **Apache** (shared hosting, VPS) ✅
+> - **Nginx** + PHP-FPM (VPS) ✅
+> - **IIS** + FastCGI (Windows Server) ✅
+> - **Static hosting** (Netlify, Vercel, GitHub Pages, Cloudflare Pages) ❌
+
 The backend is a PHP REST API located in `src/backend/`, copied to the output directory automatically at build time.
 
 ## Structure
@@ -30,9 +36,9 @@ return [
     'API_KEY' => 'default-key',
 
     // If you want restrict access to protected endpoints to specific clients, you can define custom keys for each endpoint
-    // For subfolder endpoints, use the relative path ('subfolder/endpoint')
     'ENDPOINT_KEYS' => [
-        'example-protected' => 'custom-key',
+    // For subfolder endpoints, use the relative path ('subfolder/endpoint')
+    // 'subfolder/endpoint'    => 'example-key',
     ],
 
     'DB_HOST' => '127.0.0.1',

package/docs/Deploy.md

@@ -0,0 +1,55 @@
+# Server Configuration
+
+Berna-Stencil includes ready-made server configuration for Apache and IIS. For Nginx, a reference config is provided in the project root.
+
+## Apache
+
+`.htaccess` files at `src/frontend/` and `src/backend/` are automatically copied to the build output by Eleventy. No additional setup required.
+
+Covers:
+- Directory listing disabled
+- 403 / 404 → `/404.html`
+- Sensitive files blocked (`web.config`, dotfiles, etc.)
+- `/api/*` → `backend/_core/index.php`
+- HTTPS redirect
+
+## IIS
+
+`web.config` files at `src/frontend/` and `src/backend/` are automatically copied to the build output by Eleventy. No additional setup required.
+
+Covers the same rules as the Apache configuration above.
+
+## Nginx
+
+Nginx does not support per-directory configuration files. The `nginx.conf` in the project root is a reference config that must be manually placed on the server.
+
+### Setup
+
+1. Copy `nginx.conf` to the server:
+```bash
+scp nginx.conf user@server:/etc/nginx/sites-available/your-site
+```
+
+2. Edit `server_name` and `root` to match your environment:
+```nginx
+server_name example.com;
+root /var/www/html/out;
+```
+
+3. Add your SSL certificate paths.
+
+4. Enable and reload:
+```bash
+ln -s /etc/nginx/sites-available/your-site /etc/nginx/sites-enabled/
+nginx -t && systemctl reload nginx
+```
+
+### PHP-FPM socket
+
+The default socket path in `nginx.conf` targets RHEL / Fedora systems. Adjust for your distro:
+
+| Distro | Path |
+|---|---|
+| RHEL / Fedora | `unix:/run/php-fpm/php-fpm.sock` |
+| Debian / Ubuntu | `unix:/run/php/php-fpm.sock` |
+| TCP fallback | `127.0.0.1:9000` |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-berna-stencil",
-  "version": "2.3.0",
+  "version": "2.4.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/backend/config.php

@@ -6,9 +6,9 @@ return [
     'API_KEY' => 'DEFAULT_KEY',
 
     // If you want restrict access to protected endpoints to specific clients, you can define custom keys for each endpoint
-    // For subfolder endpoints, use the relative path ('subfolder/endpoint')
     'ENDPOINT_KEYS' => [
-    'subfolder/example-protected'    => 'example-key',
+    // For subfolder endpoints, use the relative path ('subfolder/endpoint')
+    // 'subfolder/endpoint'    => 'example-key',
     ],
 
     // Database configuration

package/src/frontend/components/welcome.njk

@@ -35,6 +35,10 @@
       <input type="radio" name="guide-filter" value="backend" />
       <span class="filter-pill">Backend</span>
     </label>
+    <label>
+      <input type="radio" name="guide-filter" value="deploy" />
+      <span class="filter-pill">Deploy</span>
+    </label>
   </div>
 
   <div class="tabs-container">
@@ -90,6 +94,9 @@
     <div id="content-backend" class="tab-content markdown-body">
       {% mdFile "docs/backend.md" %}
     </div>
+    <div id="content-deploy" class="tab-content markdown-body">
+      {% mdFile "docs/deploy.md" %}
+    </div>
 
   </div>
 </div>