jekyll-theme-zer0 0.22.5 → 0.22.19

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: eac91220efeb718a11a68d175f397e3bdf908d3864d7d25aaf0bc7ed12ab9221
-  data.tar.gz: d14789dfa2b994ddf8e710293df339868efa0f76717eafeef872eb8ed38b2724
+  metadata.gz: ba91ba02a96ff1b026fe82adedbebd79b476a48bc3534ff7b1799ebbf9e593d7
+  data.tar.gz: 4d1470d33ae3e6d41def0fbd22e05c07bf9597efa9f5c5e655f3dd61088896a4
 SHA512:
-  metadata.gz: dac3337f672daa444e6994c53ef642ae0d6d9d90084743b2f8164ecfbb357c741caf4de88546af9747b22b6b2d37ba0fba26809f6ec2585010adbf260c16c5e0
-  data.tar.gz: 32e504a5639fc44a4e400e97f1c02d723f4c7ca40881b5e1b0aeec8da19feae343c11acdcc751d51d41fe2b3462fab13e9b0a0ac23f95f016a3cc47013a522e2
+  metadata.gz: f643278addd297e92c075dc79f9802daf61bc9ca2bb4c5cde4dec6842da25895e0c9ea75f597cdc718fbc5dcc4b078f752f3e32ae310b3ca884d9fd82fc1c1d9
+  data.tar.gz: e2318d7d03c184b9a053d59c2130b818486d1cb20ce6938ec38e88e0b2459bee62108abfa223941857e4707f32313b5fefa5bef01682c4800f3a9c25f112159f

data/CHANGELOG.md

@@ -1,5 +1,192 @@
 # Changelog
 
+## [0.22.19] - 2026-04-18
+
+### Changed
+- Version bump: patch release
+
+### Commits in this release
+- 1b3993e docs(fork): add fork-to-deploy workflow and user site guidance (#56)
+
+
+## [Unreleased]
+
+### Added
+- **Docs**: `docs/FORKING.md` — progressive fork → configure → personalize workflow for the `username.github.io` user-site pattern
+- **Tests**: `test/test_fork_cleanup.sh` — 32-assertion suite covering CLI parsing, dry-run, real cleanup, YAML anchor preservation, and idempotency
+
+### Changed
+- **Landing page**: `_includes/landing/landing-install-cards.html` — “Fork & Deploy” card now guides users to fork into `<username>.github.io` and run `scripts/fork-cleanup.sh`; safer `github_fork` URL handling
+- **README**: `README.md` — Method 3 (Fork & Customize) reframed as “Fork & Deploy as Your Site” with a 4-step path; deployment section updated for user-site flow
+- **Docs**: `pages/_quickstart/github-setup.md`, `pages/_quickstart/index.md`, `pages/_docs/getting-started/quick-start.md`, `pages/_docs/deployment/github-pages.md`, `docs/configuration/url-configuration-guide.md` — aligned with the user-site fork pattern (`baseurl: ""`)
+- **Templates**: `templates/cleanup/reset-fields.yml` — annotated `baseurl` reasoning; clarified user-site vs. project-site behavior
+- **Templates**: `templates/config/install.conf` — minor consistency tweaks
+
+### Fixed
+- **Fork cleanup**: `scripts/fork-cleanup.sh` — `get_reset_field_value()` now uses `YAML.safe_load_file(..., aliases: true)` so anchors in `reset-fields.yml` no longer break parsing under newer Ruby
+- **Fork cleanup**: `scripts/fork-cleanup.sh` — repository name derivation now strips `.git` suffix and falls back gracefully when `origin` is missing (no `set -euo pipefail` aborts)
+- **Fork cleanup**: `scripts/fork-cleanup.sh` — `posthog`/`giscus` blocks reset only within their own YAML range (no stray matches in unrelated blocks)
+- **Welcome post**: `templates/pages/welcome-post.md.template` and embedded fallback in `scripts/fork-cleanup.sh` — corrected `layout: journals` → `layout: article` so the generated welcome post builds without “Layout does not exist” warnings on a freshly cleaned fork
+
+## [0.22.18] - 2026-04-18
+
+### Changed
+- Version bump: patch release
+
+### Commits in this release
+- 02d0295 feat(setup): add site configuration detection and smart 404 page (#58)
+
+
+## [0.22.17] - 2026-04-18
+
+### Changed
+- Version bump: patch release
+
+### Commits in this release
+- 10ba722 Add config-driven frontmatter validation system with review fixes (#34)
+
+
+## [0.22.16] - 2026-04-18
+
+### Changed
+- Version bump: patch release
+
+### Commits in this release
+- bc41b0d Add AGENTS.md and refresh stale agent instructions (#70)
+
+
+## [0.22.15] - 2026-04-18
+
+### Changed
+- Version bump: patch release
+
+### Commits in this release
+- 939af77 feat(nav): dynamic collection-based navigation fallback for zero-config sites (#64)
+- ca7da2e docs: align project documentation with v0.22.13 (#66)
+- 9b23b63 chore(deps-dev): bump dompurify from 3.3.3 to 3.4.0 (#68)
+
+
+## [0.22.14] - 2026-04-18
+
+### Changed
+- Version bump: patch release
+
+### Commits in this release
+- f0a1cac fix: correct comments for clarity in SEO-related files
+- d1998ff chore(deps): update Ruby gem dependencies (#67)
+
+
+## [0.22.13] - 2026-04-10
+
+### Changed
+- Version bump: patch release
+
+### Commits in this release
+- 3c00a3d refactor: remove duplicate code — use standard libraries and existing plugins (#59)
+
+
+## [0.22.12] - 2026-04-10
+
+### Changed
+- Version bump: patch release
+
+### Commits in this release
+- 7ba0f83 feat(news): add data-driven feature showcase & live Bootstrap components to news index (#54)
+
+
+## [0.22.11] - 2026-04-09
+
+### Changed
+- Version bump: patch release
+
+### Commits in this release
+- 8e83a51 Create SECURITY.md for security policy and reporting
+
+
+## [0.22.10] - 2026-04-06
+
+### Changed
+- Version bump: patch release
+
+### Commits in this release
+- 27550da feat(admin): add admin layout and configuration dashboards (#57)
+
+
+## [0.22.9] - 2026-04-05
+
+### Added
+- **Skin Editor**: New colorffy-inspired skin editor (`assets/js/skin-editor.js`) for creating and customizing theme skins from the browser
+  - Edit all 9 built-in skin gradient colors with live color pickers
+  - Auto-generated palettes: primary tints, surface, tonal surface, semantic colors (success/warning/danger/info)
+  - WCAG contrast ratio badges on all palette swatches
+  - Random skin generation, save/load custom skins to localStorage
+  - Export SVGs and copy CSS custom properties to clipboard
+  - Advanced SVG filter controls (turbulence, octaves, seed, scale, overlay opacity)
+- **Palette Generator**: New standalone palette generator (`assets/js/palette-generator.js`) with chroma.js-powered color mixing and live CSS variable editor
+- **Playwright Tests**: 12 new visual regression test specs (skins, backgrounds, accessibility, admin layout, config editor/viewer, env dashboard, security, theme colors)
+
+### Fixed
+- **Skin Rendering**: Added `.zer0-bg-hero` class to landing layout to prevent Bootstrap `.bg-primary` from overriding skin background gradients
+- **CSS Scoping**: Added `.bg-primary:not(.zer0-bg-hero)` in custom SCSS to isolate skin backgrounds from Bootstrap utility classes
+
+### Changed
+- **Theme Customizer**: Expanded to 6 tabs — added Skin Editor between Skins and Palette Generator
+- **Admin Navigation**: Minor layout adjustment
+- **Environment Dashboard**: Minor component update
+
+## [0.22.8] - 2026-04-04
+
+### Changed
+- Version bump: patch release
+
+### Commits in this release
+- e0b4f13 fix: cross-platform installation compatibility — Gemfile platform sections, fork mode tests, portable sed replacements (#55)
+
+
+## [0.22.7] - 2026-04-03
+
+### Changed
+- Version bump: patch release
+
+### Commits in this release
+- a70ae8a chore: consolidate configuration, dependencies, and installation (PRs #48, #51, #52, #53) (#51)
+
+
+## [Unreleased] — Universal Installer
+
+### Added
+- **Installer**: New `--remote` install mode — forks repo and creates an orphan `gh-pages` branch with only the bare minimum files needed to render via `remote_theme` (no local theme source)
+- **Installer**: New `--github` install mode — interactive fork via `gh` CLI with automatic platform detection and setup
+- **Installer**: New `--codespaces` flag — adds `.devcontainer/devcontainer.json` for GitHub Codespaces support (auto-included in remote mode, opt-in for full/minimal)
+- **Installer**: Cross-platform setup scripts: `scripts/platform/setup-macos.sh`, `setup-linux.sh`, `setup-wsl.sh`
+- **Installer**: GitHub CLI fork/clone helper: `scripts/github-setup.sh`
+- **Installer**: Platform auto-detection (`detect_platform()`) for macOS, Linux, and WSL
+- **Templates**: `_config.remote.yml.template` — minimal config for remote-theme consumer sites
+- **Templates**: `_config.starter.yml.template` — heavily annotated full starter config
+- **Templates**: `Gemfile.remote.template` — minimal Gemfile (github-pages + jekyll-remote-theme)
+- **Templates**: `devcontainer.json.template` — lightweight devcontainer for consumer sites
+- **Templates**: `theming.md.template` — Bootstrap 5 customization guide (dark mode, typography, layouts)
+- **Templates**: `setup.html.template` — dev-only setup wizard page
+- **Wizard**: Interactive browser-based config wizard (`pages/setup.html`, `_includes/setup/wizard.html`, `assets/js/setup-wizard.js`) for generating `_config.yml` via a 5-step Bootstrap form
+- **CI**: `.github/workflows/setup-template.yml` — auto-detects non-upstream repos and creates PR with prefilled config
+
+### Changed
+- **Installer**: `install.sh` — added `--remote`, `--github`, `--codespaces` flags and corresponding mode dispatchers
+- **Installer**: `render_template()` now substitutes `REPOSITORY_NAME`, `RAW_GITHUB_URL`, `FORK_GITHUB_USER` variables
+- **Installer**: `install.conf` — added `remote` and `github` to `VALID_INSTALL_MODES`, platform detection vars, wizard config, expanded `TEMPLATE_VARS`
+- **Templates**: `quickstart.md.template` — enhanced with Bootstrap pill tabs for macOS/Linux/WSL/GitHub Fork platform-specific instructions
+- **Templates**: `configuration.md.template` — comprehensive rewrite with URL tables, all config sections, cookie consent, dev config
+- **Templates**: `welcome-post.md.template` — enhanced Day 1 tutorial with folder structure diagram, commands table, feature checklist
+
+## [0.22.6] - 2026-04-03
+
+### Changed
+- Version bump: patch release
+
+### Commits in this release
+- 0117620 chore(ci): streamline CI workflows with path-based change detection - Bump version to 0.22.5
+
+
 ## [0.22.5] - 2026-04-03
 
 ### Changed

data/README.md

@@ -2,7 +2,7 @@
 title: zer0-mistakes
 sub-title: Jekyll Theme
 description: GitHub Pages compatible Jekyll theme with Bootstrap 5.3, featuring automated installation and comprehensive documentation.
-version: 0.22.4
+version: 0.22.19
 layout: landing
 tags:
   - jekyll
@@ -14,7 +14,7 @@ categories:
   - docker
   - bootstrap
 created: 2024-02-10T23:51:11.480Z
-lastmod: 2026-04-03T04:14:02.000Z
+lastmod: 2026-04-18T21:22:34.000Z
 draft: false
 permalink: /
 slug: zer0
@@ -402,14 +402,26 @@ plugins:
   - jekyll-remote-theme
 ```
 
-### Method 3: Fork & Customize
+### Method 3: Fork & Deploy as Your Site
+
+Fork into `<your-username>.github.io` for a working site in minutes:
+
+1. Go to [bamr87/zer0-mistakes](https://github.com/bamr87/zer0-mistakes) → **Fork**
+2. Set repository name to **`<your-username>.github.io`**
+3. Enable **Settings → Pages → Deploy from branch: `main`**
+4. Visit `https://<your-username>.github.io`
+
+Then personalize locally:
 
 ```bash
-gh repo fork bamr87/zer0-mistakes --clone
-cd zer0-mistakes
+git clone https://github.com/<your-username>/<your-username>.github.io.git
+cd <your-username>.github.io
+./scripts/fork-cleanup.sh   # interactive config wizard
 docker-compose up
 ```
 
+See [docs/FORKING.md](docs/FORKING.md) for the full progressive workflow.
+
 ### Method 4: Ruby Gem
 
 ```ruby
@@ -460,13 +472,47 @@ graph TD
 | `_includes/` | Reusable components | `core/`, `components/`, `analytics/`, `navigation/` |
 | `_sass/` | Stylesheets | `custom.scss`, `notebooks.scss`, `core/` (`_variables`, `_docs-layout`, …), `theme/` (`_css-variables`, `_wizard-mode`) |
 | `assets/` | Static files | `css/`, `js/`, `images/`, **`vendor/`** (Bootstrap, jQuery, MathJax, Mermaid, … — committed for GitHub Pages) |
-| `scripts/` | Automation | `release`, `build`, `vendor-install.sh`, `convert-notebooks.sh` |
+| `scripts/` | Automation | `release`, `build`, `migrate.sh`, `vendor-install.sh`, `convert-notebooks.sh` |
+| `templates/` | Installable templates | `pages/admin/` (6 admin page templates), `config/install.conf` |
 | `docs/` | Technical docs | `SIDEBAR_IMPROVEMENTS.md`, `JUPYTER_NOTEBOOKS.md` |
 | `pages/` | Content pages | `privacy-policy.md`, `terms-of-service.md` |
 
 ---
 
-## 🔄 Development Workflow
+## �️ Migration Utility
+
+Add the admin settings UI to an existing consumer site using the migration script:
+
+```bash
+# From the zer0-mistakes repo — install into another site
+./scripts/migrate.sh /path/to/your-site
+
+# Preview without making changes
+./scripts/migrate.sh --dry-run /path/to/your-site
+
+# Overwrite existing admin pages
+./scripts/migrate.sh --force /path/to/your-site
+
+# Verify an existing installation
+./scripts/migrate.sh --verify /path/to/your-site
+```
+
+This installs 6 admin pages to `pages/_about/settings/`:
+
+| Page | URL | Description |
+|------|-----|-------------|
+| Theme Customizer | `/about/settings/theme/` | Skins, palette generator, skin editor, live preview, color editing, YAML export |
+| Configuration | `/about/config/` | View/edit `_config.yml`, quick actions, environment info |
+| Navigation Editor | `/about/settings/navigation/` | Edit header/footer/sidebar menus, export YAML |
+| Collection Manager | `/about/settings/collections/` | Browse and manage Jekyll collections |
+| Analytics | `/about/settings/analytics/` | Site analytics and performance metrics |
+| Environment | `/about/settings/environment/` | Jekyll build info and environment details |
+
+> **Note:** Admin pages require theme version ≥ 0.22.10 for the `admin` layout and component includes.
+
+---
+
+## �🔄 Development Workflow
 
 ```mermaid
 gitGraph
@@ -528,26 +574,27 @@ npm run vendor:install    # manifest downloads (+ Mermaid copy when node_modules
 
 ## 🚀 Deployment
 
-### GitHub Pages (Automatic)
+### GitHub Pages (User Site — Recommended)
+
+Fork the repo as `<your-username>.github.io` and enable GitHub Pages:
+
+1. Push to `main` branch
+2. GitHub Pages builds automatically
+3. Site deploys to `https://<your-username>.github.io`
+
+No workflows or `baseurl` configuration needed. See [docs/FORKING.md](docs/FORKING.md) for details.
 
 ```mermaid
 sequenceDiagram
     participant Dev as Developer
     participant GH as GitHub
-    participant Actions as GitHub Actions
     participant Pages as GitHub Pages
     
     Dev->>GH: git push main
-    GH->>Actions: Trigger workflow
-    Actions->>Actions: jekyll build
-    Actions->>Pages: Deploy _site/
-    Pages-->>Dev: 🌐 Site live!
+    GH->>Pages: Auto-build Jekyll
+    Pages-->>Dev: 🌐 Site live at username.github.io
 ```
 
-1. Push to `main` branch
-2. GitHub Actions builds automatically
-3. Site deploys to GitHub Pages
-
 ### Docker Production
 
 ```bash
@@ -742,7 +789,7 @@ git push origin feature/awesome-feature
 
 | Metric | Value |
 |--------|-------|
-| **Current Version** | 0.22.4 ([RubyGems](https://rubygems.org/gems/jekyll-theme-zer0), [CHANGELOG](/CHANGELOG)) |
+| **Current Version** | 0.22.19 ([RubyGems](https://rubygems.org/gems/jekyll-theme-zer0), [CHANGELOG](/CHANGELOG)) |
 | **Documented Features** | 43 ([Feature Registry](https://github.com/bamr87/zer0-mistakes/blob/main/_data/features.yml)) |
 | **Setup Time** | 2-5 minutes ([install.sh benchmarks](https://github.com/bamr87/zer0-mistakes/blob/main/install.sh)) |
 | **Documentation Pages** | 70+ ([browse docs](/pages/)) |
@@ -785,6 +832,6 @@ Built with these amazing technologies:
 
 **Built with ❤️ for the Jekyll community**
 
-**v0.22.4** • [Changelog](CHANGELOG.md) • [License](LICENSE) • [Contributing](CONTRIBUTING.md)
+**v0.22.19** • [Changelog](CHANGELOG.md) • [License](LICENSE) • [Contributing](CONTRIBUTING.md)
 
 

data/_data/navigation/admin.yml

@@ -0,0 +1,53 @@
+# Admin Navigation Configuration
+# Used by: _includes/navigation/admin-nav.html
+# Purpose: Data-driven sidebar navigation for admin/settings pages
+# Schema: title, url, icon, description, badge (optional), external (optional)
+
+# ── Admin Pages ──────────────────────────────────────────────────
+
+- title: Configuration
+  url: /about/config/
+  icon: bi-gear
+  description: View and export site configuration
+
+- title: Statistics
+  url: /about/stats/
+  icon: bi-bar-chart-line
+  description: Content analytics and metrics
+
+- title: Theme Customizer
+  url: /about/settings/theme/
+  icon: bi-palette
+  description: Skin, colors, and typography
+
+- title: Navigation Editor
+  url: /about/settings/navigation/
+  icon: bi-signpost-2
+  description: Menu structure and links
+
+- title: Collection Manager
+  url: /about/settings/collections/
+  icon: bi-collection
+  description: Jekyll collections overview
+
+- title: Analytics Dashboard
+  url: /about/settings/analytics/
+  icon: bi-graph-up
+  description: PostHog and tracking settings
+
+- title: Environment & Build
+  url: /about/settings/environment/
+  icon: bi-hdd-network
+  description: Jekyll, Ruby, and build info
+
+# ── External Links ───────────────────────────────────────────────
+
+- title: Repository
+  url: https://github.com/{github_user}/{repository_name}
+  icon: bi-github
+  external: true
+
+- title: Jekyll Docs
+  url: https://jekyllrb.com/docs/configuration/
+  icon: bi-book
+  external: true

data/_data/theme_backgrounds.yml

@@ -0,0 +1,121 @@
+# Theme Background Presets
+# Maps each skin to gradient, pattern, and noise texture assets.
+# Generated using fffuel.co tools: ffflux (gradients), rrrepeat (patterns), nnnoise (noise).
+# See: https://www.fffuel.co
+#
+# Zones define where backgrounds are applied:
+#   hero    — header/hero banner area
+#   body    — page body subtle texture overlay
+#   surface — cards, sidebars, panels
+#   footer  — footer area
+
+defaults:
+  texture_opacity: 0.04
+  blend_mode: overlay
+  gradient_opacity: 0.6
+  pattern_opacity: 0.08
+
+zones:
+  hero:
+    layer: gradient
+    fallback_color: var(--bs-body-bg)
+  body:
+    layer: noise
+    fallback_color: var(--bs-body-bg)
+  surface:
+    layer: pattern
+    fallback_color: var(--bs-tertiary-bg)
+  footer:
+    layer: noise
+    fallback_color: var(--bs-body-bg)
+
+skins:
+  air:
+    label: "Air"
+    colors:
+      primary: "#e8f4f8"
+      secondary: "#b8d4e3"
+      accent: "#6fa8dc"
+    gradient: "assets/backgrounds/gradients/air.svg"
+    pattern: "assets/backgrounds/patterns/air.svg"
+    noise: "assets/backgrounds/noise/air.svg"
+
+  aqua:
+    label: "Aqua"
+    colors:
+      primary: "#0077b6"
+      secondary: "#00b4d8"
+      accent: "#90e0ef"
+    gradient: "assets/backgrounds/gradients/aqua.svg"
+    pattern: "assets/backgrounds/patterns/aqua.svg"
+    noise: "assets/backgrounds/noise/aqua.svg"
+
+  contrast:
+    label: "Contrast"
+    colors:
+      primary: "#000000"
+      secondary: "#ffffff"
+      accent: "#ffcc00"
+    gradient: "assets/backgrounds/gradients/contrast.svg"
+    pattern: "assets/backgrounds/patterns/contrast.svg"
+    noise: "assets/backgrounds/noise/contrast.svg"
+
+  dark:
+    label: "Dark"
+    colors:
+      primary: "#1a1a2e"
+      secondary: "#16213e"
+      accent: "#0f3460"
+    gradient: "assets/backgrounds/gradients/dark.svg"
+    pattern: "assets/backgrounds/patterns/dark.svg"
+    noise: "assets/backgrounds/noise/dark.svg"
+
+  dirt:
+    label: "Dirt"
+    colors:
+      primary: "#5c4033"
+      secondary: "#8b6914"
+      accent: "#d4a574"
+    gradient: "assets/backgrounds/gradients/dirt.svg"
+    pattern: "assets/backgrounds/patterns/dirt.svg"
+    noise: "assets/backgrounds/noise/dirt.svg"
+
+  neon:
+    label: "Neon"
+    colors:
+      primary: "#ff006e"
+      secondary: "#8338ec"
+      accent: "#3a86ff"
+    gradient: "assets/backgrounds/gradients/neon.svg"
+    pattern: "assets/backgrounds/patterns/neon.svg"
+    noise: "assets/backgrounds/noise/neon.svg"
+
+  mint:
+    label: "Mint"
+    colors:
+      primary: "#2d6a4f"
+      secondary: "#52b788"
+      accent: "#95d5b2"
+    gradient: "assets/backgrounds/gradients/mint.svg"
+    pattern: "assets/backgrounds/patterns/mint.svg"
+    noise: "assets/backgrounds/noise/mint.svg"
+
+  plum:
+    label: "Plum"
+    colors:
+      primary: "#4a0e4e"
+      secondary: "#812f85"
+      accent: "#c77dff"
+    gradient: "assets/backgrounds/gradients/plum.svg"
+    pattern: "assets/backgrounds/patterns/plum.svg"
+    noise: "assets/backgrounds/noise/plum.svg"
+
+  sunrise:
+    label: "Sunrise"
+    colors:
+      primary: "#ff6b35"
+      secondary: "#f7c59f"
+      accent: "#efefd0"
+    gradient: "assets/backgrounds/gradients/sunrise.svg"
+    pattern: "assets/backgrounds/patterns/sunrise.svg"
+    noise: "assets/backgrounds/noise/sunrise.svg"

data/_includes/components/admin-tabs.html

@@ -0,0 +1,59 @@
+<!--
+  ===================================================================
+  ADMIN TABS — Reusable tabbed interface for admin pages
+  ===================================================================
+
+  File: admin-tabs.html
+  Path: _includes/components/admin-tabs.html
+  Purpose: Renders a Bootstrap 5 tabbed interface from structured
+           parameters. Each admin page can define its own tabs via
+           the include parameter or front matter.
+
+  Parameters (via include):
+    tabs  - A string of tab definitions, pipe-separated:
+            "id:label:icon:active" per tab
+            e.g., "view:View Config:bi-eye:true|edit:Edit:bi-pencil:false"
+    id    - Unique prefix for this tab group (default: "admin")
+
+  Usage:
+    {% include components/admin-tabs.html
+       id="config"
+       tabs="view:View Config:bi-eye:true|edit:Edit & Export:bi-pencil-square:false|raw:Raw YAML:bi-file-earmark-code:false"
+    %}
+    <div class="tab-content pt-4" id="configTabContent">
+      <div class="tab-pane fade show active" id="pane-view" role="tabpanel">
+        ... content ...
+      </div>
+    </div>
+
+  Dependencies: Bootstrap 5 tab/nav components, Bootstrap Icons
+  Used by: Admin pages (config.md, theme.md, navigation.md, etc.)
+  ===================================================================
+-->
+
+{% assign tab_prefix = include.id | default: "admin" %}
+{% assign tab_list = include.tabs | split: "|" %}
+
+<ul class="nav nav-tabs" id="{{ tab_prefix }}Tabs" role="tablist">
+  {% for tab_def in tab_list %}
+    {% assign parts = tab_def | split: ":" %}
+    {% assign tab_id = parts[0] %}
+    {% assign tab_label = parts[1] %}
+    {% assign tab_icon = parts[2] %}
+    {% assign tab_active = parts[3] %}
+
+    <li class="nav-item" role="presentation">
+      <button class="nav-link{% if tab_active == 'true' %} active{% endif %}"
+              id="tab-{{ tab_id }}"
+              data-bs-toggle="tab"
+              data-bs-target="#pane-{{ tab_id }}"
+              type="button"
+              role="tab"
+              aria-controls="pane-{{ tab_id }}"
+              aria-selected="{{ tab_active | default: 'false' }}">
+        {% if tab_icon %}<i class="{{ tab_icon }} me-1"></i>{% endif %}
+        {{ tab_label }}
+      </button>
+    </li>
+  {% endfor %}
+</ul>