feat: unlock MokoCassiopeia + lock MokoOnyx during bridge migration

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

.gitattributes

@@ -0,0 +1,17 @@
+# Force LF line endings for all text files
+* text=auto eol=lf
+
+# Explicitly mark binary files
+*.png binary
+*.jpg binary
+*.jpeg binary
+*.gif binary
+*.ico binary
+*.svg text eol=lf
+*.woff binary
+*.woff2 binary
+*.ttf binary
+*.eot binary
+*.zip binary
+*.gz binary
+*.tar binary

.github/CLAUDE.md

@@ -115,38 +115,34 @@ BRIEF: One-line description
 
 **`README.md` is the single source of truth for the repository version.**
 
-- **Bump the patch version on every PR** — increment `XX.YY.ZZ` (e.g. `01.02.03` → `01.02.04`) in `README.md` before opening the PR; the `sync-version-on-merge` workflow propagates it automatically to all badges and `FILE INFORMATION` headers on merge to `main`.
+- **Patch version is auto-bumped by the release workflow** — `release.yml` reads the current version from `README.md`, increments the patch (`XX.YY.ZZ` → `XX.YY.(ZZ+1)`), updates `README.md`, `templateDetails.xml`, and the matching channel in `updates.xml`, commits, pushes, then builds the ZIP. Manual bumping is no longer required.
 - The `VERSION: XX.YY.ZZ` field in `README.md` governs all other version references.
 - Version format is zero-padded semver: `XX.YY.ZZ` (e.g. `01.02.03`).
 - Never hardcode a specific version in document body text — use the badge or FILE INFORMATION header only.
 
 ### Joomla Version Alignment
 
-The version in `README.md` **must always match** the `<version>` tag in `manifest.xml` and the latest entry in `updates.xml`. The `make release` command / release workflow updates all three automatically.
+The version in `README.md` **must always match** the `<version>` tag in `templateDetails.xml` and the matching channel entry in `updates.xml`. The release workflow updates all three automatically.
+
+### Multi-Channel updates.xml
+
+`updates.xml` contains separate `<update>` blocks per stability channel (development, alpha, beta, rc, stable). Each release workflow only modifies its own channel using targeted Python regex replacement — other channels are preserved untouched. Joomla filters by the user's "Minimum Stability" setting.
 
 ```xml
-<!-- In manifest.xml — must match README.md version -->
-<version>01.02.04</version>
-
-<!-- In updates.xml — prepend a new <update> block for every release.
-     Note: the backslash in version="4\.[0-9]+" is a literal backslash character
-     in the XML attribute value. Joomla's update server treats the value as a
-     regular expression, so \. matches a literal dot. -->
 <updates>
-	<update>
-		<name>{{EXTENSION_NAME}}</name>
-		<version>01.02.04</version>
-		<downloads>
-			<downloadurl type="full" format="zip">
-				https://git.mokoconsulting.tech/MokoConsulting/MokoCassiopeia/releases/download/01.02.04/{{EXTENSION_ELEMENT}}-01.02.04.zip
-			</downloadurl>
-		</downloads>
-		<targetplatform name="joomla" version="4\.[0-9]+" />
-	</update>
-	<!-- … older entries preserved below … -->
+  <!-- 1. DEVELOPMENT --> <update>...<tag>development</tag>...</update>
+  <!-- 2. ALPHA -->       <update>...<tag>alpha</tag>...</update>
+  <!-- 3. BETA -->        <update>...<tag>beta</tag>...</update>
+  <!-- 4. RC -->          <update>...<tag>rc</tag>...</update>
+  <!-- 5. STABLE -->      <update>...<tag>stable</tag>...</update>
 </updates>
 ```
 
+**Key rules:**
+- SHA-256 must be raw hex (no `sha256:` prefix)
+- Version format must be `XX.YY.ZZ`, not tag names like `v01`
+- Download URLs must point to Gitea (not GitHub) for all pre-release channels
+
 ---
 
 ## Joomla Extension Structure
@@ -286,11 +282,11 @@ Approved prefixes: `dev/` · `rc/` · `version/` · `patch/` · `copilot/` · `d
 | Change type | Documentation to update |
 |-------------|------------------------|
 | New or renamed PHP class/method | PHPDoc block; `docs/api/` entry |
-| New or changed manifest.xml | Update `updates.xml` version; bump README.md version |
-| New release | Prepend `<update>` block to `updates.xml`; update CHANGELOG.md; bump README.md version |
+| New or changed manifest.xml | Release workflow auto-bumps version across README.md, templateDetails.xml, and updates.xml |
+| New release | Trigger `release.yml` — auto-bumps patch, builds ZIP, updates matching channel in `updates.xml` |
 | New or changed workflow | `docs/workflows/<workflow-name>.md` |
 | Any modified file | Update the `VERSION` field in that file's `FILE INFORMATION` block |
-| **Every PR** | **Bump the patch version** — increment `XX.YY.ZZ` in `README.md`; `sync-version-on-merge` propagates it |
+| **Every release** | **Patch auto-bumped** by `release.yml` — no manual version bump needed |
 
 ---
 

.github/workflows/auto-assign.yml

@@ -2,12 +2,12 @@
 # SPDX-License-Identifier: GPL-3.0-or-later
 #
 # FILE INFORMATION
-# DEFGROUP: GitHub.Workflow
+# DEFGROUP: Gitea.Workflow
 # INGROUP: MokoStandards.Workflows.Shared
 # REPO: https://git.mokoconsulting.tech/MokoConsulting/MokoStandards
 # PATH: /.github/workflows/auto-assign.yml
 # VERSION: 04.06.00
-# BRIEF: Auto-assign jmiller-moko to unassigned issues and PRs every 15 minutes
+# BRIEF: Auto-assign jmiller to unassigned issues and PRs every 15 minutes
 
 name: Auto-Assign Issues & PRs
 
@@ -32,10 +32,10 @@ jobs:
     steps:
       - name: Assign unassigned issues
         env:
-          GH_TOKEN: ${{ secrets.GH_TOKEN || github.token }}
+          GH_TOKEN: ${{ secrets.GA_TOKEN || github.token }}
         run: |
           REPO="${{ github.repository }}"
-          ASSIGNEE="jmiller-moko"
+          ASSIGNEE="jmiller"
 
           echo "## 🏷️ Auto-Assign Report" >> $GITHUB_STEP_SUMMARY
           echo "" >> $GITHUB_STEP_SUMMARY
@@ -44,12 +44,12 @@ jobs:
           ASSIGNED_PRS=0
 
           # Assign unassigned open issues
-          ISSUES=$(gh api "repos/$REPO/issues?state=open&per_page=100&assignee=none" --jq '.[].number' 2>/dev/null || true)
+          ISSUES=$(curl -sf -H "Authorization: token ${{ secrets.GA_TOKEN }}" "${{GITEA_URL:-https://git.mokoconsulting.tech}}/api/v1/repos/${{ github.repository }}/issues?state=open&per_page=100&assignee=none" | jq -r '.[].number' 2>/dev/null || true)
           for NUM in $ISSUES; do
             # Skip PRs (the issues endpoint returns PRs too)
-            IS_PR=$(gh api "repos/$REPO/issues/$NUM" --jq '.pull_request // empty' 2>/dev/null || true)
+            IS_PR=$(curl -sf -H "Authorization: token ${{ secrets.GA_TOKEN }}" "${{GITEA_URL:-https://git.mokoconsulting.tech}}/api/v1/repos/${{ github.repository }}/issues/$NUM" | jq -r '.pull_request // empty' 2>/dev/null || true)
             if [ -z "$IS_PR" ]; then
-              gh api "repos/$REPO/issues/$NUM/assignees" -X POST -f "assignees[]=$ASSIGNEE" --silent 2>/dev/null && {
+              curl -sf -H "Authorization: token ${{ secrets.GA_TOKEN }}" "${{GITEA_URL:-https://git.mokoconsulting.tech}}/api/v1/repos/${{ github.repository }}/issues/$NUM/assignees" 2>/dev/null -X POST -f "assignees[]=$ASSIGNEE" --silent 2>/dev/null && {
                 ASSIGNED_ISSUES=$((ASSIGNED_ISSUES + 1))
                 echo "  Assigned issue #$NUM"
               } || true
@@ -57,9 +57,9 @@ jobs:
           done
 
           # Assign unassigned open PRs
-          PRS=$(gh api "repos/$REPO/pulls?state=open&per_page=100" --jq '.[] | select(.assignees | length == 0) | .number' 2>/dev/null || true)
+          PRS=$(curl -sf -H "Authorization: token ${{ secrets.GA_TOKEN }}" "${{GITEA_URL:-https://git.mokoconsulting.tech}}/api/v1/repos/${{ github.repository }}/pulls?state=open&per_page=100" | jq -r '.[] | select(.assignees | length == 0) | .number' 2>/dev/null || true)
           for NUM in $PRS; do
-            gh api "repos/$REPO/issues/$NUM/assignees" -X POST -f "assignees[]=$ASSIGNEE" --silent 2>/dev/null && {
+            curl -sf -H "Authorization: token ${{ secrets.GA_TOKEN }}" "${{GITEA_URL:-https://git.mokoconsulting.tech}}/api/v1/repos/${{ github.repository }}/issues/$NUM/assignees" 2>/dev/null -X POST -f "assignees[]=$ASSIGNEE" --silent 2>/dev/null && {
               ASSIGNED_PRS=$((ASSIGNED_PRS + 1))
               echo "  Assigned PR #$NUM"
             } || true

.github/workflows/auto-dev-issue.yml

@@ -5,7 +5,7 @@
 # SPDX-License-Identifier: GPL-3.0-or-later
 #
 # FILE INFORMATION
-# DEFGROUP: GitHub.Workflow
+# DEFGROUP: Gitea.Workflow
 # INGROUP: MokoStandards.Automation
 # REPO: https://git.mokoconsulting.tech/MokoConsulting/MokoStandards
 # PATH: /templates/workflows/shared/auto-dev-issue.yml.template
@@ -47,7 +47,7 @@ jobs:
     steps:
       - name: Create tracking issue and sub-issues
         env:
-          GH_TOKEN: ${{ secrets.GH_TOKEN || github.token }}
+          GH_TOKEN: ${{ secrets.GA_TOKEN || github.token }}
         run: |
           # For manual dispatch, use input; for auto, use event ref
           if [ "${{ github.event_name }}" = "workflow_dispatch" ]; then
@@ -85,8 +85,8 @@ jobs:
           TITLE="${TITLE_PREFIX}(${VERSION}): ${BRANCH_TYPE} tracking for ${BRANCH}"
 
           # Check for existing issue with same title prefix
-          EXISTING=$(gh api "repos/${REPO}/issues?state=open&per_page=10" \
-            --jq ".[] | select(.title | startswith(\"${TITLE_PREFIX}(${VERSION})\")) | .number" 2>/dev/null | head -1)
+          EXISTING=$(curl -sf -H "Authorization: token ${{ secrets.GA_TOKEN }}" "${{GITEA_URL:-https://git.mokoconsulting.tech}}/api/v1/repos/${{ github.repository }}/issues?state=open&per_page=10" 2>/dev/null \
+            | jq -r ".[] | select(.title | startswith(\"${TITLE_PREFIX}(${VERSION})\")) | .number" 2>/dev/null | head -1)
 
           if [ -n "$EXISTING" ]; then
             echo "ℹ️ Issue #${EXISTING} already exists for ${VERSION}" >> $GITHUB_STEP_SUMMARY
@@ -135,7 +135,7 @@ jobs:
               --title "$SUB_FULL_TITLE" \
               --body "$SUB_BODY" \
               --label "${SUB_LABELS}" \
-              --assignee "jmiller-moko" 2>&1)
+              --assignee "jmiller" 2>&1)
 
             SUB_NUM=$(echo "$SUB_URL" | grep -oE '[0-9]+$')
             if [ -n "$SUB_NUM" ]; then
@@ -154,7 +154,7 @@ jobs:
             --title "$TITLE" \
             --body "$PARENT_BODY" \
             --label "${LABEL_TYPE},version" \
-            --assignee "jmiller-moko" 2>&1)
+            --assignee "jmiller" 2>&1)
 
           PARENT_NUM=$(echo "$PARENT_URL" | grep -oE '[0-9]+$')
 
@@ -163,11 +163,11 @@ jobs:
             for SUB in "${SUB_ISSUES[@]}"; do
               IFS='|' read -r SUB_TITLE _ _ <<< "$SUB"
               SUB_FULL_TITLE="${TITLE_PREFIX}(${VERSION}): ${SUB_TITLE}"
-              SUB_NUM=$(gh api "repos/${REPO}/issues?state=open&per_page=20" \
-                --jq ".[] | select(.title == \"${SUB_FULL_TITLE}\") | .number" 2>/dev/null | head -1)
+              SUB_NUM=$(curl -sf -H "Authorization: token ${{ secrets.GA_TOKEN }}" "${{GITEA_URL:-https://git.mokoconsulting.tech}}/api/v1/repos/${{ github.repository }}/issues?state=open&per_page=20" 2>/dev/null \
+                | jq -r ".[] | select(.title == \"${SUB_FULL_TITLE}\") | .number" 2>/dev/null | head -1)
               if [ -n "$SUB_NUM" ]; then
-                gh api "repos/${REPO}/issues/${SUB_NUM}" -X PATCH \
-                  -f body="$(gh api "repos/${REPO}/issues/${SUB_NUM}" --jq '.body' 2>/dev/null)
+                curl -sf -H "Authorization: token ${{ secrets.GA_TOKEN }}" "${{GITEA_URL:-https://git.mokoconsulting.tech}}/api/v1/repos/${{ github.repository }}/issues/${SUB_NUM}" 2>/dev/null -X PATCH \
+                  -f body="$(curl -sf -H "Authorization: token ${{ secrets.GA_TOKEN }}" "${{GITEA_URL:-https://git.mokoconsulting.tech}}/api/v1/repos/${{ github.repository }}/issues/${SUB_NUM}" | jq -r '.body' 2>/dev/null)
 
           > **Parent Issue:** #${PARENT_NUM}" --silent 2>/dev/null || true
               fi

.github/workflows/auto-release.yml

@@ -3,7 +3,7 @@
 # SPDX-License-Identifier: GPL-3.0-or-later
 #
 # FILE INFORMATION
-# DEFGROUP: GitHub.Workflow
+# DEFGROUP: Gitea.Workflow
 # INGROUP: MokoStandards.Release
 # REPO: https://git.mokoconsulting.tech/MokoConsulting/MokoStandards
 # PATH: /templates/workflows/joomla/auto-release.yml.template
@@ -26,7 +26,7 @@
 # |    8. Build ZIP, upload asset, write SHA-256 to updates.xml             |
 # |                                                                        |
 # |  Every version change: archives main -> version/XX.YY branch           |
-# |  Patch 00 = development (no release). First release = patch 01.        |
+# |  All patches release (including 00). Patch 00/01 = full pipeline.      |
 # |  First release only (patch == 01):                                     |
 # |    7b. Create new GitHub Release                                       |
 # |                                                                        |
@@ -53,7 +53,7 @@ permissions:
 jobs:
   release:
     name: Build & Release Pipeline
-    runs-on: ubuntu-latest
+    runs-on: release
     if: >-
       github.event.pull_request.merged == true || github.event_name == 'workflow_dispatch'
 
@@ -61,25 +61,28 @@ jobs:
       - name: Checkout repository
         uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
         with:
-          token: ${{ secrets.GH_TOKEN || github.token }}
+          token: ${{ secrets.GA_TOKEN || github.token }}
           fetch-depth: 0
 
+      - name: Set authenticated push URL
+        run: git remote set-url origin "https://jmiller:${{ secrets.GA_TOKEN }}@git.mokoconsulting.tech/${{ github.repository }}.git"
+
       - name: Setup MokoStandards tools
         env:
-          GH_TOKEN: ${{ secrets.GH_TOKEN || github.token }}
-          COMPOSER_AUTH: '{"github-oauth":{"github.com":"${{ secrets.GH_TOKEN || github.token }}"}}'
+          GA_TOKEN: ${{ secrets.GA_TOKEN || github.token }}
+          COMPOSER_AUTH: '{"github-oauth":{"github.com":"${{ secrets.GA_TOKEN || github.token }}"}}'
         run: |
           git clone --depth 1 --branch version/04 --quiet \
-            "https://x-access-token:${GH_TOKEN}@git.mokoconsulting.tech/MokoConsulting/MokoStandards.git" \
-            /tmp/mokostandards
-          cd /tmp/mokostandards
+            "https://x-access-token:${GH_TOKEN}@git.mokoconsulting.tech/MokoConsulting/MokoStandards-API.git" \
+            /tmp/mokostandards-api
+          cd /tmp/mokostandards-api
           composer install --no-dev --no-interaction --quiet
 
       # -- STEP 1: Read version -----------------------------------------------
       - name: "Step 1: Read version from README.md"
         id: version
         run: |
-          VERSION=$(php /tmp/mokostandards/api/cli/version_read.php --path . 2>/dev/null)
+          VERSION=$(php /tmp/mokostandards-api/cli/version_read.php --path . 2>/dev/null)
           if [ -z "$VERSION" ]; then
             echo "No VERSION in README.md — skipping release"
             echo "skip=true" >> "$GITHUB_OUTPUT"
@@ -97,19 +100,13 @@ jobs:
           echo "minor=$MINOR" >> "$GITHUB_OUTPUT"
           echo "major=$MAJOR" >> "$GITHUB_OUTPUT"
           echo "release_tag=v${MAJOR}" >> "$GITHUB_OUTPUT"
-          if [ "$PATCH" = "00" ]; then
-            echo "skip=true" >> "$GITHUB_OUTPUT"
-            echo "is_minor=false" >> "$GITHUB_OUTPUT"
-            echo "Version: $VERSION (patch 00 = development — skipping release)"
+          echo "skip=false" >> "$GITHUB_OUTPUT"
+          if [ "$PATCH" = "00" ] || [ "$PATCH" = "01" ]; then
+            echo "is_minor=true" >> "$GITHUB_OUTPUT"
+            echo "Version: $VERSION (first release for this minor — full pipeline)"
           else
-            echo "skip=false" >> "$GITHUB_OUTPUT"
-            if [ "$PATCH" = "01" ]; then
-              echo "is_minor=true" >> "$GITHUB_OUTPUT"
-              echo "Version: $VERSION (first release — full pipeline)"
-            else
-              echo "is_minor=false" >> "$GITHUB_OUTPUT"
-              echo "Version: $VERSION (patch — platform version + badges only)"
-            fi
+            echo "is_minor=false" >> "$GITHUB_OUTPUT"
+            echo "Version: $VERSION (patch — platform version + badges only)"
           fi
 
       - name: Check if already released
@@ -243,7 +240,7 @@ jobs:
           steps.check.outputs.already_released != 'true'
         run: |
           VERSION="${{ steps.version.outputs.version }}"
-          php /tmp/mokostandards/api/cli/version_set_platform.php \
+          php /tmp/mokostandards-api/cli/version_set_platform.php \
             --path . --version "$VERSION" --branch main
 
       # -- STEP 4: Update version badges ----------------------------------------
@@ -318,8 +315,8 @@ jobs:
             PHP_TAG="<php_minimum>${PHP_MINIMUM}</php_minimum>"
           fi
 
-          DOWNLOAD_URL="https://github.com/${REPO}/releases/download/v${VERSION}/${EXT_ELEMENT}-${VERSION}.zip"
-          INFO_URL="https://github.com/${REPO}/releases/tag/v${VERSION}"
+          DOWNLOAD_URL="https://git.mokoconsulting.tech/${{ github.repository }}/releases/download/v${VERSION}/${EXT_ELEMENT}-${VERSION}.zip"
+          INFO_URL="https://git.mokoconsulting.tech/${{ github.repository }}/releases/tag/v${VERSION}"
 
           # -- Build stable entry to temp file ─────────────────────────
           {
@@ -384,11 +381,11 @@ jobs:
             exit 0
           fi
           VERSION="${{ steps.version.outputs.version }}"
-          git config --local user.email "github-actions[bot]@users.noreply.github.com"
-          git config --local user.name "github-actions[bot]"
+          git config --local user.email "gitea-actions[bot]@mokoconsulting.tech"
+          git config --local user.name "gitea-actions[bot]"
           git add -A
           git commit -m "chore(release): build ${VERSION} [skip ci]" \
-            --author="github-actions[bot] <github-actions[bot]@users.noreply.github.com>"
+            --author="gitea-actions[bot] <gitea-actions[bot]@mokoconsulting.tech>"
           git push
 
       # -- STEP 6: Create tag ---------------------------------------------------
@@ -415,14 +412,14 @@ jobs:
           steps.version.outputs.skip != 'true' &&
           steps.check.outputs.tag_exists != 'true'
         env:
-          GH_TOKEN: ${{ secrets.GH_TOKEN || github.token }}
+          GH_TOKEN: ${{ secrets.GA_TOKEN || github.token }}
         run: |
           VERSION="${{ steps.version.outputs.version }}"
           RELEASE_TAG="${{ steps.version.outputs.release_tag }}"
           BRANCH="${{ steps.version.outputs.branch }}"
           MAJOR="${{ steps.version.outputs.major }}"
 
-          NOTES=$(php /tmp/mokostandards/api/cli/release_notes.php --path . --version "$VERSION" 2>/dev/null)
+          NOTES=$(php /tmp/mokostandards-api/cli/release_notes.php --path . --version "$VERSION" 2>/dev/null)
           [ -z "$NOTES" ] && NOTES="Release ${VERSION}"
           echo "$NOTES" > /tmp/release_notes.md
 
@@ -461,7 +458,7 @@ jobs:
         if: >-
           steps.version.outputs.skip != 'true'
         env:
-          GH_TOKEN: ${{ secrets.GH_TOKEN || github.token }}
+          GH_TOKEN: ${{ secrets.GA_TOKEN || github.token }}
         run: |
           VERSION="${{ steps.version.outputs.version }}"
           RELEASE_TAG="${{ steps.version.outputs.release_tag }}"
@@ -511,20 +508,20 @@ jobs:
 
           # -- Update updates.xml with both download formats ---------------
           if [ -f "updates.xml" ]; then
-            ZIP_URL="https://github.com/${REPO}/releases/download/${RELEASE_TAG}/${ZIP_NAME}"
-            TAR_URL="https://github.com/${REPO}/releases/download/${RELEASE_TAG}/${TAR_NAME}"
+            ZIP_URL="https://git.mokoconsulting.tech/${{ github.repository }}/releases/download/${RELEASE_TAG}/${ZIP_NAME}"
+            TAR_URL="https://git.mokoconsulting.tech/${{ github.repository }}/releases/download/${RELEASE_TAG}/${TAR_NAME}"
 
             # Replace downloads block with both formats + SHA
             sed -i "s|<downloads>.*</downloads>|<downloads>\n      <downloadurl type=\"full\" format=\"zip\">${ZIP_URL}</downloadurl>\n      <downloadurl type=\"full\" format=\"tar.gz\">${TAR_URL}</downloadurl>\n    </downloads>|" updates.xml 2>/dev/null || true
             if grep -q '<sha256>' updates.xml; then
-              sed -i "s|<sha256>.*</sha256>|<sha256>sha256:${SHA256_ZIP}</sha256>|" updates.xml
+              sed -i "s|<sha256>.*</sha256>|<sha256>${SHA256_ZIP}</sha256>|" updates.xml
             else
-              sed -i "s|</downloads>|</downloads>\n    <sha256>sha256:${SHA256_ZIP}</sha256>|" updates.xml
+              sed -i "s|</downloads>|</downloads>\n    <sha256>${SHA256_ZIP}</sha256>|" updates.xml
             fi
 
             git add updates.xml
             git commit -m "chore(release): ZIP + tar.gz for ${VERSION} [skip ci]" \
-              --author="github-actions[bot] <github-actions[bot]@users.noreply.github.com>" || true
+              --author="gitea-actions[bot] <gitea-actions[bot]@mokoconsulting.tech>" || true
             git push || true
           fi
 
@@ -535,7 +532,7 @@ jobs:
           echo "| \`${ZIP_NAME}\` | ${ZIP_SIZE} | \`${SHA256_ZIP}\` |" >> $GITHUB_STEP_SUMMARY
           echo "| \`${TAR_NAME}\` | ${TAR_SIZE} | \`${SHA256_TAR}\` |" >> $GITHUB_STEP_SUMMARY
           echo "| Release | \`${RELEASE_TAG}\` | |" >> $GITHUB_STEP_SUMMARY
-          echo "| Download | [${PACKAGE_NAME}](https://github.com/${REPO}/releases/download/${RELEASE_TAG}/${PACKAGE_NAME}) |" >> $GITHUB_STEP_SUMMARY
+          echo "| Download | [${PACKAGE_NAME}](https://git.mokoconsulting.tech/${{ github.repository }}/releases/download/${RELEASE_TAG}/${PACKAGE_NAME}) |" >> $GITHUB_STEP_SUMMARY
 
       # -- Summary --------------------------------------------------------------
       - name: Pipeline Summary

.github/workflows/auto-update-sha.yml

@@ -1,7 +1,7 @@
 # Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
 # SPDX-License-Identifier: GPL-3.0-or-later
 # FILE INFORMATION
-# DEFGROUP: GitHub.Workflow
+# DEFGROUP: Gitea.Workflow
 # INGROUP: MokoCassiopeia.Automation
 # REPO: https://git.mokoconsulting.tech/MokoConsulting/MokoCassiopeia
 # PATH: /.github/workflows/auto-update-sha.yml
@@ -70,33 +70,60 @@ jobs:
           echo "sha256=${SHA256_HASH}" >> $GITHUB_OUTPUT
           echo "SHA-256 Hash: ${SHA256_HASH}"
 
-      - name: Update updates.xml
+      - name: Determine stability channel
+        id: channel
         run: |
           TAG="${{ steps.tag.outputs.tag }}"
-          SHA256="${{ steps.sha.outputs.sha256 }}"
+          case "$TAG" in
+            development) STABILITY="development" ;;
+            alpha)       STABILITY="alpha" ;;
+            beta)        STABILITY="beta" ;;
+            release-candidate) STABILITY="rc" ;;
+            *)           STABILITY="stable" ;;
+          esac
+          echo "stability=${STABILITY}" >> $GITHUB_OUTPUT
+          echo "Channel: ${STABILITY}"
+
+      - name: Update updates.xml (targeted channel only)
+        env:
+          PY_TAG: ${{ steps.tag.outputs.tag }}
+          PY_SHA: ${{ steps.sha.outputs.sha256 }}
+          PY_STABILITY: ${{ steps.channel.outputs.stability }}
+        run: |
           DATE=$(date +%Y-%m-%d)
-          
-          # Update version
-          sed -i "s|<version>.*</version>|<version>${TAG}</version>|" updates.xml
-          
-          # Update creation date
-          sed -i "s|<creationDate>.*</creationDate>|<creationDate>${DATE}</creationDate>|" updates.xml
-          
-          # Update download URL
-          sed -i "s|<downloadurl type='full' format='zip'>.*</downloadurl>|<downloadurl type='full' format='zip'>https://github.com/${{ github.repository }}/releases/download/${TAG}/mokocassiopeia-src-${TAG}.zip</downloadurl>|" updates.xml
-          
-          # Update or add SHA-256 hash
-          if grep -q "<sha256>" updates.xml; then
-            sed -i "s|<sha256>.*</sha256>|<sha256>sha256:${SHA256}</sha256>|" updates.xml
-          else
-            # Add SHA-256 after downloadurl
-            sed -i "/<\/downloadurl>/a\      <sha256>sha256:${SHA256}<\/sha256>" updates.xml
-          fi
-          
-          echo "Updated updates.xml with:"
-          echo "  Version: ${TAG}"
-          echo "  Date: ${DATE}"
-          echo "  SHA-256: ${SHA256}"
+          export PY_DATE="$DATE"
+
+          python3 << 'PYEOF'
+          import re, os
+
+          tag       = os.environ["PY_TAG"]
+          sha256    = os.environ["PY_SHA"]
+          date      = os.environ["PY_DATE"]
+          stability = os.environ["PY_STABILITY"]
+
+          with open("updates.xml") as f:
+              content = f.read()
+
+          pattern = r"(<update>(?:(?!</update>).)*?<tag>" + re.escape(stability) + r"</tag>.*?</update>)"
+          match = re.search(pattern, content, re.DOTALL)
+
+          if not match:
+              print(f"No <update> block for <tag>{stability}</tag> — skipping")
+              exit(0)
+
+          block = match.group(1)
+          original = block
+
+          block = re.sub(r"<sha256>[^<]*</sha256>", f"<sha256>{sha256}</sha256>", block)
+          block = re.sub(r"<creationDate>[^<]*</creationDate>", f"<creationDate>{date}</creationDate>", block)
+
+          content = content.replace(original, block)
+
+          with open("updates.xml", "w") as f:
+              f.write(content)
+
+          print(f"Updated {stability} channel: sha={sha256[:16]}..., date={date}")
+          PYEOF
 
       - name: Check for changes
         id: changes
@@ -115,11 +142,13 @@ jobs:
         run: |
           TAG="${{ steps.tag.outputs.tag }}"
           
-          git config --local user.email "github-actions[bot]@users.noreply.github.com"
-          git config --local user.name "github-actions[bot]"
+          git config --local user.email "gitea-actions[bot]@mokoconsulting.tech"
+          git config --local user.name "gitea-actions[bot]"
           
+          STABILITY="${{ steps.channel.outputs.stability }}"
           git add updates.xml
-          git commit -m "chore: Update SHA-256 hash for release ${TAG} - SHA: ${{ steps.sha.outputs.sha256 }}"
+          git commit -m "chore: update ${STABILITY} SHA-256 for ${TAG} [skip ci]" \
+            --author="gitea-actions[bot] <gitea-actions[bot]@mokoconsulting.tech>"
           
           git push origin main
           

.github/workflows/branch-freeze.yml

@@ -3,7 +3,7 @@
 # SPDX-License-Identifier: GPL-3.0-or-later
 #
 # FILE INFORMATION
-# DEFGROUP: GitHub.Workflow
+# DEFGROUP: Gitea.Workflow
 # INGROUP: MokoStandards.Automation
 # REPO: https://git.mokoconsulting.tech/MokoConsulting/MokoStandards
 # PATH: /templates/workflows/shared/branch-freeze.yml.template
@@ -41,12 +41,12 @@ jobs:
     steps:
       - name: Check permissions
         env:
-          GH_TOKEN: ${{ secrets.GH_TOKEN || github.token }}
+          GH_TOKEN: ${{ secrets.GA_TOKEN || github.token }}
         run: |
           ACTOR="${{ github.actor }}"
           REPO="${{ github.repository }}"
-          PERMISSION=$(gh api "repos/${REPO}/collaborators/${ACTOR}/permission" \
-            --jq '.permission' 2>/dev/null || echo "read")
+          PERMISSION=$(curl -sf -H "Authorization: token ${{ secrets.GA_TOKEN }}" "${{GITEA_URL:-https://git.mokoconsulting.tech}}/api/v1/repos/${{ github.repository }}/collaborators/${ACTOR}/permission" 2>/dev/null \
+            2>/dev/null | jq -r '.permission' || echo "read")
           if [ "$PERMISSION" != "admin" ]; then
             echo "Denied: only admins can freeze/unfreeze branches (${ACTOR} has ${PERMISSION})"
             exit 1
@@ -54,7 +54,7 @@ jobs:
 
       - name: "${{ inputs.action }} branch"
         env:
-          GH_TOKEN: ${{ secrets.GH_TOKEN || github.token }}
+          GH_TOKEN: ${{ secrets.GA_TOKEN || github.token }}
         run: |
           BRANCH="${{ inputs.branch }}"
           ACTION="${{ inputs.action }}"
@@ -66,8 +66,8 @@ jobs:
 
           if [ "$ACTION" = "freeze" ]; then
             # Check if ruleset already exists
-            EXISTING=$(gh api "repos/${REPO}/rulesets" \
-              --jq ".[] | select(.name == \"${RULESET_NAME}\") | .id" 2>/dev/null || true)
+            EXISTING=$(curl -sf -H "Authorization: token ${{ secrets.GA_TOKEN }}" "${{GITEA_URL:-https://git.mokoconsulting.tech}}/api/v1/repos/${{ github.repository }}/rulesets" 2>/dev/null \
+              | jq -r ".[] | select(.name == \"${RULESET_NAME}\") | .id" 2>/dev/null || true)
 
             if [ -n "$EXISTING" ]; then
               echo "Branch \`${BRANCH}\` is already frozen (ruleset #${EXISTING})" >> $GITHUB_STEP_SUMMARY
@@ -80,7 +80,7 @@ jobs:
             printf '"conditions":{"ref_name":{"include":["refs/heads/%s"],"exclude":[]}},' "${BRANCH}" >> /tmp/ruleset.json
             printf '"rules":[{"type":"update"},{"type":"deletion"},{"type":"non_fast_forward"}]}' >> /tmp/ruleset.json
 
-            RESULT=$(gh api "repos/${REPO}/rulesets" -X POST --input /tmp/ruleset.json --jq '.id' 2>&1) || true
+            RESULT=$(curl -sf -H "Authorization: token ${{ secrets.GA_TOKEN }}" "${{GITEA_URL:-https://git.mokoconsulting.tech}}/api/v1/repos/${{ github.repository }}/rulesets" 2>/dev/null -X POST -d @/tmp/ruleset.json 2>&1 | jq -r '.id') || true
 
             if echo "$RESULT" | grep -qE '^[0-9]+$'; then
               echo "Frozen \`${BRANCH}\` — ruleset #${RESULT}" >> $GITHUB_STEP_SUMMARY
@@ -98,15 +98,15 @@ jobs:
 
           elif [ "$ACTION" = "unfreeze" ]; then
             # Find and delete the freeze ruleset
-            RULESET_ID=$(gh api "repos/${REPO}/rulesets" \
-              --jq ".[] | select(.name == \"${RULESET_NAME}\") | .id" 2>/dev/null || true)
+            RULESET_ID=$(curl -sf -H "Authorization: token ${{ secrets.GA_TOKEN }}" "${{GITEA_URL:-https://git.mokoconsulting.tech}}/api/v1/repos/${{ github.repository }}/rulesets" 2>/dev/null \
+              | jq -r ".[] | select(.name == \"${RULESET_NAME}\") | .id" 2>/dev/null || true)
 
             if [ -z "$RULESET_ID" ]; then
               echo "Branch \`${BRANCH}\` is not frozen (no ruleset found)" >> $GITHUB_STEP_SUMMARY
               exit 0
             fi
 
-            gh api "repos/${REPO}/rulesets/${RULESET_ID}" -X DELETE --silent 2>/dev/null
+            curl -sf -H "Authorization: token ${{ secrets.GA_TOKEN }}" "${{GITEA_URL:-https://git.mokoconsulting.tech}}/api/v1/repos/${{ github.repository }}/rulesets/${RULESET_ID}" 2>/dev/null -X DELETE --silent 2>/dev/null
 
             echo "Unfrozen \`${BRANCH}\` — ruleset #${RULESET_ID} deleted" >> $GITHUB_STEP_SUMMARY
           fi

.github/workflows/changelog-validation.yml

@@ -5,7 +5,7 @@
 # SPDX-License-Identifier: GPL-3.0-or-later
 #
 # FILE INFORMATION
-# DEFGROUP: GitHub.Workflow.Template
+# DEFGROUP: Gitea.Workflow.Template
 # INGROUP: MokoStandards.CI
 # REPO: https://git.mokoconsulting.tech/MokoConsulting/MokoStandards
 # PATH: /templates/workflows/shared/changelog-validation.yml.template

.github/workflows/ci-joomla.yml

@@ -5,7 +5,7 @@
 # SPDX-License-Identifier: GPL-3.0-or-later
 #
 # FILE INFORMATION
-# DEFGROUP: GitHub.Workflow.Template
+# DEFGROUP: Gitea.Workflow.Template
 # INGROUP: MokoStandards.CI
 # REPO: https://git.mokoconsulting.tech/MokoConsulting/MokoStandards
 # PATH: /templates/workflows/joomla/ci-joomla.yml.template
@@ -39,16 +39,12 @@ jobs:
         uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
 
       - name: Setup PHP
-        uses: shivammathur/setup-php@accd6127cb78bee3e8082180cb391013d204ef9f # v2.31.0
-        with:
-          php-version: '8.2'
-          extensions: mbstring, xml, zip, gd, curl, json, simplexml
-          tools: composer:v2
-          coverage: none
+        run: |
+          php -v && composer --version
 
       - name: Clone MokoStandards
         env:
-          GH_TOKEN: ${{ secrets.GH_TOKEN || github.token }}
+          GH_TOKEN: ${{ secrets.GA_TOKEN || github.token }}
         run: |
           git clone --depth 1 --branch version/04 --quiet \
             "https://x-access-token:${GH_TOKEN}@git.mokoconsulting.tech/MokoConsulting/MokoStandards.git" \
@@ -56,7 +52,7 @@ jobs:
 
       - name: Install dependencies
         env:
-          COMPOSER_AUTH: '{"github-oauth":{"github.com":"${{ secrets.GH_TOKEN || github.token }}"}}'
+          COMPOSER_AUTH: '{"github-oauth":{"github.com":"${{ secrets.GA_TOKEN || github.token }}"}}'
         run: |
           if [ -f "composer.json" ]; then
             composer install \
@@ -344,16 +340,12 @@ jobs:
         uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
 
       - name: Setup PHP ${{ matrix.php }}
-        uses: shivammathur/setup-php@accd6127cb78bee3e8082180cb391013d204ef9f # v2.31.0
-        with:
-          php-version: ${{ matrix.php }}
-          extensions: mbstring, xml, zip, gd, curl, json, simplexml
-          tools: composer:v2
-          coverage: none
+        run: |
+          php -v && composer --version
 
       - name: Install dependencies
         env:
-          COMPOSER_AUTH: '{"github-oauth":{"github.com":"${{ secrets.GH_TOKEN || github.token }}"}}'
+          COMPOSER_AUTH: '{"github-oauth":{"github.com":"${{ secrets.GA_TOKEN || github.token }}"}}'
         run: |
           if [ -f "composer.json" ]; then
             composer install \

.github/workflows/codeql-analysis.yml

@@ -5,7 +5,7 @@
 # SPDX-License-Identifier: GPL-3.0-or-later
 #
 # FILE INFORMATION
-# DEFGROUP: GitHub.Workflow.Template
+# DEFGROUP: Gitea.Workflow.Template
 # INGROUP: MokoStandards.Security
 # REPO: https://git.mokoconsulting.tech/MokoConsulting/MokoStandards
 # PATH: /templates/workflows/generic/codeql-analysis.yml.template

.github/workflows/deploy-manual.yml

@@ -3,7 +3,7 @@
 # SPDX-License-Identifier: GPL-3.0-or-later
 #
 # FILE INFORMATION
-# DEFGROUP: GitHub.Workflow
+# DEFGROUP: Gitea.Workflow
 # INGROUP: MokoStandards.Deploy
 # REPO: https://git.mokoconsulting.tech/MokoConsulting/MokoStandards
 # PATH: /templates/workflows/joomla/deploy-manual.yml.template
@@ -32,24 +32,20 @@ permissions:
 jobs:
   deploy:
     name: SFTP Deploy to Dev
-    runs-on: ubuntu-latest
+    runs-on: release
 
     steps:
       - name: Checkout repository
         uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
 
       - name: Setup PHP
-        uses: shivammathur/setup-php@accd6127cb78bee3e8082180cb391013d204ef9f # v2.31.0
-        with:
-          php-version: '8.2'
-          extensions: json, ssh2
-          tools: composer
-          coverage: none
+        run: |
+          php -v && composer --version
 
       - name: Setup MokoStandards tools
         env:
-          GH_TOKEN: ${{ secrets.GH_TOKEN || github.token }}
-          COMPOSER_AUTH: '{"github-oauth":{"github.com":"${{ secrets.GH_TOKEN || github.token }}"}}'
+          GH_TOKEN: ${{ secrets.GA_TOKEN || github.token }}
+          COMPOSER_AUTH: '{"github-oauth":{"github.com":"${{ secrets.GA_TOKEN || github.token }}"}}'
         run: |
           git clone --depth 1 --branch version/04 --quiet \
             "https://x-access-token:${GH_TOKEN}@git.mokoconsulting.tech/MokoConsulting/MokoStandards.git" \

.github/workflows/enterprise-firewall-setup.yml

@@ -18,7 +18,7 @@
 # along with this program. If not, see <https://www.gnu.org/licenses/>.
 
 # FILE INFORMATION
-# DEFGROUP: GitHub.Workflow
+# DEFGROUP: Gitea.Workflow
 # INGROUP: MokoStandards.Firewall
 # REPO: https://git.mokoconsulting.tech/MokoConsulting/MokoStandards
 # PATH: /templates/workflows/shared/enterprise-firewall-setup.yml.template

.github/workflows/release.yml

@@ -4,27 +4,13 @@
 #
 # SPDX-License-Identifier: GPL-3.0-or-later
 #
-# This program is free software: you can redistribute it and/or modify
-# it under the terms of the GNU General Public License as published by
-# the Free Software Foundation, either version 3 of the License, or
-# (at your option) any later version.
-#
-# This program is distributed in the hope that it will be useful,
-# but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
-# GNU General Public License for more details.
-#
-# You should have received a copy of the GNU General Public License
-# along with this program. If not, see <https://www.gnu.org/licenses/>.
-#
 # FILE INFORMATION
-# DEFGROUP: GitHub.Workflow
+# DEFGROUP: Gitea.Workflow
 # INGROUP: MokoCassiopeia.Release
 # REPO: https://git.mokoconsulting.tech/MokoConsulting/MokoCassiopeia
 # PATH: /.github/workflows/release.yml
-# VERSION: 03.09.03
-# BRIEF: Automated release workflow for MokoCassiopeia Joomla template
-# NOTE: Creates release packages and publishes to GitHub Releases
+# VERSION: 03.09.16
+# BRIEF: Joomla release — build ZIP, publish to Gitea, mirror to GitHub
 
 name: Create Release
 
@@ -35,7 +21,7 @@ on:
   workflow_dispatch:
     inputs:
       version:
-        description: 'Release version (e.g., 03.08.03)'
+        description: 'Release version (e.g., 03.09.16)'
         required: true
         type: string
       prerelease:
@@ -43,15 +29,26 @@ on:
         required: false
         type: boolean
         default: false
+      stability:
+        description: 'Stability tag (development, alpha, beta, rc, stable)'
+        required: false
+        type: string
+        default: 'development'
 
 permissions:
   contents: write
 
+env:
+  GITEA_URL: https://git.mokoconsulting.tech
+  GITEA_ORG: MokoConsulting
+  GITEA_REPO: MokoCassiopeia
+  EXT_ELEMENT: mokocassiopeia
+
 jobs:
   build:
     name: Build Release Package
-    runs-on: ubuntu-latest
-    
+    runs-on: release
+
     steps:
       - name: Checkout repository
         uses: actions/checkout@v4
@@ -59,152 +56,464 @@ jobs:
           fetch-depth: 0
 
       - name: Setup PHP
-        uses: shivammathur/setup-php@v2
-        with:
-          php-version: '8.1'
-          extensions: mbstring, xml, zip
-          tools: composer:v2
+        run: |
+          sudo apt-get update -qq
+          sudo apt-get install -y -qq php-cli php-mbstring php-xml php-zip php-curl composer >/dev/null 2>&1
+          php -v
+          composer --version
 
-      - name: Get version
-        id: version
+      - name: Get version and stability
+        id: meta
         run: |
           if [ "${{ github.event_name }}" == "workflow_dispatch" ]; then
             VERSION="${{ inputs.version }}"
+            STABILITY="${{ inputs.stability }}"
+            PRERELEASE="${{ inputs.prerelease }}"
           else
             VERSION=${GITHUB_REF#refs/tags/}
+            STABILITY="stable"
+            PRERELEASE="false"
           fi
-          echo "version=${VERSION}" >> $GITHUB_OUTPUT
-          echo "Building version: ${VERSION}"
+
+          # Derive suffix and tag from stability
+          case "$STABILITY" in
+            development) SUFFIX="-dev";   TAG_NAME="development" ;;
+            alpha)       SUFFIX="-alpha"; TAG_NAME="alpha" ;;
+            beta)        SUFFIX="-beta";  TAG_NAME="beta" ;;
+            rc)          SUFFIX="-rc";    TAG_NAME="release-candidate" ;;
+            stable)      SUFFIX="";       TAG_NAME="v${VERSION%%.*}" ;;
+            *)           SUFFIX="-dev";   TAG_NAME="development" ;;
+          esac
+
+          ZIP_NAME="${EXT_ELEMENT}-${VERSION}${SUFFIX}.zip"
+
+          echo "version=${VERSION}" >> "$GITHUB_OUTPUT"
+          echo "stability=${STABILITY}" >> "$GITHUB_OUTPUT"
+          echo "prerelease=${PRERELEASE}" >> "$GITHUB_OUTPUT"
+          echo "suffix=${SUFFIX}" >> "$GITHUB_OUTPUT"
+          echo "tag_name=${TAG_NAME}" >> "$GITHUB_OUTPUT"
+          echo "zip_name=${ZIP_NAME}" >> "$GITHUB_OUTPUT"
+          echo "Building: ${ZIP_NAME} (${STABILITY})"
+
+      - name: Auto-bump patch version
+        id: bump
+        env:
+          GA_TOKEN: ${{ secrets.GA_TOKEN }}
+          INPUT_VERSION: ${{ steps.meta.outputs.version }}
+          INPUT_STABILITY: ${{ steps.meta.outputs.stability }}
+          INPUT_SUFFIX: ${{ steps.meta.outputs.suffix }}
+        run: |
+          BRANCH="${{ github.ref_name }}"
+          GITEA_API="${GITEA_URL}/api/v1/repos/${{ github.repository }}"
+
+          # Read current version from README.md
+          CURRENT=$(sed -n 's/.*VERSION:[[:space:]]*\([0-9][0-9]\.[0-9][0-9]\.[0-9][0-9]\).*/\1/p' README.md 2>/dev/null | head -1)
+          if [ -z "$CURRENT" ]; then
+            echo "No VERSION in README.md — using input version"
+            echo "version=${INPUT_VERSION}" >> "$GITHUB_OUTPUT"
+            echo "zip_name=${EXT_ELEMENT}-${INPUT_VERSION}${INPUT_SUFFIX}.zip" >> "$GITHUB_OUTPUT"
+            exit 0
+          fi
+
+          # Bump patch: XX.YY.ZZ → XX.YY.(ZZ+1)
+          MAJOR=$(echo "$CURRENT" | cut -d. -f1)
+          MINOR=$(echo "$CURRENT" | cut -d. -f2)
+          PATCH=$(echo "$CURRENT" | cut -d. -f3)
+          NEW_PATCH=$(printf "%02d" $((10#$PATCH + 1)))
+          NEW_VERSION="${MAJOR}.${MINOR}.${NEW_PATCH}"
+
+          echo "Bumping: ${CURRENT} → ${NEW_VERSION}"
+
+          # Update README.md
+          sed -i "s/VERSION:[[:space:]]*${CURRENT}/VERSION: ${NEW_VERSION}/" README.md
+
+          # Update templateDetails.xml / manifest
+          MANIFEST=$(find . -maxdepth 2 -name "*.xml" -exec grep -l '<extension' {} \; 2>/dev/null | head -1)
+          if [ -n "$MANIFEST" ]; then
+            sed -i "s|<version>${CURRENT}</version>|<version>${NEW_VERSION}</version>|" "$MANIFEST"
+          fi
+
+          # Update only the matching stability channel in updates.xml
+          if [ -f "updates.xml" ]; then
+            export PY_OLD="$CURRENT" PY_NEW="$NEW_VERSION" PY_STABILITY="$INPUT_STABILITY"
+            python3 << 'PYEOF'
+          import re, os
+          old = os.environ["PY_OLD"]
+          new = os.environ["PY_NEW"]
+          stability = os.environ["PY_STABILITY"]
+          with open("updates.xml") as f:
+              content = f.read()
+          pattern = r"(<update>(?:(?!</update>).)*?<tag>" + re.escape(stability) + r"</tag>.*?</update>)"
+          match = re.search(pattern, content, re.DOTALL)
+          if match:
+              block = match.group(1)
+              updated = block.replace(old, new)
+              content = content.replace(block, updated)
+          with open("updates.xml", "w") as f:
+              f.write(content)
+          print(f"Updated {stability} channel: {old} -> {new}")
+          PYEOF
+          fi
+
+          # Commit bump to current branch
+          git config --local user.email "gitea-actions[bot]@mokoconsulting.tech"
+          git config --local user.name "gitea-actions[bot]"
+          git remote set-url origin "https://jmiller:${GA_TOKEN}@git.mokoconsulting.tech/${{ github.repository }}.git"
+          git add -A
+          git diff --cached --quiet || {
+            git commit -m "chore(version): bump ${CURRENT} → ${NEW_VERSION} [skip ci]" \
+              --author="gitea-actions[bot] <gitea-actions[bot]@mokoconsulting.tech>"
+            git push
+          }
+
+          # For stable releases from dev: merge dev → main via Gitea API
+          if [ "$INPUT_STABILITY" = "stable" ] && [ "$BRANCH" != "main" ]; then
+            echo "Merging ${BRANCH} → main via Gitea API..."
+            MERGE_RESULT=$(curl -sf -X POST -H "Authorization: token ${GA_TOKEN}" \
+              -H "Content-Type: application/json" \
+              "${GITEA_API}/merges" \
+              -d "$(jq -n \
+                --arg base "main" \
+                --arg head "${BRANCH}" \
+                --arg msg "chore(release): merge ${BRANCH} for stable ${NEW_VERSION} [skip ci]" \
+                '{base: $base, head: $head, merge_message_field: $msg}'
+              )" 2>&1) || true
+            echo "Merge result: ${MERGE_RESULT}"
+          fi
+
+          echo "version=${NEW_VERSION}" >> "$GITHUB_OUTPUT"
+          echo "zip_name=${EXT_ELEMENT}-${NEW_VERSION}${INPUT_SUFFIX}.zip" >> "$GITHUB_OUTPUT"
 
       - name: Install dependencies
+        env:
+          COMPOSER_AUTH: '{"http-basic":{"git.mokoconsulting.tech":{"username":"token","password":"${{ secrets.GA_TOKEN }}"}}}'
         run: |
           if [ -f "composer.json" ]; then
-            composer install --no-dev --optimize-autoloader
+            composer install --no-dev --optimize-autoloader --no-interaction
           fi
 
-      - name: Update version in manifest files
-        run: |
-          VERSION="${{ steps.version.outputs.version }}"
-          # Update version in templateDetails.xml
-          sed -i "s/<version>.*<\/version>/<version>${VERSION}<\/version>/g" src/templateDetails.xml
-          # Update version in updates.xml
-          sed -i "s/<version>.*<\/version>/<version>${VERSION}<\/version>/g" updates.xml
-          # Update creation date to today
-          DATE=$(date +%Y-%m-%d)
-          sed -i "s/<creationDate>.*<\/creationDate>/<creationDate>${DATE}<\/creationDate>/g" src/templateDetails.xml
-          sed -i "s/<creationDate>.*<\/creationDate>/<creationDate>${DATE}<\/creationDate>/g" updates.xml
-
-      - name: Create package structure
+      - name: Create package
         run: |
           mkdir -p build/package
-          
-          # Copy template files from src (excluding media directory)
-          rsync -av --exclude='media' src/ build/package/
-          
-          # Copy media files from src/media to package/media directory
-          mkdir -p build/package/media
-          rsync -av src/media/ build/package/media/
+          rsync -av \
+            --exclude='sftp-config*' \
+            --exclude='.ftpignore' \
+            --exclude='*.ppk' \
+            --exclude='*.pem' \
+            --exclude='*.key' \
+            --exclude='.env*' \
+            --exclude='*.local' \
+            src/ build/package/
 
-      - name: Create source ZIP package
+      - name: Build ZIP
+        id: zip
         run: |
+          ZIP_NAME="${{ steps.bump.outputs.zip_name }}"
           cd build/package
-          VERSION="${{ steps.version.outputs.version }}"
-          ZIP_NAME="mokocassiopeia-src-${VERSION}.zip"
           zip -r "../${ZIP_NAME}" .
-          cd ../..
-          echo "ZIP_NAME=${ZIP_NAME}" >> $GITHUB_ENV
-          echo "Created package: ${ZIP_NAME}"
+          cd ..
 
-      - name: Generate checksums
+          SHA256=$(sha256sum "${ZIP_NAME}" | cut -d' ' -f1)
+          SIZE=$(stat -c%s "${ZIP_NAME}")
+
+          echo "sha256=${SHA256}" >> "$GITHUB_OUTPUT"
+          echo "size=${SIZE}" >> "$GITHUB_OUTPUT"
+          echo "SHA-256: ${SHA256}"
+          echo "Size: ${SIZE} bytes"
+
+      # ── Gitea Release (PRIMARY) ──────────────────────────────────────
+      - name: "Gitea: Delete existing release"
         run: |
-          cd build
-          sha256sum "${ZIP_NAME}" > "${ZIP_NAME}.sha256"
-          md5sum "${ZIP_NAME}" > "${ZIP_NAME}.md5"
-          
-          # Extract just the hash for updates.xml
-          SHA256_HASH=$(sha256sum "${ZIP_NAME}" | cut -d' ' -f1)
-          echo "SHA256_HASH=${SHA256_HASH}" >> $GITHUB_ENV
-          echo "SHA-256: ${SHA256_HASH}"
+          TAG="${{ steps.meta.outputs.tag_name }}"
+          TOKEN="${{ secrets.GA_TOKEN }}"
+          API="${GITEA_URL}/api/v1/repos/${GITEA_ORG}/${GITEA_REPO}"
 
-      - name: Upload build artifacts
-        uses: actions/upload-artifact@v4
-        with:
-          name: release-package
-          path: |
-            build/*.zip
-            build/*.sha256
-            build/*.md5
+          # Find and delete existing release by tag (may not exist — ignore 404)
+          RELEASE_ID=$(curl -s -H "Authorization: token ${TOKEN}" \
+            "${API}/releases/tags/${TAG}" 2>/dev/null | jq -r '.id // empty')
 
-  release:
-    name: Create GitHub Release
-    runs-on: ubuntu-latest
-    needs: build
-    
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v4
-
-      - name: Download build artifacts
-        uses: actions/download-artifact@v4
-        with:
-          name: release-package
-          path: ./artifacts
-
-      - name: Get version
-        id: version
-        run: |
-          if [ "${{ github.event_name }}" == "workflow_dispatch" ]; then
-            VERSION="${{ inputs.version }}"
-          else
-            VERSION=${GITHUB_REF#refs/tags/}
+          if [ -n "$RELEASE_ID" ]; then
+            curl -sf -X DELETE -H "Authorization: token ${TOKEN}" \
+              "${API}/releases/${RELEASE_ID}" || true
+            echo "Deleted existing release id=${RELEASE_ID}"
           fi
-          echo "version=${VERSION}" >> $GITHUB_OUTPUT
 
-      - name: Extract changelog
-        id: changelog
+          # Delete existing tag
+          curl -sf -X DELETE -H "Authorization: token ${TOKEN}" \
+            "${API}/tags/${TAG}" 2>/dev/null || true
+
+      - name: "Gitea: Create release"
+        id: gitea_release
         run: |
+          TAG="${{ steps.meta.outputs.tag_name }}"
+          VERSION="${{ steps.bump.outputs.version }}"
+          STABILITY="${{ steps.meta.outputs.stability }}"
+          PRERELEASE="${{ steps.meta.outputs.prerelease }}"
+          SHA256="${{ steps.zip.outputs.sha256 }}"
+          TOKEN="${{ secrets.GA_TOKEN }}"
+          API="${GITEA_URL}/api/v1/repos/${GITEA_ORG}/${GITEA_REPO}"
+
+          # Build release body
+          BODY="## ${EXT_ELEMENT} ${VERSION} (${STABILITY})
+
+          ### SHA-256
+          \`${SHA256}\`"
+
+          # Extract changelog if available
           if [ -f "CHANGELOG.md" ]; then
-            # Extract changelog for this version
-            VERSION="${{ steps.version.outputs.version }}"
-            awk "/## \[${VERSION}\]/,/## \[/{if(/## \[${VERSION}\]/)print;else if(/## \[/)exit;else print}" CHANGELOG.md > release_notes.md
-            
-            if [ ! -s release_notes.md ]; then
-              echo "No specific changelog found for version ${VERSION}" > release_notes.md
-              echo "" >> release_notes.md
-              echo "Please refer to the full CHANGELOG.md for details." >> release_notes.md
+            NOTES=$(awk "/## \[${VERSION}\]/,/## \[/{if(/## \[${VERSION}\]/)next;if(/## \[/)exit;print}" CHANGELOG.md)
+            if [ -n "$NOTES" ]; then
+              BODY="## ${EXT_ELEMENT} ${VERSION} (${STABILITY})
+
+          ${NOTES}
+
+          ### SHA-256
+          \`${SHA256}\`"
             fi
-          else
-            echo "Release version ${{ steps.version.outputs.version }}" > release_notes.md
           fi
 
-      - name: Create Release
-        uses: softprops/action-gh-release@v1
-        with:
-          tag_name: ${{ steps.version.outputs.version }}
-          name: Release ${{ steps.version.outputs.version }}
-          body_path: release_notes.md
-          draft: false
-          prerelease: ${{ inputs.prerelease || false }}
-          files: |
-            artifacts/*.zip
-            artifacts/*.sha256
-            artifacts/*.md5
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          IS_PRE="true"
+          if [ "$STABILITY" = "stable" ]; then
+            IS_PRE="false"
+          fi
 
-      - name: Release summary
+          RESULT=$(curl -sf -X POST -H "Authorization: token ${TOKEN}" \
+            -H "Content-Type: application/json" \
+            "${API}/releases" \
+            -d "$(jq -n \
+              --arg tag "$TAG" \
+              --arg target "${{ github.ref_name }}" \
+              --arg name "${EXT_ELEMENT} ${VERSION} ${STABILITY^}" \
+              --arg body "$BODY" \
+              --argjson pre "$IS_PRE" \
+              '{tag_name: $tag, target_commitish: $target, name: $name, body: $body, prerelease: $pre}'
+            )")
+
+          RELEASE_ID=$(echo "$RESULT" | jq -r '.id')
+          echo "release_id=${RELEASE_ID}" >> "$GITHUB_OUTPUT"
+          echo "Gitea release created: id=${RELEASE_ID}, tag=${TAG}"
+
+      - name: "Gitea: Upload ZIP"
         run: |
-          echo "### Release Created Successfully" >> $GITHUB_STEP_SUMMARY
+          RELEASE_ID="${{ steps.gitea_release.outputs.release_id }}"
+          ZIP_NAME="${{ steps.bump.outputs.zip_name }}"
+          TOKEN="${{ secrets.GA_TOKEN }}"
+          API="${GITEA_URL}/api/v1/repos/${GITEA_ORG}/${GITEA_REPO}"
+
+          curl -sf -X POST \
+            -H "Authorization: token ${TOKEN}" \
+            -H "Content-Type: application/octet-stream" \
+            "${API}/releases/${RELEASE_ID}/assets?name=${ZIP_NAME}" \
+            --data-binary "@build/${ZIP_NAME}"
+
+          echo "Uploaded ${ZIP_NAME} to Gitea release ${RELEASE_ID}"
+
+      # ── GitHub Mirror (BACKUP) ───────────────────────────────────────
+      - name: "GitHub: Mirror release (stable/rc only)"
+        if: ${{ steps.meta.outputs.stability == 'stable' || steps.meta.outputs.stability == 'rc' }}
+        continue-on-error: true
+        run: |
+          TAG="${{ steps.meta.outputs.tag_name }}"
+          VERSION="${{ steps.bump.outputs.version }}"
+          STABILITY="${{ steps.meta.outputs.stability }}"
+          ZIP_NAME="${{ steps.bump.outputs.zip_name }}"
+          SHA256="${{ steps.zip.outputs.sha256 }}"
+          TOKEN="${{ secrets.GH_TOKEN }}"
+          GH_REPO="mokoconsulting-tech/${GITEA_REPO}"
+          GH_API="https://api.github.com/repos/${GH_REPO}"
+
+          IS_PRE="true"
+          [ "$STABILITY" = "stable" ] && IS_PRE="false"
+
+          # Delete existing release by tag
+          EXISTING=$(curl -sf -H "Authorization: token ${TOKEN}" \
+            "${GH_API}/releases/tags/${TAG}" 2>/dev/null | jq -r '.id // empty')
+          if [ -n "$EXISTING" ]; then
+            curl -sf -X DELETE -H "Authorization: token ${TOKEN}" \
+              "${GH_API}/releases/${EXISTING}" || true
+          fi
+
+          # Delete tag
+          curl -sf -X DELETE -H "Authorization: token ${TOKEN}" \
+            "${GH_API}/git/refs/tags/${TAG}" 2>/dev/null || true
+
+          # Create release
+          RELEASE_ID=$(curl -sf -X POST -H "Authorization: token ${TOKEN}" \
+            -H "Content-Type: application/json" \
+            "${GH_API}/releases" \
+            -d "$(jq -n \
+              --arg tag "$TAG" \
+              --arg target "${{ github.sha }}" \
+              --arg name "${EXT_ELEMENT} ${VERSION} ${STABILITY^} (mirror)" \
+              --arg body "Mirror of Gitea release. SHA-256: \`${SHA256}\`" \
+              --argjson pre "$IS_PRE" \
+              '{tag_name: $tag, target_commitish: $target, name: $name, body: $body, prerelease: $pre, draft: false}'
+            )" | jq -r '.id')
+
+          # Upload ZIP
+          if [ -n "$RELEASE_ID" ] && [ "$RELEASE_ID" != "null" ]; then
+            curl -sf -X POST \
+              -H "Authorization: token ${TOKEN}" \
+              -H "Content-Type: application/octet-stream" \
+              "https://uploads.github.com/repos/${GH_REPO}/releases/${RELEASE_ID}/assets?name=${ZIP_NAME}" \
+              --data-binary "@build/${ZIP_NAME}"
+            echo "GitHub mirror: uploaded ${ZIP_NAME}"
+          fi
+
+      # ── Update updates.xml ──────────────────────────────────────────
+      - name: "Update updates.xml for this channel"
+        run: |
+          STABILITY="${{ steps.meta.outputs.stability }}"
+          VERSION="${{ steps.bump.outputs.version }}"
+          SHA256="${{ steps.zip.outputs.sha256 }}"
+          ZIP_NAME="${{ steps.bump.outputs.zip_name }}"
+          TAG="${{ steps.meta.outputs.tag_name }}"
+          DATE=$(date +%Y-%m-%d)
+
+          if [ ! -f "updates.xml" ] || [ -z "$SHA256" ]; then
+            echo "No updates.xml or no SHA — skipping"
+            exit 0
+          fi
+
+          # Cascading channels: each stability updates itself and all lower levels
+          export PY_STABILITY="$STABILITY" PY_VERSION="$VERSION" PY_SHA256="$SHA256" \
+                 PY_ZIP_NAME="$ZIP_NAME" PY_TAG="$TAG" PY_DATE="$DATE" \
+                 PY_GITEA_ORG="$GITEA_ORG" PY_GITEA_REPO="$GITEA_REPO"
+          python3 << 'PYEOF'
+          import re, os
+
+          stability  = os.environ["PY_STABILITY"]
+          version    = os.environ["PY_VERSION"]
+          sha256     = os.environ["PY_SHA256"]
+          zip_name   = os.environ["PY_ZIP_NAME"]
+          tag        = os.environ["PY_TAG"]
+          date       = os.environ["PY_DATE"]
+          gitea_org  = os.environ["PY_GITEA_ORG"]
+          gitea_repo = os.environ["PY_GITEA_REPO"]
+
+          # Cascade map: each level updates itself + all lower levels
+          cascade = {
+              "stable": ["development", "alpha", "beta", "rc", "stable"],
+              "rc": ["development", "alpha", "beta", "rc"],
+              "beta": ["development", "alpha", "beta"],
+              "alpha": ["development", "alpha"],
+              "development": ["development"],
+          }
+          targets = cascade.get(stability, [stability])
+
+          with open("updates.xml", "r") as f:
+              content = f.read()
+
+          gitea_url = f"https://git.mokoconsulting.tech/{gitea_org}/{gitea_repo}/releases/download/{tag}/{zip_name}"
+
+          for xml_tag in targets:
+              block_pattern = r"(<update>(?:(?!</update>).)*?<tag>" + re.escape(xml_tag) + r"</tag>.*?</update>)"
+              match = re.search(block_pattern, content, re.DOTALL)
+
+              if not match:
+                  print(f"No block for <tag>{xml_tag}</tag> — skipping")
+                  continue
+
+              block = match.group(1)
+              original = block
+
+              block = re.sub(r"<version>[^<]*</version>", f"<version>{version}</version>", block)
+              block = re.sub(r"<creationDate>[^<]*</creationDate>", f"<creationDate>{date}</creationDate>", block)
+
+              if "<sha256>" in block:
+                  block = re.sub(r"<sha256>[^<]*</sha256>", f"<sha256>{sha256}</sha256>", block)
+              else:
+                  block = block.replace("</downloads>", f"</downloads>\n    <sha256>{sha256}</sha256>")
+
+              block = re.sub(
+                  r"(<downloadurl[^>]*>)https://git\.mokoconsulting\.tech/[^<]*(</downloadurl>)",
+                  rf"\g<1>{gitea_url}\g<2>",
+                  block
+              )
+
+              content = content.replace(original, block)
+              print(f"Updated {xml_tag} channel")
+
+          with open("updates.xml", "w") as f:
+              f.write(content)
+
+          print(f"Cascaded {stability} → {', '.join(targets)}: v={version}, sha={sha256[:16]}...")
+          PYEOF
+
+      - name: "Commit updates.xml to current branch and main"
+        run: |
+          if git diff --quiet updates.xml 2>/dev/null; then
+            echo "No changes to updates.xml"
+            exit 0
+          fi
+
+          STABILITY="${{ steps.meta.outputs.stability }}"
+          VERSION="${{ steps.bump.outputs.version }}"
+          CURRENT_BRANCH="${{ github.ref_name }}"
+          TOKEN="${{ secrets.GA_TOKEN }}"
+
+          git config --local user.email "gitea-actions[bot]@mokoconsulting.tech"
+          git config --local user.name "gitea-actions[bot]"
+          git add updates.xml
+          git commit -m "chore: update ${STABILITY} SHA-256 for ${VERSION} [skip ci]" \
+            --author="gitea-actions[bot] <gitea-actions[bot]@mokoconsulting.tech>"
+
+          # Set push URL with GA_TOKEN for authenticated pushes (branch protection requires jmiller)
+          git remote set-url origin "https://jmiller:${{ secrets.GA_TOKEN }}@git.mokoconsulting.tech/${{ github.repository }}.git"
+
+          # Push to current branch
+          git push || true
+
+          # Also update updates.xml on main via Gitea API (git push blocked by branch protection)
+          if [ "$CURRENT_BRANCH" != "main" ]; then
+            GA_TOKEN="${{ secrets.GA_TOKEN }}"
+            API="${GITEA_URL}/api/v1/repos/${{ github.repository }}"
+
+            # Get current file SHA on main (required for update)
+            FILE_SHA=$(curl -sf -H "Authorization: token ${GA_TOKEN}" \
+              "${API}/contents/updates.xml?ref=main" | jq -r '.sha // empty')
+
+            if [ -n "$FILE_SHA" ]; then
+              # Base64-encode the updates.xml content from working tree (has updated SHA)
+              CONTENT=$(base64 -w0 updates.xml)
+
+              RESPONSE=$(curl -s -w "\n%{http_code}" -X PUT -H "Authorization: token ${GA_TOKEN}" \
+                -H "Content-Type: application/json" \
+                "${API}/contents/updates.xml" \
+                -d "$(jq -n \
+                  --arg content "$CONTENT" \
+                  --arg sha "$FILE_SHA" \
+                  --arg msg "chore: update ${STABILITY} channel to ${VERSION} on main [skip ci]" \
+                  --arg branch "main" \
+                  '{content: $content, sha: $sha, message: $msg, branch: $branch}'
+                )")
+              HTTP_CODE=$(echo "$RESPONSE" | tail -1)
+              if [ "$HTTP_CODE" = "200" ] || [ "$HTTP_CODE" = "201" ]; then
+                echo "updates.xml synced to main via API (HTTP ${HTTP_CODE})"
+              else
+                echo "WARNING: failed to sync updates.xml to main (HTTP ${HTTP_CODE})"
+                echo "$RESPONSE" | head -5
+              fi
+            else
+              echo "WARNING: could not get file SHA for updates.xml on main"
+            fi
+          fi
+
+      - name: Summary
+        run: |
+          VERSION="${{ steps.bump.outputs.version }}"
+          STABILITY="${{ steps.meta.outputs.stability }}"
+          ZIP_NAME="${{ steps.bump.outputs.zip_name }}"
+          SHA256="${{ steps.zip.outputs.sha256 }}"
+          TAG="${{ steps.meta.outputs.tag_name }}"
+
+          echo "### Release Created" >> $GITHUB_STEP_SUMMARY
           echo "" >> $GITHUB_STEP_SUMMARY
-          echo "- Version: ${{ steps.version.outputs.version }}" >> $GITHUB_STEP_SUMMARY
-          echo "- Repository: $GITHUB_REPOSITORY" >> $GITHUB_STEP_SUMMARY
-          echo "- Tag: ${{ steps.version.outputs.version }}" >> $GITHUB_STEP_SUMMARY
-          echo "- Pre-release: ${{ inputs.prerelease || false }}" >> $GITHUB_STEP_SUMMARY
-          echo "" >> $GITHUB_STEP_SUMMARY
-          echo "Package files:" >> $GITHUB_STEP_SUMMARY
-          ls -lh artifacts/ >> $GITHUB_STEP_SUMMARY
-          echo "" >> $GITHUB_STEP_SUMMARY
-          echo "### Next Steps" >> $GITHUB_STEP_SUMMARY
-          echo "1. Verify the release at: https://github.com/$GITHUB_REPOSITORY/releases/tag/${{ steps.version.outputs.version }}" >> $GITHUB_STEP_SUMMARY
-          echo "2. Update updates.xml with the SHA-256 hash from the .sha256 file" >> $GITHUB_STEP_SUMMARY
-          echo "3. Test the installation package" >> $GITHUB_STEP_SUMMARY
+          echo "| Field | Value |" >> $GITHUB_STEP_SUMMARY
+          echo "|-------|-------|" >> $GITHUB_STEP_SUMMARY
+          echo "| Version | \`${VERSION}\` |" >> $GITHUB_STEP_SUMMARY
+          echo "| Stability | ${STABILITY} |" >> $GITHUB_STEP_SUMMARY
+          echo "| Tag | \`${TAG}\` |" >> $GITHUB_STEP_SUMMARY
+          echo "| Package | \`${ZIP_NAME}\` |" >> $GITHUB_STEP_SUMMARY
+          echo "| SHA-256 | \`${SHA256}\` |" >> $GITHUB_STEP_SUMMARY
+          echo "| Gitea | [Release](${GITEA_URL}/${GITEA_ORG}/${GITEA_REPO}/releases/tag/${TAG}) |" >> $GITHUB_STEP_SUMMARY

.github/workflows/repo_health.yml

@@ -6,7 +6,7 @@
 # SPDX-License-Identifier: GPL-3.0-or-later
 #
 # FILE INFORMATION
-# DEFGROUP: GitHub.Workflow
+# DEFGROUP: Gitea.Workflow
 # INGROUP: MokoStandards.Validation
 # REPO: https://git.mokoconsulting.tech/MokoConsulting/MokoStandards
 # PATH: /.github/workflows/repo_health.yml
@@ -87,62 +87,54 @@ jobs:
     steps:
       - name: Check actor permission (admin only)
         id: perm
-        uses: actions/github-script@v7
-        with:
-          github-token: ${{ secrets.GH_TOKEN }}
-          script: |
-            const actor = context.actor;
-            let permission = "unknown";
-            let allowed = false;
-            let method = "";
+        run: |
+          ACTOR="${{ github.actor }}"
+          REPO="${{ github.repository }}"
+          TOKEN="${{ secrets.GA_TOKEN }}"
+          GITEA_API="${GITEA_URL:-https://git.mokoconsulting.tech}/api/v1"
 
-            // Hardcoded authorized users — always allowed
-            const authorizedUsers = ["jmiller-moko", "github-actions[bot]"];
-            if (authorizedUsers.includes(actor)) {
-              allowed = true;
-              permission = "admin";
-              method = "hardcoded allowlist";
-            } else {
-              // Check via API for other actors
-              try {
-                const res = await github.rest.repos.getCollaboratorPermissionLevel({
-                  owner: context.repo.owner,
-                  repo: context.repo.repo,
-                  username: actor,
-                });
-                permission = (res?.data?.permission || "unknown").toLowerCase();
-                allowed = permission === "admin" || permission === "maintain";
-                method = "repo collaborator API";
-              } catch (error) {
-                core.warning(`Could not fetch permissions for '${actor}': ${error.message}`);
-                permission = "unknown";
-                allowed = false;
-                method = "API error";
-              }
-            }
+          PERMISSION="unknown"
+          ALLOWED="false"
+          METHOD=""
 
-            core.setOutput("permission", permission);
-            core.setOutput("allowed", allowed ? "true" : "false");
+          # Hardcoded authorized users
+          if [ "$ACTOR" = "jmiller" ] || [ "$ACTOR" = "gitea-actions[bot]" ]; then
+            PERMISSION="admin"
+            ALLOWED="true"
+            METHOD="hardcoded allowlist"
+          else
+            # Check via Gitea API
+            RESULT=$(curl -sf -H "Authorization: token ${TOKEN}" \
+              "${GITEA_API}/repos/${REPO}/collaborators/${ACTOR}/permission" 2>/dev/null || echo '{}')
+            PERMISSION=$(echo "$RESULT" | jq -r '.permission // "unknown"')
+            if [ "$PERMISSION" = "admin" ] || [ "$PERMISSION" = "owner" ] || [ "$PERMISSION" = "maintain" ]; then
+              ALLOWED="true"
+            fi
+            METHOD="Gitea collaborator API"
+          fi
 
-            const lines = [
-              "## 🔐 Access Authorization",
-              "",
-              "| Field | Value |",
-              "|-------|-------|",
-              `| **Actor** | \`${actor}\` |`,
-              `| **Repository** | \`${context.repo.owner}/${context.repo.repo}\` |`,
-              `| **Permission** | \`${permission}\` |`,
-              `| **Method** | ${method} |`,
-              `| **Authorized** | ${allowed} |`,
-              `| **Trigger** | \`${context.eventName}\` |`,
-              `| **Branch** | \`${context.ref.replace('refs/heads/', '')}\` |`,
-              "",
-              allowed
-                ? `✅ ${actor} authorized (${method})`
-                : `❌ ${actor} is NOT authorized. Requires admin or maintain role, or be in the hardcoded allowlist.`,
-            ];
+          echo "permission=${PERMISSION}" >> "$GITHUB_OUTPUT"
+          echo "allowed=${ALLOWED}" >> "$GITHUB_OUTPUT"
 
-            await core.summary.addRaw(lines.join("\n")).write();
+          {
+            echo "## 🔐 Access Authorization"
+            echo ""
+            echo "| Field | Value |"
+            echo "|-------|-------|"
+            echo "| **Actor** | \`${ACTOR}\` |"
+            echo "| **Repository** | \`${REPO}\` |"
+            echo "| **Permission** | \`${PERMISSION}\` |"
+            echo "| **Method** | ${METHOD} |"
+            echo "| **Authorized** | ${ALLOWED} |"
+            echo "| **Trigger** | \`${{ github.event_name }}\` |"
+            echo "| **Branch** | \`${GITHUB_REF#refs/heads/}\` |"
+            echo ""
+            if [ "$ALLOWED" = "true" ]; then
+              echo "✅ ${ACTOR} authorized (${METHOD})"
+            else
+              echo "❌ ${ACTOR} is NOT authorized. Requires admin or maintain role."
+            fi
+          } >> "$GITHUB_STEP_SUMMARY"
 
       - name: Deny execution when not permitted
         if: ${{ steps.perm.outputs.allowed != 'true' }}

.github/workflows/repository-cleanup.yml

@@ -5,7 +5,7 @@
 # SPDX-License-Identifier: GPL-3.0-or-later
 #
 # FILE INFORMATION
-# DEFGROUP: GitHub.Workflow
+# DEFGROUP: Gitea.Workflow
 # INGROUP: MokoStandards.Maintenance
 # REPO: https://git.mokoconsulting.tech/MokoConsulting/MokoStandards
 # PATH: /templates/workflows/shared/repository-cleanup.yml.template
@@ -67,20 +67,20 @@ jobs:
       - name: Checkout repository
         uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
         with:
-          token: ${{ secrets.GH_TOKEN || github.token }}
+          token: ${{ secrets.GA_TOKEN || github.token }}
           fetch-depth: 0
 
       - name: Check actor permission
         env:
-          GH_TOKEN: ${{ secrets.GH_TOKEN || github.token }}
+          GH_TOKEN: ${{ secrets.GA_TOKEN || github.token }}
         run: |
           ACTOR="${{ github.actor }}"
-          # Schedule triggers use github-actions[bot]
+          # Schedule triggers use gitea-actions[bot]
           if [ "${{ github.event_name }}" = "schedule" ]; then
             echo "✅ Scheduled run — authorized"
             exit 0
           fi
-          AUTHORIZED_USERS="jmiller-moko github-actions[bot]"
+          AUTHORIZED_USERS="jmiller gitea-actions[bot]"
           for user in $AUTHORIZED_USERS; do
             if [ "$ACTOR" = "$user" ]; then
               echo "✅ ${ACTOR} authorized"
@@ -88,7 +88,7 @@ jobs:
             fi
           done
           PERMISSION=$(gh api "repos/${{ github.repository }}/collaborators/${ACTOR}/permission" \
-            --jq '.permission' 2>/dev/null)
+            2>/dev/null | jq -r '.permission')
           case "$PERMISSION" in
             admin|maintain) echo "✅ ${ACTOR} has ${PERMISSION}" ;;
             *) echo "❌ Admin or maintain required"; exit 1 ;;
@@ -170,11 +170,11 @@ jobs:
           done
 
           if [ "$DELETED" -gt 0 ]; then
-            git config --local user.email "github-actions[bot]@users.noreply.github.com"
-            git config --local user.name "github-actions[bot]"
+            git config --local user.email "gitea-actions[bot]@mokoconsulting.tech"
+            git config --local user.name "gitea-actions[bot]"
             git add -A
             git commit -m "chore: delete ${DELETED} retired workflow file(s) [skip ci]" \
-              --author="github-actions[bot] <github-actions[bot]@users.noreply.github.com>"
+              --author="gitea-actions[bot] <gitea-actions[bot]@mokoconsulting.tech>"
             git push
             echo "✅ ${DELETED} retired workflow(s) deleted" >> $GITHUB_STEP_SUMMARY
           else
@@ -185,20 +185,20 @@ jobs:
       - name: Reset labels to standard set
         if: steps.tasks.outputs.reset_labels == 'true'
         env:
-          GH_TOKEN: ${{ secrets.GH_TOKEN || github.token }}
+          GH_TOKEN: ${{ secrets.GA_TOKEN || github.token }}
         run: |
           REPO="${{ github.repository }}"
           echo "## 🏷️ Label Reset" >> $GITHUB_STEP_SUMMARY
           echo "" >> $GITHUB_STEP_SUMMARY
 
-          gh api "repos/${REPO}/labels?per_page=100" --paginate --jq '.[].name' | while read -r label; do
+          curl -sf -H "Authorization: token ${{ secrets.GA_TOKEN }}" "${{GITEA_URL:-https://git.mokoconsulting.tech}}/api/v1/repos/${{ github.repository }}/labels?per_page=100" 2>/dev/null | jq -r '.[].name' | while read -r label; do
             ENCODED=$(python3 -c "import urllib.parse; print(urllib.parse.quote('$label', safe=''))")
             gh api -X DELETE "repos/${REPO}/labels/${ENCODED}" --silent 2>/dev/null || true
           done
 
           while IFS='|' read -r name color description; do
             [ -z "$name" ] && continue
-            gh api "repos/${REPO}/labels" \
+            curl -sf -H "Authorization: token ${{ secrets.GA_TOKEN }}" "${{GITEA_URL:-https://git.mokoconsulting.tech}}/api/v1/repos/${{ github.repository }}/labels" 2>/dev/null \
               -f name="$name" -f color="$color" -f description="$description" \
               --silent 2>/dev/null || true
           done << 'LABELS'
@@ -267,7 +267,7 @@ jobs:
       - name: Delete old sync branches
         if: steps.tasks.outputs.clean_branches == 'true'
         env:
-          GH_TOKEN: ${{ secrets.GH_TOKEN || github.token }}
+          GH_TOKEN: ${{ secrets.GA_TOKEN || github.token }}
         run: |
           REPO="${{ github.repository }}"
           CURRENT="chore/sync-mokostandards-v04.05"
@@ -275,10 +275,10 @@ jobs:
           echo "" >> $GITHUB_STEP_SUMMARY
 
           FOUND=false
-          gh api "repos/${REPO}/branches?per_page=100" --jq '.[].name' | \
+          curl -sf -H "Authorization: token ${{ secrets.GA_TOKEN }}" "${{GITEA_URL:-https://git.mokoconsulting.tech}}/api/v1/repos/${{ github.repository }}/branches?per_page=100" | jq -r '.[].name' 2>/dev/null | \
             grep "^chore/sync-mokostandards" | \
             grep -v "^${CURRENT}$" | while read -r branch; do
-              gh pr list --repo "$REPO" --head "$branch" --state open --json number --jq '.[].number' 2>/dev/null | while read -r pr; do
+              gh pr list --repo "$REPO" --head "$branch" --state open --json number 2>/dev/null | jq -r '.[].number' | while read -r pr; do
                 gh pr close "$pr" --repo "$REPO" --comment "Superseded by \`${CURRENT}\`" 2>/dev/null || true
                 echo "  Closed PR #${pr}" >> $GITHUB_STEP_SUMMARY
               done
@@ -295,7 +295,7 @@ jobs:
       - name: Clean up workflow runs
         if: steps.tasks.outputs.clean_workflows == 'true'
         env:
-          GH_TOKEN: ${{ secrets.GH_TOKEN || github.token }}
+          GH_TOKEN: ${{ secrets.GA_TOKEN || github.token }}
         run: |
           REPO="${{ github.repository }}"
           echo "## 🔄 Workflow Run Cleanup" >> $GITHUB_STEP_SUMMARY
@@ -304,8 +304,8 @@ jobs:
           DELETED=0
           # Delete cancelled and stale workflow runs
           for status in cancelled stale; do
-            gh api "repos/${REPO}/actions/runs?status=${status}&per_page=100" \
-              --jq '.workflow_runs[].id' 2>/dev/null | while read -r run_id; do
+            curl -sf -H "Authorization: token ${{ secrets.GA_TOKEN }}" "${{GITEA_URL:-https://git.mokoconsulting.tech}}/api/v1/repos/${{ github.repository }}/actions/runs?status=${status}&per_page=100" 2>/dev/null \
+              2>/dev/null | jq -r '.workflow_runs[].id' | while read -r run_id; do
                 gh api -X DELETE "repos/${REPO}/actions/runs/${run_id}" --silent 2>/dev/null || true
                 DELETED=$((DELETED+1))
             done
@@ -317,7 +317,7 @@ jobs:
       - name: Delete old workflow run logs
         if: steps.tasks.outputs.clean_logs == 'true'
         env:
-          GH_TOKEN: ${{ secrets.GH_TOKEN || github.token }}
+          GH_TOKEN: ${{ secrets.GA_TOKEN || github.token }}
         run: |
           REPO="${{ github.repository }}"
           CUTOFF=$(date -u -d '30 days ago' +%Y-%m-%dT%H:%M:%SZ 2>/dev/null || date -u -v-30d +%Y-%m-%dT%H:%M:%SZ)
@@ -326,8 +326,8 @@ jobs:
           echo "Deleting logs older than: ${CUTOFF}" >> $GITHUB_STEP_SUMMARY
 
           DELETED=0
-          gh api "repos/${REPO}/actions/runs?created=<${CUTOFF}&per_page=100" \
-            --jq '.workflow_runs[].id' 2>/dev/null | while read -r run_id; do
+          curl -sf -H "Authorization: token ${{ secrets.GA_TOKEN }}" "${{GITEA_URL:-https://git.mokoconsulting.tech}}/api/v1/repos/${{ github.repository }}/actions/runs?created=<${CUTOFF}&per_page=100" 2>/dev/null \
+            2>/dev/null | jq -r '.workflow_runs[].id' | while read -r run_id; do
               gh api -X DELETE "repos/${REPO}/actions/runs/${run_id}/logs" --silent 2>/dev/null || true
               DELETED=$((DELETED+1))
           done
@@ -352,11 +352,11 @@ jobs:
           done
 
           if [ "$FIXED" -gt 0 ]; then
-            git config --local user.email "github-actions[bot]@users.noreply.github.com"
-            git config --local user.name "github-actions[bot]"
+            git config --local user.email "gitea-actions[bot]@mokoconsulting.tech"
+            git config --local user.name "gitea-actions[bot]"
             git add .github/ISSUE_TEMPLATE/
             git commit -m "fix: strip copyright comment blocks from issue templates [skip ci]" \
-              --author="github-actions[bot] <github-actions[bot]@users.noreply.github.com>"
+              --author="gitea-actions[bot] <gitea-actions[bot]@mokoconsulting.tech>"
             git push
             echo "✅ ${FIXED} template(s) cleaned and committed" >> $GITHUB_STEP_SUMMARY
           else
@@ -400,12 +400,12 @@ jobs:
           done
 
           if [ "$UPDATED" -gt 0 ]; then
-            git config --local user.email "github-actions[bot]@users.noreply.github.com"
-            git config --local user.name "github-actions[bot]"
+            git config --local user.email "gitea-actions[bot]@mokoconsulting.tech"
+            git config --local user.name "gitea-actions[bot]"
             git add docs/
             if ! git diff --cached --quiet; then
               git commit -m "docs: rebuild documentation indexes [skip ci]" \
-                --author="github-actions[bot] <github-actions[bot]@users.noreply.github.com>"
+                --author="gitea-actions[bot] <gitea-actions[bot]@mokoconsulting.tech>"
               git push
               echo "✅ ${UPDATED} index file(s) rebuilt and committed" >> $GITHUB_STEP_SUMMARY
             else
@@ -476,12 +476,12 @@ jobs:
           Synced workflows live in `.github/workflows/` (parent directory).
           CWEOF
             sed -i 's/^          //' .github/workflows/custom/README.md
-            git config --local user.email "github-actions[bot]@users.noreply.github.com"
-            git config --local user.name "github-actions[bot]"
+            git config --local user.email "gitea-actions[bot]@mokoconsulting.tech"
+            git config --local user.name "gitea-actions[bot]"
             git add .github/workflows/custom/
             if ! git diff --cached --quiet; then
               git commit -m "chore: create .github/workflows/custom/ for repo-specific workflows [skip ci]" \
-                --author="github-actions[bot] <github-actions[bot]@users.noreply.github.com>"
+                --author="gitea-actions[bot] <gitea-actions[bot]@mokoconsulting.tech>"
               git push
               echo "✅ Created \`.github/workflows/custom/\` directory" >> $GITHUB_STEP_SUMMARY
             fi
@@ -494,7 +494,7 @@ jobs:
       - name: Delete old closed issues
         if: steps.tasks.outputs.delete_closed_issues == 'true'
         env:
-          GH_TOKEN: ${{ secrets.GH_TOKEN || github.token }}
+          GH_TOKEN: ${{ secrets.GA_TOKEN || github.token }}
         run: |
           REPO="${{ github.repository }}"
           CUTOFF=$(date -u -d '30 days ago' +%Y-%m-%dT%H:%M:%SZ 2>/dev/null || date -u -v-30d +%Y-%m-%dT%H:%M:%SZ)
@@ -503,10 +503,10 @@ jobs:
           echo "Deleting issues closed before: ${CUTOFF}" >> $GITHUB_STEP_SUMMARY
 
           DELETED=0
-          gh api "repos/${REPO}/issues?state=closed&since=1970-01-01T00:00:00Z&per_page=100&sort=updated&direction=asc" \
-            --jq ".[] | select(.closed_at < \"${CUTOFF}\") | .number" 2>/dev/null | while read -r num; do
+          curl -sf -H "Authorization: token ${{ secrets.GA_TOKEN }}" "${{GITEA_URL:-https://git.mokoconsulting.tech}}/api/v1/repos/${{ github.repository }}/issues?state=closed&since=1970-01-01T00:00:00Z&per_page=100&sort=updated&direction=asc" 2>/dev/null \
+            | jq -r ".[] | select(.closed_at < \"${CUTOFF}\") | .number" 2>/dev/null | while read -r num; do
               # Lock and close with "not_planned" to mark as cleaned up
-              gh api "repos/${REPO}/issues/${num}/lock" -X PUT -f lock_reason="resolved" --silent 2>/dev/null || true
+              curl -sf -H "Authorization: token ${{ secrets.GA_TOKEN }}" "${{GITEA_URL:-https://git.mokoconsulting.tech}}/api/v1/repos/${{ github.repository }}/issues/${num}/lock" 2>/dev/null -X PUT -f lock_reason="resolved" --silent 2>/dev/null || true
               echo "  Locked issue #${num}" >> $GITHUB_STEP_SUMMARY
               DELETED=$((DELETED+1))
           done

.github/workflows/standards-compliance.yml

@@ -1,7 +1,7 @@
 # Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
 # SPDX-License-Identifier: GPL-3.0-or-later
 # FILE INFORMATION
-# DEFGROUP: GitHub.Workflow
+# DEFGROUP: Gitea.Workflow
 # INGROUP: MokoStandards.Compliance
 # REPO: https://git.mokoconsulting.tech/MokoConsulting/MokoStandards
 # PATH: /.github/workflows/standards-compliance.yml
@@ -497,17 +497,13 @@ jobs:
         uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
 
       - name: Set up PHP
-        uses: shivammathur/setup-php@accd6127cb78bee3e8082180cb391013d204ef9f # v2.31.0
-        with:
-          php-version: '8.1'
-          extensions: json
-          tools: composer
-          coverage: none
+        run: |
+          php -v && composer --version
 
       - name: Setup MokoStandards tools
         env:
-          GH_TOKEN: ${{ secrets.GH_TOKEN || github.token }}
-          COMPOSER_AUTH: '{"github-oauth":{"github.com":"${{ secrets.GH_TOKEN || github.token }}"}}'
+          GH_TOKEN: ${{ secrets.GA_TOKEN || github.token }}
+          COMPOSER_AUTH: '{"github-oauth":{"github.com":"${{ secrets.GA_TOKEN || github.token }}"}}'
         run: |
           git clone --depth 1 --branch version/04 --quiet \
             "https://x-access-token:${GH_TOKEN}@git.mokoconsulting.tech/MokoConsulting/MokoStandards.git" \
@@ -1333,9 +1329,8 @@ jobs:
         uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
 
       - name: Setup PHP
-        uses: shivammathur/setup-php@accd6127cb78bee3e8082180cb391013d204ef9f # v2.31.0
-        with:
-          php-version: '8.1'
+        run: |
+          php -v && composer --version
 
       - name: Analyze Complexity
         run: |
@@ -1376,9 +1371,8 @@ jobs:
         uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
 
       - name: Setup PHP
-        uses: shivammathur/setup-php@accd6127cb78bee3e8082180cb391013d204ef9f # v2.31.0
-        with:
-          php-version: '8.1'
+        run: |
+          php -v && composer --version
 
       - name: Detect Duplicates
         run: |
@@ -1632,9 +1626,8 @@ jobs:
         uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
 
       - name: Setup PHP
-        uses: shivammathur/setup-php@accd6127cb78bee3e8082180cb391013d204ef9f # v2.31.0
-        with:
-          php-version: '8.1'
+        run: |
+          php -v && composer --version
 
       - name: Setup Python
         uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6.2.0
@@ -1707,9 +1700,8 @@ jobs:
         uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
 
       - name: Setup PHP
-        uses: shivammathur/setup-php@accd6127cb78bee3e8082180cb391013d204ef9f # v2.31.0
-        with:
-          php-version: '8.1'
+        run: |
+          php -v && composer --version
 
       - name: Check Unused Dependencies
         run: |
@@ -1961,17 +1953,13 @@ jobs:
         uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
 
       - name: Set up PHP
-        uses: shivammathur/setup-php@accd6127cb78bee3e8082180cb391013d204ef9f # v2.31.0
-        with:
-          php-version: '8.1'
-          extensions: json, mbstring
-          tools: composer
-          coverage: none
+        run: |
+          php -v && composer --version
 
       - name: Install API Package
         env:
-          GH_TOKEN: ${{ secrets.GH_TOKEN || github.token }}
-          COMPOSER_AUTH: '{"github-oauth":{"github.com":"${{ secrets.GH_TOKEN || github.token }}"}}'
+          GH_TOKEN: ${{ secrets.GA_TOKEN || github.token }}
+          COMPOSER_AUTH: '{"github-oauth":{"github.com":"${{ secrets.GA_TOKEN || github.token }}"}}'
         run: |
           if [ -f "composer.json" ]; then
             composer install --no-dev --no-interaction --prefer-dist --optimize-autoloader
@@ -2033,17 +2021,13 @@ jobs:
         uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
 
       - name: Set up PHP
-        uses: shivammathur/setup-php@accd6127cb78bee3e8082180cb391013d204ef9f # v2.31.0
-        with:
-          php-version: '8.1'
-          extensions: json, mbstring
-          tools: composer
-          coverage: none
+        run: |
+          php -v && composer --version
 
       - name: Install API Package
         env:
-          GH_TOKEN: ${{ secrets.GH_TOKEN || github.token }}
-          COMPOSER_AUTH: '{"github-oauth":{"github.com":"${{ secrets.GH_TOKEN || github.token }}"}}'
+          GH_TOKEN: ${{ secrets.GA_TOKEN || github.token }}
+          COMPOSER_AUTH: '{"github-oauth":{"github.com":"${{ secrets.GA_TOKEN || github.token }}"}}'
         run: |
           if [ -f "composer.json" ]; then
             composer install --no-dev --no-interaction --prefer-dist --optimize-autoloader
@@ -2537,7 +2521,7 @@ jobs:
       - name: Create or reopen tracking issue for standards violations
         if: failure()
         env:
-          GH_TOKEN: ${{ secrets.GH_TOKEN || github.token }}
+          GH_TOKEN: ${{ secrets.GA_TOKEN || github.token }}
         run: |
           REPO="${{ github.repository }}"
           RUN_URL="${{ github.server_url }}/${REPO}/actions/runs/${{ github.run_id }}"
@@ -2592,16 +2576,16 @@ jobs:
 
           gh label create "$LABEL" --repo "$REPO" --color "D73A4A" --description "Standards compliance failure" --force 2>/dev/null || true
 
-          EXISTING=$(gh api "repos/${REPO}/issues?labels=${LABEL}&state=all&per_page=1&sort=created&direction=desc" \
-            --jq '.[0].number' 2>/dev/null)
+          EXISTING=$(curl -sf -H "Authorization: token ${{ secrets.GA_TOKEN }}" "${{GITEA_URL:-https://git.mokoconsulting.tech}}/api/v1/repos/${{ github.repository }}/issues?labels=${LABEL}&state=all&per_page=1&sort=created&direction=desc" 2>/dev/null \
+            2>/dev/null | jq -r '.[0].number')
 
           if [ -n "$EXISTING" ] && [ "$EXISTING" != "null" ]; then
-            gh api "repos/${REPO}/issues/${EXISTING}" -X PATCH \
+            curl -sf -H "Authorization: token ${{ secrets.GA_TOKEN }}" "${{GITEA_URL:-https://git.mokoconsulting.tech}}/api/v1/repos/${{ github.repository }}/issues/${EXISTING}" 2>/dev/null -X PATCH \
               -f title="$TITLE" -f body="$BODY" -f state="open" --silent
             echo "Updated issue #${EXISTING}"
           else
             gh issue create --repo "$REPO" --title "$TITLE" --body "$BODY" \
-              --label "$LABEL" --assignee "jmiller-moko"
+              --label "$LABEL" --assignee "jmiller"
           fi
 
 # CUSTOMIZATION:

.github/workflows/sync-version-on-merge.yml

@@ -5,7 +5,7 @@
 # SPDX-License-Identifier: GPL-3.0-or-later
 #
 # FILE INFORMATION
-# DEFGROUP: GitHub.Workflow
+# DEFGROUP: Gitea.Workflow
 # INGROUP: MokoStandards.Automation
 # REPO: https://git.mokoconsulting.tech/MokoConsulting/MokoStandards
 # PATH: /templates/workflows/shared/sync-version-on-merge.yml.template
@@ -46,19 +46,17 @@ jobs:
       - name: Checkout repository
         uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
         with:
-          token: ${{ secrets.GH_TOKEN || github.token }}
+          token: ${{ secrets.GA_TOKEN || github.token }}
           fetch-depth: 0
 
       - name: Set up PHP
-        uses: shivammathur/setup-php@fcafdd6392932010c2bd5094439b8e33be2a8a09 # v2.37.0
-        with:
-          php-version: '8.1'
-          tools: composer
+        run: |
+          php -v && composer --version
 
       - name: Setup MokoStandards tools
         env:
-          GH_TOKEN: ${{ secrets.GH_TOKEN || github.token }}
-          COMPOSER_AUTH: '{"github-oauth":{"github.com":"${{ secrets.GH_TOKEN || github.token }}"}}'
+          GH_TOKEN: ${{ secrets.GA_TOKEN || github.token }}
+          COMPOSER_AUTH: '{"github-oauth":{"github.com":"${{ secrets.GA_TOKEN || github.token }}"}}'
         run: |
           git clone --depth 1 --branch version/04 --quiet \
             "https://x-access-token:${GH_TOKEN}@git.mokoconsulting.tech/MokoConsulting/MokoStandards.git" \
@@ -67,7 +65,7 @@ jobs:
           composer install --no-dev --no-interaction --quiet
 
       - name: Auto-bump patch version
-        if: ${{ github.event_name != 'workflow_dispatch' && github.actor != 'github-actions[bot]' }}
+        if: ${{ github.event_name != 'workflow_dispatch' && github.actor != 'gitea-actions[bot]' }}
         run: |
           if git diff --name-only HEAD~1 HEAD 2>/dev/null | grep -q '^README\.md$'; then
             echo "README.md changed in this push — skipping auto-bump"
@@ -79,11 +77,11 @@ jobs:
             exit 0
           }
           echo "Auto-bumping patch: $RESULT"
-          git config --local user.email "github-actions[bot]@users.noreply.github.com"
-          git config --local user.name "github-actions[bot]"
+          git config --local user.email "gitea-actions[bot]@mokoconsulting.tech"
+          git config --local user.name "gitea-actions[bot]"
           git add README.md
           git commit -m "chore(version): auto-bump patch ${RESULT} [skip ci]" \
-            --author="github-actions[bot] <github-actions[bot]@users.noreply.github.com>"
+            --author="gitea-actions[bot] <gitea-actions[bot]@mokoconsulting.tech>"
           git push
 
       - name: Extract version from README.md
@@ -108,7 +106,7 @@ jobs:
             --create-issue \
             --repo "${{ github.repository }}"
         env:
-          GH_TOKEN: ${{ secrets.GH_TOKEN || github.token }}
+          GH_TOKEN: ${{ secrets.GA_TOKEN || github.token }}
 
       - name: Commit updated files
         if: ${{ steps.readme_version.outputs.skip != 'true' && inputs.dry_run != true }}
@@ -119,11 +117,11 @@ jobs:
             exit 0
           fi
           VERSION="${{ steps.readme_version.outputs.version }}"
-          git config --local user.email "github-actions[bot]@users.noreply.github.com"
-          git config --local user.name "github-actions[bot]"
+          git config --local user.email "gitea-actions[bot]@mokoconsulting.tech"
+          git config --local user.name "gitea-actions[bot]"
           git add -A
           git commit -m "chore(version): sync badges and headers to ${VERSION} [skip ci]" \
-            --author="github-actions[bot] <github-actions[bot]@users.noreply.github.com>"
+            --author="gitea-actions[bot] <gitea-actions[bot]@mokoconsulting.tech>"
           git push
 
       - name: Summary

.github/workflows/update-server.yml

@@ -3,7 +3,7 @@
 # SPDX-License-Identifier: GPL-3.0-or-later
 #
 # FILE INFORMATION
-# DEFGROUP: GitHub.Workflow
+# DEFGROUP: Gitea.Workflow
 # INGROUP: MokoStandards.Joomla
 # REPO: https://git.mokoconsulting.tech/MokoConsulting/MokoStandards
 # PATH: /templates/workflows/joomla/update-server.yml.template
@@ -53,7 +53,7 @@ permissions:
 jobs:
   update-xml:
     name: Update updates.xml
-    runs-on: ubuntu-latest
+    runs-on: release
     if: >-
       github.event.pull_request.merged == true || github.event_name == 'workflow_dispatch'
 
@@ -61,13 +61,13 @@ jobs:
       - name: Checkout repository
         uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
         with:
-          token: ${{ secrets.GH_TOKEN || github.token }}
+          token: ${{ secrets.GA_TOKEN || github.token }}
           fetch-depth: 0
 
       - name: Setup MokoStandards tools
         env:
-          GH_TOKEN: ${{ secrets.GH_TOKEN || github.token }}
-          COMPOSER_AUTH: '{"github-oauth":{"github.com":"${{ secrets.GH_TOKEN || github.token }}"}}'
+          GH_TOKEN: ${{ secrets.GA_TOKEN || github.token }}
+          COMPOSER_AUTH: '{"github-oauth":{"github.com":"${{ secrets.GA_TOKEN || github.token }}"}}'
         run: |
           git clone --depth 1 --branch version/04 --quiet \
             "https://x-access-token:${GH_TOKEN}@git.mokoconsulting.tech/MokoConsulting/MokoStandards.git" \
@@ -84,14 +84,14 @@ jobs:
 
           # Auto-bump patch on alpha/beta/rc branches (not dev — dev bumps manually)
           if [[ "$BRANCH" != dev/* ]]; then
-            git config --local user.email "github-actions[bot]@users.noreply.github.com"
-            git config --local user.name "github-actions[bot]"
+            git config --local user.email "gitea-actions[bot]@mokoconsulting.tech"
+            git config --local user.name "gitea-actions[bot]"
             BUMPED=$(php /tmp/mokostandards/api/cli/version_bump.php --path . 2>/dev/null || true)
             if [ -n "$BUMPED" ]; then
               VERSION=$(php /tmp/mokostandards/api/cli/version_read.php --path . 2>/dev/null || echo "$VERSION")
               git add -A
               git commit -m "chore(version): auto-bump patch ${VERSION} [skip ci]" \
-                --author="github-actions[bot] <github-actions[bot]@users.noreply.github.com>" 2>/dev/null || true
+                --author="gitea-actions[bot] <gitea-actions[bot]@mokoconsulting.tech>" 2>/dev/null || true
               git push 2>/dev/null || true
             fi
           fi
@@ -173,7 +173,7 @@ jobs:
           esac
 
           PACKAGE_NAME="${EXT_ELEMENT}-${DISPLAY_VERSION}.zip"
-          DOWNLOAD_URL="https://github.com/${REPO}/releases/download/${RELEASE_TAG}/${PACKAGE_NAME}"
+          DOWNLOAD_URL="https://git.mokoconsulting.tech/${{ github.repository }}/releases/download/${RELEASE_TAG}/${PACKAGE_NAME}"
           INFO_URL="https://github.com/${REPO}"
 
           # ── Build install packages (ZIP + tar.gz) ───────────────────
@@ -220,7 +220,7 @@ jobs:
           NEW_ENTRY="${NEW_ENTRY}    </tags>\n"
           NEW_ENTRY="${NEW_ENTRY}    <infourl title=\"${EXT_NAME}\">${INFO_URL}</infourl>\n"
           NEW_ENTRY="${NEW_ENTRY}    <downloads>\n"
-          TAR_URL="https://github.com/${REPO}/releases/download/${RELEASE_TAG}/${EXT_ELEMENT}-${DISPLAY_VERSION}.tar.gz"
+          TAR_URL="https://git.mokoconsulting.tech/${{ github.repository }}/releases/download/${RELEASE_TAG}/${EXT_ELEMENT}-${DISPLAY_VERSION}.tar.gz"
           NEW_ENTRY="${NEW_ENTRY}      <downloadurl type=\"full\" format=\"zip\">${DOWNLOAD_URL}</downloadurl>\n"
           NEW_ENTRY="${NEW_ENTRY}      <downloadurl type=\"full\" format=\"tar.gz\">${TAR_URL}</downloadurl>\n"
           NEW_ENTRY="${NEW_ENTRY}    </downloads>\n"
@@ -269,12 +269,12 @@ jobs:
           fi
 
           # Commit
-          git config --local user.email "github-actions[bot]@users.noreply.github.com"
-          git config --local user.name "github-actions[bot]"
+          git config --local user.email "gitea-actions[bot]@mokoconsulting.tech"
+          git config --local user.name "gitea-actions[bot]"
           git add updates.xml
           git diff --cached --quiet || {
             git commit -m "chore: update updates.xml (${STABILITY}: ${DISPLAY_VERSION}) [skip ci]" \
-              --author="github-actions[bot] <github-actions[bot]@users.noreply.github.com>"
+              --author="gitea-actions[bot] <gitea-actions[bot]@mokoconsulting.tech>"
             git push
           }
 
@@ -288,15 +288,15 @@ jobs:
           DEV_PORT: ${{ vars.DEV_FTP_PORT }}
           DEV_KEY: ${{ secrets.DEV_FTP_KEY }}
           DEV_PASS: ${{ secrets.DEV_FTP_PASSWORD }}
-          GH_TOKEN: ${{ secrets.GH_TOKEN || github.token }}
+          GH_TOKEN: ${{ secrets.GA_TOKEN || github.token }}
         run: |
           # ── Permission check: admin or maintain role required ──────
           ACTOR="${{ github.actor }}"
           REPO="${{ github.repository }}"
-          PERMISSION=$(gh api "repos/${REPO}/collaborators/${ACTOR}/permission" \
-            --jq '.permission' 2>/dev/null || \
-            gh api "repos/${REPO}/collaborators/${ACTOR}" \
-            --jq '.role' 2>/dev/null || echo "read")
+          PERMISSION=$(curl -sf -H "Authorization: token ${{ secrets.GA_TOKEN }}" "${{GITEA_URL:-https://git.mokoconsulting.tech}}/api/v1/repos/${{ github.repository }}/collaborators/${ACTOR}/permission" 2>/dev/null \
+            2>/dev/null | jq -r '.permission' || \
+            curl -sf -H "Authorization: token ${{ secrets.GA_TOKEN }}" "${{GITEA_URL:-https://git.mokoconsulting.tech}}/api/v1/repos/${{ github.repository }}/collaborators/${ACTOR}" 2>/dev/null \
+            2>/dev/null | jq -r '.role' || echo "read")
           case "$PERMISSION" in
             admin|maintain|write) ;;
             *)

.gitignore

@@ -198,5 +198,10 @@ venv/
 *.coverage
 hypothesis/
 
-src/media/css/theme/dark.custom.css
-src/media/css/theme/light.custom.css
+# Custom theme palettes (site-specific, not version controlled)
+# Note: src/templates/*.custom.css are STARTER templates (tracked)
+src/media/css/theme/*.custom.css
+src/media/css/theme/*.custom.min.css
+templates/*.custom.css
+update.xml
+.moko-standards

.moko-standards

@@ -1,20 +0,0 @@
-# Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
-# SPDX-License-Identifier: GPL-3.0-or-later
-# FILE INFORMATION
-# DEFGROUP: MokoStandards.Templates.Config
-# INGROUP: MokoStandards.Templates
-# REPO: https://git.mokoconsulting.tech/MokoConsulting/MokoStandards
-# PATH: /templates/configs/moko-standards.yml
-# VERSION: 04.01.00
-# BRIEF: Governance attachment template — synced to .moko-standards in every governed repository
-# NOTE: Tokens replaced at sync time: mokoconsulting-tech, MokoCassiopeia, waas-component, 04.00.04
-#
-# This file is managed automatically by MokoStandards bulk sync.
-# Do not edit manually — changes will be overwritten on the next sync.
-# To update governance settings, open a PR in MokoStandards instead:
-# https://git.mokoconsulting.tech/MokoConsulting/MokoStandards
-
-standards_source: "https://git.mokoconsulting.tech/MokoConsulting/MokoStandards"
-standards_version: "04.00.04"
-platform: "waas-component"
-governed_repo: "MokoConsulting/MokoCassiopeia"

CHANGELOG.md

@@ -19,6 +19,48 @@ All notable changes to the MokoCassiopeia Joomla template are documented in this
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [03.10.00] - 2026-04-18 — Bridge Release (MokoCassiopeia → MokoOnyx)
+
+### Important
+- **Template Rename** — MokoCassiopeia is being renamed to **MokoOnyx**. This bridge release automatically migrates your template settings, menu assignments, and files to the new name. MokoCassiopeia can be safely uninstalled after this update.
+
+### Added
+- **Offline page redesign** — Full-viewport background from Joomla offline_image or header background, glass card overlay, centered logo with glow, login accordion, copyright footer
+- **CSS variable click-to-copy** — Text containing `--variable-name` patterns is wrapped in clickable chips that copy to clipboard with toast notification
+- **Brand-aside 3-column layout** — Flex columns like top-a with card style
+- **mod_stats table layout** — Converted from definition list to semantic table
+- **Favicon multi-format support** — Now handles PNG, JPEG, GIF, WebP, BMP (not just PNG)
+- **Theme variables** — `--theme-fab-bg`, `--theme-fab-color`, `--theme-fab-btn-bg`, `--theme-fab-border`, `--offline-card-bg`
+- **Footer CSS variables** — Added to CSS Variables reference tab
+- **Bridge migration script** — `helper/bridge.php` handles automatic MokoCassiopeia → MokoOnyx migration
+- **Dedicated release runner** — Release workflows run on isolated `release` label runner
+- **Runner fleet** — 3 CI + 1 release runner (12 concurrent jobs)
+
+### Changed
+- **Gitea-primary CI/CD** — All workflows use Gitea API, GitHub is backup for stable/RC only
+- **Theme switcher** — Larger, bordered, theme-aware colors (off-white on dark, primary on light)
+- **Auto switch** — Red when off, green when on
+- **A11y toolbar** — Theme-aware colors for dark mode visibility
+- **Search button border** — Matches input border (`--input-border-color`)
+- **Offline message** — 0=hidden, 1=custom message, 2=system language string
+- **Light theme fonts** — Fixed trailing `)` syntax error, normalized quote style to match dark
+- **`--accent-color-secondary`** — Unified to `#6fb3ff` across both themes
+- **`--alert-color`** — Set to `#000` in light theme
+
+### Removed
+- Brand showcase tab (redundant with theme preview)
+- Position selectors for a11y/theme FAB (forced to bottom-right)
+- Custom theme CSS from git tracking (site-specific, gitignored)
+
+### Fixed
+- SHA-256 checksum format — Removed `sha256:` prefix (Joomla expects raw hex)
+- Favicon path resolution — Strips `#joomlaImage://` fragment, tries multiple path candidates
+- `REQUIRE_SIGNIN_VIEW` — Set to `false` for public release downloads
+- Release workflow — Uses Gitea API to update `updates.xml` on main (bypasses branch protection)
+- Language loading on offline page — `com_users` and core language files loaded explicitly
+
+---
+
 ## [Unreleased] - 2026-04-02
 
 ### Added

README.md

@@ -9,13 +9,15 @@
  INGROUP: MokoCassiopeia.Documentation
  REPO: https://git.mokoconsulting.tech/MokoConsulting/MokoCassiopeia
  FILE: ./README.md
- VERSION: 03.09.14
+ VERSION: 03.10.23
  BRIEF: Documentation for MokoCassiopeia template
  -->
 
-# MokoCassiopeia Template
+# MokoCassiopeia (Retired)
 
-**A Modern, Lightweight Joomla Template Based on Cassiopeia**
+> **This template has been retired and replaced by [MokoOnyx](https://git.mokoconsulting.tech/MokoConsulting/MokoOnyx).** MokoCassiopeia is no longer maintained. To migrate, install MokoOnyx from [Gitea Releases](https://git.mokoconsulting.tech/MokoConsulting/MokoOnyx/releases/tag/v01), set it as your default template, and visit any page — your settings will be imported automatically. Then uninstall MokoCassiopeia.
+
+**Retired — See [MokoOnyx](https://git.mokoconsulting.tech/MokoConsulting/MokoOnyx)**
 
 [![Version](https://img.shields.io/badge/version-03.09.07-blue.svg?logo=v&logoColor=white)](https://git.mokoconsulting.tech/MokoConsulting/MokoCassiopeia/releases/tag/v03)
 [![License](https://img.shields.io/badge/license-GPL--3.0--or--later-green.svg?logo=gnu&logoColor=white)](LICENSE)

composer.json

@@ -1,29 +1,30 @@
 {
-	"name": "mokoconsulting/mokocassiopeia",
-	"description": "MokoCassiopeia — Joomla site template based on Cassiopeia",
-	"type": "joomla-template",
-	"license": "GPL-3.0-or-later",
-	"authors": [
-		{
-			"name": "Jonathan Miller",
-			"email": "hello@mokoconsulting.tech"
-		}
-	],
-	"require": {
-		"php": ">=8.1"
-	},
-	"require-dev": {
-		"mokoconsulting-tech/enterprise": "^4.0"
-	},
-	"config": {
-		"sort-packages": true,
-		"optimize-autoloader": true,
-		"preferred-install": "dist"
-	},
-	"repositories": [
-		{
-			"type": "composer",
-			"url": "https://git.mokoconsulting.tech/api/packages/MokoConsulting/composer"
-		}
-	]
+    "name": "mokoconsulting/mokocassiopeia",
+    "description": "MokoCassiopeia \u00e2\u20ac\u201d Joomla site template based on Cassiopeia",
+    "type": "joomla-template",
+    "license": "GPL-3.0-or-later",
+    "authors": [
+        {
+            "name": "Jonathan Miller",
+            "email": "hello@mokoconsulting.tech"
+        }
+    ],
+    "require": {
+        "php": ">=8.1",
+        "ext-zip": "*"
+    },
+    "require-dev": {
+        "mokoconsulting-tech/enterprise": "^4.0"
+    },
+    "config": {
+        "sort-packages": true,
+        "optimize-autoloader": true,
+        "preferred-install": "dist"
+    },
+    "repositories": [
+        {
+            "type": "composer",
+            "url": "https://git.mokoconsulting.tech/api/packages/MokoConsulting/composer"
+        }
+    ]
 }

docs/ROADMAP.md

@@ -1,917 +1,31 @@
 <!--
- Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
+Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
 
- This file is part of a Moko Consulting project.
+This file is part of a Moko Consulting project.
 
- SPDX-License-Identifier: GPL-3.0-or-later
+SPDX-License-Identifier: GPL-3.0-or-later
 
- This program is free software; you can redistribute it and/or modify
- it under the terms of the GNU General Public License as published by
- the Free Software Foundation; either version 3 of the License, or
- (at your option) any later version.
- 
- This program is distributed in the hope that it will be useful,
- but WITHOUT ANY WARRANTY; without even the implied warranty of
- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- GNU General Public License for more details.
- 
- You should have received a copy of the GNU General Public License
- along with this program. If not, see <https://www.gnu.org/licenses/>.
-
-
- # FILE INFORMATION
- DEFGROUP: Joomla.Template.Site
- INGROUP: MokoCassiopeia.Documentation
- REPO: https://git.mokoconsulting.tech/MokoConsulting/moko-cassiopeia
- FILE: docs/ROADMAP.md
- VERSION: 03.09.03
- BRIEF: Version-specific roadmap for MokoCassiopeia template
- PATH: /docs/ROADMAP.md
+# FILE INFORMATION
+DEFGROUP: Joomla.Template.Site
+INGROUP: MokoCassiopeia.Documentation
+REPO: https://git.mokoconsulting.tech/MokoConsulting/MokoCassiopeia
+PATH: /docs/ROADMAP.md
+VERSION: 03.10.20
+BRIEF: Redirect to MokoOnyx roadmap
 -->
 
-# MokoCassiopeia Roadmap (VERSION: 03.09.03)
+# MokoCassiopeia Roadmap
 
-This document provides a comprehensive, version-specific roadmap for the MokoCassiopeia Joomla template, tracking feature evolution, current capabilities, and planned enhancements.
+**MokoCassiopeia has been renamed to MokoOnyx.** All future development continues under the MokoOnyx project.
 
-## Table of Contents
+See the [MokoOnyx Roadmap](https://git.mokoconsulting.tech/MokoConsulting/MokoOnyx/src/branch/dev/docs/ROADMAP.md) for all planned features and releases.
 
-- [Version Timeline](#version-timeline)
-  - [Past Releases](#past-releases)
-  - [Future Roadmap (5-Year Plan)](#future-roadmap-5-year-plan)
-- [Current Release (v03.06.03)](#current-release-v030603)
-- [Implemented Features](#implemented-features)
-- [Planned Features](#planned-features)
-- [Development Priorities](#development-priorities)
-- [Long-term Vision](#long-term-vision)
-- [External Resources](#external-resources)
+## Migration
 
----
+To migrate from MokoCassiopeia to MokoOnyx:
 
-## Version Timeline
-
-### Past Releases
-
-### v03.05.01 (2026-01-09) - Standards & Security
-**Status**: Released (CHANGELOG entry exists, code files pending version update)
-
-**Added**:
-- Dependency review workflow for vulnerability scanning
-- Standards compliance workflow for MokoStandards validation
-- Dependabot configuration for automated security updates
-- Documentation index (`docs/README.md`)
-
-**Changed**:
-- Removed custom CodeQL workflow (using GitHub's default setup)
-- Enforced repository compliance with MokoStandards
-- Improved security posture with automated scanning
-
-### v03.06.00 (2026-01-28) - Version Update
-**Status**: Current Release (in code)
-
-**Changed**:
-- Updated version to 03.06.00 across all files
-
-### v03.05.00 (2026-01-04) - Workflow & Governance
-**Status**: Mentioned in CHANGELOG (v03.05.00)
-
-**Added**:
-- `.github/workflows` directory structure
-- CODE_OF_CONDUCT.md from MokoStandards
-- CONTRIBUTING.md from MokoStandards
-
-**Changed**:
-- TODO items to be split to separate file (tracked)
-
-### v03.01.00 (2025-12-16) - CI/CD Foundation
-**Added**:
-- Initial GitHub Actions workflows
-
-### v03.00.00 (2025-12-09) - Font Awesome 7 Upgrade
-**Updated**:
-- Copyright headers to MokoCodingDefaults standards
-- Fixed color style injection in `index.php`
-- Upgraded Font Awesome 6 to Font Awesome 7 Free
-- Added Font Awesome 7 Free style fallback
-
-**Removed**:
-- Deprecated CODE_OF_CONDUCT.md
-- Deprecated CONTRIBUTING.md
-
-### v02.01.05 (2025-09-04) - CSS Refinement
-**Fixed**:
-- Removed vmbasic.css
-- Repaired template.css and colors_standard.css
-
-### v02.00.00 (2025-08-30) - Dark Mode & TOC
-**Major Features**:
-- **Dark Mode Toggle System**
-  - Frontend toggle switch with localStorage persistence
-  - Admin-configurable default mode
-  - CSS rules for light/dark themes
-  - JavaScript-powered mode switching
-
-- **Enhanced Template Parameters**
-  - Logo parameter support
-  - GTM container ID configuration
-  - Dark mode defaults in settings
-  - Updated metadata and copyright headers
-
-- **Expanded Table of Contents**
-  - Automatic TOC injection
-  - User-selectable placement (`toc-left` or `toc-right`)
-  - Article options integration
-
-**Improvements**:
-- Cleaned up `index.php` (removed duplicate skip-to-content calls)
-- Consolidated JavaScript asset loading
-- Streamlined CSS for toggle switch
-- Accessibility refinements (typography, color contrast)
-- Fixed missing logo parameter in header
-- Corrected stylesheet inconsistencies
-- Patched redundant script includes
-
-### v01.00.00 - Initial Public Release
-**Core Features**:
-- Font Awesome 6 integration
-- Bootstrap 5 helpers and utilities
-- Automatic Table of Contents (TOC) utility
-- Moko Expansions: Google Tag Manager / GA4 hooks
-- Built on Joomla's Cassiopeia template
-
----
-
-### Future Roadmap (5-Year Plan)
-
-The following versions represent our planned annual major releases, each building upon the previous version's foundation.
-
-#### v04.00.00 (Q4 2027) - Enhanced Accessibility & Performance
-**Status**: Planned  
-**Target Release**: December 2027
-
-**Major Template Features**:
-- **WCAG 2.1 AA Compliance**
-  - Full accessibility audit and remediation
-  - High-contrast theme options
-  - Screen reader optimizations
-  - Keyboard navigation enhancements
-  - ARIA landmark improvements
-  - Skip navigation enhancements
-
-- **Template Performance Optimizations**
-  - Critical CSS inlining for faster first paint
-  - Lazy loading for images and below-fold content
-  - WebP image support with automatic fallbacks
-  - Advanced asset bundling and minification
-  - Template asset caching (CSS/JS bundles)
-
-- **Enhanced Layout System**
-  - Additional responsive grid layouts
-  - Flexible module position system
-  - Column layout presets (2-col, 3-col, 4-col variations)
-  - Grid/masonry article layouts
-  - Sticky sidebar options
-
-- **Typography Enhancements**
-  - Advanced typography controls in template settings
-  - Additional font pairing presets
-  - Custom font upload support
-  - Line height and letter spacing controls
-  - Responsive typography scaling
-
-- **Developer Experience**
-  - Development mode enablement (unminified assets, debug output)
-  - Live reload during development
-  - Enhanced error logging and diagnostics
-  - Template debugging tools
-  - Style guide generator
-
-- **Content Display Features**
-  - Soft offline mode (category-based access during maintenance)
-  - Enhanced article layouts (grid, masonry, timeline)
-  - Image caption styling options
-  - Quote block styling variations
-  - Enhanced breadcrumb customization
-
-**Template Infrastructure**:
-- Expanded template parameter validation
-- Enhanced template override detection
-- Automated template compatibility testing
-- Template performance profiling tools
-
----
-
-#### v05.00.00 (Q4 2028) - Advanced Layouts & Template Customization
-**Status**: Planned  
-**Target Release**: December 2028
-
-**Major Template Features**:
-- **Enhanced Layout Builder**
-  - Template-based page layout variations
-  - Configurable layout options via template parameters
-  - Layout presets library (blog, portfolio, business, magazine)
-  - Module position layout manager
-  - Visual layout preview in admin
-
-- **Advanced Styling System**
-  - Extended color palette management (unlimited custom palettes)
-  - CSS variable editor in template settings
-  - Style presets for different site types
-  - Border radius and spacing controls
-  - Box shadow and effect controls
-
-- **Template Component Enhancements**
-  - Enhanced menu styling options (mega menu support)
-  - Advanced header variations (transparent, sticky, minimal)
-  - Footer layout options (column variations, widgets)
-  - Sidebar styling and behavior options
-  - Hero section templates and variations
-
-- **Content Display Options**
-  - Article intro/full text display controls
-  - Category layout variations (grid, list, masonry, cards)
-  - Featured content sections
-  - Related articles display options
-  - Author bio box styling
-
-- **Responsive Design Improvements**
-  - Mobile-first navigation patterns
-  - Tablet-specific layout controls
-  - Responsive image sizing options
-  - Mobile header variations
-  - Touch-friendly interface elements
-
-- **Template Integration Features**
-  - Enhanced VirtueMart template overrides
-  - Contact form styling variations
-  - Search result layout options
-  - Error page customization
-  - Archive page templates
-
-**Template Infrastructure**:
-- Joomla 6.x template compatibility (if released)
-- PHP 8.2+ support
-- Template child theme support
-- Template preset import/export functionality
-
----
-
-#### v06.00.00 (Q4 2029) - Template Extensions & Advanced Features
-**Status**: Planned  
-**Target Release**: December 2029
-
-**Major Template Features**:
-- **Template Marketplace & Extensions**
-  - Template addon system for modular features
-  - Community-contributed template extensions
-  - Template preset marketplace
-  - Style pack distribution system
-  - Template component library
-
-- **Advanced Module System**
-  - Custom module chrome options
-  - Module animation effects
-  - Module visibility controls (scroll, time-based)
-  - Module group management
-  - Module style inheritance
-
-- **Enhanced Media Handling**
-  - Background image options per page/section
-  - Image overlay controls
-  - Parallax scrolling effects
-  - Video background support
-  - Gallery template variations
-
-- **Template Branding Options**
-  - Multiple logo upload (standard, retina, mobile)
-  - Favicon and app icon management
-  - Custom loading screen/animations
-  - Watermark options
-  - Brand color scheme generator
-
-- **Advanced Header/Footer**
-  - Multiple header layout presets
-  - Sticky header variations and behaviors
-  - Header transparency controls
-  - Footer widget areas expansion
-  - Floating action buttons
-
-- **Content Enhancement Features**
-  - Reading progress indicator
-  - Social sharing buttons (template-integrated)
-  - Print-friendly styles
-  - Reading time estimation display
-  - Content table enhancements
-
-- **Template SEO Features**
-  - Schema markup templates for common types
-  - Open Graph tag management
-  - Twitter Card support
-  - Breadcrumb schema integration
-  - Meta tag template controls
-
-**Template Infrastructure**:
-- Template versioning system
-- Template backup/restore functionality
-- Template A/B testing support
-- Multi-language template variations
-- Template documentation generator
-
----
-
-#### v07.00.00 (Q4 2030) - Modern Template Standards & Enhancements
-**Status**: Planned  
-**Target Release**: December 2030
-
-**Major Template Features**:
-- **Modern CSS Features**
-  - CSS Grid layout system integration
-  - CSS Container Queries support
-  - CSS Cascade Layers implementation (layered style priority system)
-  - Custom properties (CSS variables) UI
-  - Modern filter and backdrop effects
-
-- **Progressive Template Features**
-  - Offline-capable template assets
-  - Service worker template integration
-  - App manifest generation
-  - Install to home screen support
-  - Template asset preloading strategies
-
-- **Animation & Interaction**
-  - Scroll-triggered animations
-  - Hover effect library
-  - Page transition effects
-  - Micro-interactions for UI elements
-  - Loading animation options
-
-- **Advanced Responsive Features**
-  - Container-based responsive design
-  - Element visibility by viewport
-  - Responsive navigation patterns library
-  - Mobile-optimized interactions
-  - Adaptive image loading
-
-- **Template Accessibility Features**
-  - Focus indicators customization
-  - Reduced motion preferences support
-  - High contrast mode automation
-  - Keyboard navigation patterns
-  - ARIA live regions for dynamic content
-
-- **Content Presentation**
-  - Advanced blockquote styles
-  - Code snippet highlighting themes
-  - Table styling variations
-  - List styling options
-  - Custom content block templates
-
-- **Template Performance**
-  - Resource hints (preconnect, prefetch)
-  - Optimal asset delivery strategies
-  - Image format optimization (AVIF support)
-  - Font loading optimization
-  - Template metrics dashboard
-
-**Template Infrastructure**:
-- Template pattern library
-- Design token system
-- Template component documentation
-- Automated template testing suite
-- Template performance monitoring
-
----
-
-#### v08.00.00 (Q4 2031) - Next-Generation Template Features
-**Status**: Conceptual  
-**Target Release**: December 2031
-
-**Major Template Features**:
-- **Advanced Layout Systems**
-  - Subgrid support for complex layouts
-  - Multi-column layout variations
-  - Asymmetric grid systems
-  - Dynamic layout switching
-  - Layout constraint system
-
-- **Enhanced Visual Customization**
-  - Real-time style editor
-  - Template style variations manager
-  - Custom CSS injection with validation
-  - Style inheritance and override system
-  - Visual design tokens editor
-
-- **Template Component Library**
-  - Comprehensive UI component set
-  - Reusable template blocks
-  - Component variation system
-  - Template snippet library
-  - Pattern library integration
-
-- **Advanced Typography System**
-  - Variable font support
-  - Advanced typographic scales
-  - Font pairing recommendations
-  - Fluid typography system
-  - Custom font fallback chains
-
-- **Template Integration Features**
-  - Enhanced component overrides
-  - Template hooks system
-  - Event-based template modifications
-  - Custom field rendering templates
-  - Module position API enhancements
-
-- **Responsive & Adaptive Design**
-  - Advanced breakpoint management
-  - Element-specific responsive controls
-  - Adaptive images with art direction
-  - Responsive typography system
-  - Context-aware component rendering
-
-- **Template Ecosystem**
-  - Child template framework
-  - Template derivative system
-  - Community template marketplace
-  - Template rating and review system
-  - Professional template support network
-
-- **Template Quality & Maintenance**
-  - Automated accessibility testing
-  - Template performance auditing
-  - Code quality monitoring
-  - Update notification system
-  - Template health dashboard
-
-**Template Infrastructure**:
-- Template API for extensibility
-- Template package manager
-- Template development CLI tools
-- Template migration utilities
-- Comprehensive template documentation system
-
----
-
-## Current Release (v03.06.03)
-
-### System Requirements
-- **Joomla**: 4.4.x or 5.x
-- **PHP**: 8.0+
-- **Database**: MySQL/MariaDB compatible
-
-### Architecture
-- **Base Template**: Joomla Cassiopeia
-- **Enhancement Layer**: Non-invasive overrides
-- **Asset Management**: Joomla Web Asset Manager (WAM)
-- **Frontend Framework**: Bootstrap 5
-- **Icon Library**: Font Awesome 7 Free
-
----
-
-## Implemented Features
-
-### 🎨 Theming & Visual Design
-
-#### Color Palette System
-- **3 Built-in Palettes**: Standard, Alternative, Custom
-- **Dual Mode Support**: Separate light and dark configurations
-- **Custom Palettes**: User-definable via `colors_custom.css`
-- **Location**: `src/media/css/colors/{light|dark}/`
-
-#### Dark Mode System
-- **Toggle Controls**: Switch (Light↔Dark) or Radios (Light/Dark/System)
-- **Default Mode**: Admin-configurable (system, light, or dark)
-- **Persistence**: localStorage for user preferences
-- **Auto-Detection**: Optional system preference detection
-- **Meta Tags**: `color-scheme` and `theme-color` support
-- **ARIA Bridge**: Bootstrap ARIA compatibility
-
-#### Typography
-- **Font Schemes**:
-  - Local: Roboto
-  - Web (Google Fonts): Fira Sans, Roboto + Noto Sans
-- **Admin-Configurable**: Template settings dropdown
-
-#### Branding
-- **Logo Support**: Custom logo upload
-- **Site Title**: Text-based branding option
-- **Site Description**: Tagline/subtitle field
-- **Font Awesome Kit**: Optional custom kit integration
-
-### 📐 Layout & Structure
-
-#### Module Positions (23 Total)
-**Header Area**:
-- topbar, below-topbar, below-logo, menu, search, banner
-
-**Content Area**:
-- top-a, top-b, main-top, main-bottom, breadcrumbs
-- sidebar-left, sidebar-right
-
-**Footer Area**:
-- bottom-a, bottom-b, footer-menu, footer
-
-**Special**:
-- debug, offline-header, offline, offline-footer
-- drawer-left, drawer-right
-
-#### Layout Options
-- **Container Type**: Fluid or Static
-- **Sticky Header**: Optional fixed navigation
-- **Back-to-Top Button**: Scrollable page support
-
-### 📝 Content Features
-
-#### Table of Contents (TOC)
-- **Automatic Generation**: From article headings
-- **Placement Options**: `toc-left` or `toc-right` layouts
-- **Article Integration**: Via Options → Layout dropdown
-- **Responsive**: Mobile-friendly sidebar placement
-
-#### Article Layouts
-- **Default**: Standard Cassiopeia layout
-- **TOC Variants**: Left-sidebar or right-sidebar TOC
-- **Custom Overrides**: Located in `html/com_content/article/`
-
-### 📊 Analytics & Tracking
-
-#### Google Tag Manager (GTM)
-- **Enable/Disable**: Admin toggle
-- **Container ID**: Template parameter field
-- **Implementation**: Head and body script injection
-- **GDPR-Ready**: Configurable consent defaults
-
-#### Google Analytics 4 (GA4)
-- **Enable/Disable**: Admin toggle
-- **Property ID**: Template parameter field
-- **Universal Analytics Fallback**: Legacy UA support
-- **Privacy-First**: Conditional loading based on settings
-
-### 🎛️ Customization & Developer Tools
-
-#### Custom Code Injection
-- **Head Start**: Custom HTML/JS before `</head>`
-- **Head End**: Custom HTML/JS at end of `<head>`
-- **Raw HTML**: Unfiltered code injection for advanced users
-
-#### Drawer System
-- **Left/Right Drawers**: Offcanvas menu areas
-- **Icon Customization**: Font Awesome icon selection
-- **Default Icons**:
-  - Left: `fa-solid fa-chevron-right`
-  - Right: `fa-solid fa-chevron-left`
-
-#### Asset Management
-- **Joomla WAM**: Complete asset registry in `joomla.asset.json`
-- **Development/Production Modes**: Minified and unminified assets
-- **Dependency Management**: Automatic script/style loading
-
-### 🏗️ Template Overrides
-
-#### Component Overrides
-**Content (com_content)**:
-- Article layouts (default, toc-left, toc-right)
-- Category layouts (blog, list)
-- Featured articles
-
-**Contact (com_contact)**:
-- Contact form layouts
-
-**Engage (com_engage)**:
-- Comment system integration
-
-#### Module Overrides
-**Menu (mod_menu)**:
-- Metis dropdown menu
-- Offcanvas navigation
-
-**VirtueMart**:
-- Product display (`mod_virtuemart_product`)
-- Shopping cart (`mod_virtuemart_cart`)
-- Manufacturer display (`mod_virtuemart_manufacturer`)
-- Category display (`mod_virtuemart_category`)
-- Currency selector (`mod_virtuemart_currencies`)
-
-**Other Modules**:
-- Custom HTML (`mod_custom`)
-- GABble social integration (`mod_gabble`)
-
-**Membership System (OS Membership)**:
-- Plan layouts (default, pricing tables)
-- Member management interfaces
-
-### 🔧 Configuration Parameters
-
-#### Theme Tab
-**General**:
-- `theme_enabled` - Enable/disable theme system
-- `theme_control_type` - Toggle UI type (switch/radios/none)
-- `theme_default_choice` - Default mode (system/light/dark)
-- `theme_auto_dark` - Auto-detect system preference
-- `theme_meta_color_scheme` - Inject `color-scheme` meta tag
-- `theme_meta_theme_color` - Inject `theme-color` meta tag
-- `theme_bridge_bs_aria` - Bootstrap ARIA compatibility
-
-**Variables & Palettes**:
-- `colorLightName` - Light mode color scheme
-- `colorDarkName` - Dark mode color scheme
-
-**Typography**:
-- `useFontScheme` - Font selection (local/web)
-
-**Branding & Icons**:
-- `brand` - Show/hide branding
-- `logoFile` - Logo upload path
-- `siteTitle` - Site title text
-- `siteDescription` - Site tagline
-- `fA6KitCode` - Font Awesome kit code
-
-**Header & Navigation**:
-- `stickyHeader` - Fixed navigation
-- `backTop` - Back-to-top button
-
-**Toggle UI**:
-- `theme_fab_enabled` - Floating action button for theme toggle
-- `theme_fab_pos` - FAB position (br/bl/tr/tl)
-
-#### Google Tab
-- `googletagmanager` - Enable GTM
-- `googletagmanagerid` - GTM container ID
-- `googleanalytics` - Enable GA4
-- `googleanalyticsid` - GA4 property ID
-
-#### Custom Code Tab
-- `custom_head_start` - Custom code at head start
-- `custom_head_end` - Custom code at head end
-
-#### Drawers Tab
-- `drawerLeftIcon` - Left drawer icon (Font Awesome class)
-- `drawerRightIcon` - Right drawer icon (Font Awesome class)
-
-#### Advanced Tab
-- `fluidContainer` - Container layout (static/fluid)
-
-### 🛠️ Development Tools
-
-#### Quality Assurance
-- **Codeception**: Automated testing framework
-- **PHPStan**: Static analysis (level 8+)
-- **PHPCS**: Code style validation (PSR-12)
-- **PHPCompatibility**: PHP 8.0+ compatibility checks
-
-#### CI/CD Workflows
-- **Dependency Review**: Vulnerability scanning
-- **Standards Compliance**: MokoStandards validation
-- **CodeQL**: Security analysis (GitHub default)
-- **Dependabot**: Automated dependency updates
-
-#### Documentation
-- **Quick Start**: 5-minute developer setup
-- **Workflow Guide**: Git strategy, branching, releases
-- **Joomla Development**: Testing, packaging, multi-version support
-
----
-
-## Planned Features
-
-### 🚧 In Development
-
-#### Soft Offline Mode (v03.07.00 - Planned)
-**Status**: Planned for v03.07.00  
-**Priority**: High  
-**Description**: Keep selected categories accessible during site maintenance mode with persistent links to essential pages
-
-**Use Cases**:
-- Legal documents remain viewable during downtime
-- Policy pages accessible for compliance requirements
-- Terms of service always available to users
-- Privacy policy accessible at all times
-- Essential public information during maintenance
-
-**Technical Specifications**:
-- **Configuration Method**: Template parameters in `templateDetails.xml`
-- **Category Access**: Category IDs stored as comma-separated values
-- **Persistent Links**: Direct article/menu item links always visible
-- **Access Control**: Check in `offline.php` template file
-- **Content Rendering**: Use Joomla's content component to fetch articles
-- **Security**: Maintain proper access levels and permissions
-
-**Implementation Plan**:
-1. Add category selection field to template parameters
-2. Add persistent link configuration (Terms of Service, Privacy Policy, etc.)
-3. Modify `offline.php` to check for allowed categories
-4. Add persistent link display in offline mode header/footer
-5. Implement category content fetching during offline mode
-6. Add styling for offline mode category display and persistent links
-7. Test with various category and link configurations
-8. Document admin configuration steps
-
-**Configuration Interface**:
-- **Category Field Type**: Category multiselect in template settings
-  - **Label**: "Categories Accessible During Offline Mode"
-  - **Default**: None (all content hidden by default)
-- **Persistent Links**: Text fields for essential always-available links
-  - **Terms of Service URL**: Direct link to TOS article/page
-  - **Privacy Policy URL**: Direct link to privacy policy
-  - **Contact URL**: Optional contact page link
-  - **Custom Link 1-3**: Additional persistent links if needed
-- **Admin Path**: System → Site Templates → MokoCassiopeia → Advanced → Offline Mode Settings
-
-**Persistent Links Feature**:
-- **Display Location**: Footer of offline page
-- **Styling**: Clearly visible, accessible links
-- **Format**: "Terms of Service | Privacy Policy | Contact"
-- **Behavior**: Links bypass offline mode restrictions
-- **Validation**: Check if URLs are valid Joomla routes
-
-**Benefits**:
-- ✅ Compliance: Keep legal pages accessible
-- ✅ Transparency: Users can access essential information
-- ✅ Flexibility: Admin control over which categories remain visible
-- ✅ Security: Respects Joomla access levels
-- ✅ Legal Protection: Terms of Service always accessible
-- ✅ User Trust: Privacy policy always available
-
-**Milestone**: Target release v03.07.00 (Q2 2026)
-
-#### TODO Tracking System
-**Status**: Mentioned in CHANGELOG (v03.05.00)  
-**Description**: Separate TODO tracking file  
-**Purpose**: Centralized issue and feature tracking outside changelog
-
-### 🔮 Future Enhancements
-
-#### Development Mode (Commented Out)
-**Status**: Code exists but disabled  
-**Location**: `templateDetails.xml` line 91  
-**Description**: Comprehensive development mode toggle  
-**Potential Features**:
-- Unminified asset loading
-- Debug output
-- Performance profiling
-- Template cache bypass
-
-#### Potential Features (Community Requested)
-*Note: These are conceptual and not yet officially planned*
-
-**Enhanced Accessibility**:
-- WCAG 2.1 AAA compliance mode
-- High-contrast themes
-- Screen reader optimizations
-- Keyboard navigation improvements
-
-**Template Layout Features**:
-- Advanced responsive grid layouts
-- Multiple column variations
-- Custom module position system
-- Layout preset library
-
-**Template Styling Features**:
-- Extended color palette management
-- Custom font upload support
-- Typography scale controls
-- Visual style editor
-
----
-
-## Development Priorities
-
-### Immediate Focus (v03.x - 2026)
-1. **Bootstrap TOC Integration**: Complete and document v1.0.1 implementation ✅
-2. **Soft Offline Mode**: Implement category-based offline access (Target: v03.07.00)
-3. **TODO Tracking System**: Implement separate file for issue tracking
-4. **Security Updates**: Maintain Dependabot and CodeQL scans
-5. **Documentation**: Keep docs synchronized with features
-6. **Bug Fixes**: Address reported issues and edge cases
-
-### v04.00.00 Priorities (2027) - Template Foundation
-1. **WCAG 2.1 AA Compliance**: Full template accessibility audit and implementation
-2. **Template Performance**: Critical CSS, lazy loading, WebP support
-3. **Layout System**: Enhanced responsive grid and module positions
-4. **Development Mode**: Enable comprehensive template developer tools
-
-### v05.00.00 Priorities (2028) - Template Customization
-1. **Layout Builder**: Template-based page layout system
-2. **Styling System**: Extended color palettes and CSS variable management
-3. **Template Components**: Enhanced header, footer, and menu variations
-4. **Responsive Design**: Mobile-first navigation and layout improvements
-
-### v06.00.00 Priorities (2029) - Template Extensions
-1. **Template Marketplace**: Addon system and community extensions
-2. **Module System**: Advanced module chrome and animation options
-3. **Media Handling**: Background images, parallax, video backgrounds
-4. **Template SEO**: Schema markup templates and meta tag controls
-
-### v07.00.00+ Priorities (2030+) - Modern Standards
-1. **Modern CSS**: Grid, Container Queries, Cascade Layers
-2. **Progressive Template**: Offline-capable assets and PWA features
-3. **Animation System**: Scroll-triggered effects and micro-interactions
-4. **Template Performance**: Advanced optimization and monitoring
-
----
-
-## Long-term Vision
-
-### Mission Statement
-MokoCassiopeia aims to be the **most developer-friendly, user-customizable, and standards-compliant Joomla template** while maintaining minimal core overrides for maximum upgrade compatibility.
-
-### Core Principles
-1. **Non-Invasive**: Minimal Cassiopeia overrides
-2. **Standards-First**: MokoStandards compliance
-3. **Accessibility**: WCAG 2.1 compliance
-4. **Performance**: Fast, optimized delivery
-5. **Developer Experience**: Clear docs, easy setup, powerful tools
-6. **Template-Focused**: Pure template features without complex external dependencies
-
-### 5-Year Strategic Roadmap (Template Features)
-
-#### 2027 (v04.00.00) - Accessibility & Performance
-- Achieve WCAG 2.1 AA compliance for all template elements
-- Implement critical template performance optimizations
-- Enhance template layout system with flexible grids
-- Enable comprehensive development mode for template developers
-
-#### 2028 (v05.00.00) - Layouts & Customization
-- Launch template-based layout builder system
-- Deploy extended styling and customization options
-- Enhance template component variations (headers, footers, menus)
-- Improve responsive design patterns for all devices
-
-#### 2029 (v06.00.00) - Extensions & Enhancements
-- Introduce template addon and extension system
-- Launch template preset marketplace
-- Deploy advanced module styling and animation features
-- Implement comprehensive template SEO controls
-
-#### 2030 (v07.00.00) - Modern Standards
-- Adopt modern CSS standards (Grid, Container Queries, Cascade Layers)
-- Implement progressive template features (PWA support)
-- Deploy advanced animation and interaction system
-- Enhance template performance monitoring and optimization
-
-#### 2031 (v08.00.00) - Next-Generation Template
-- Advanced layout systems with subgrid support
-- Comprehensive template component library
-- Enhanced visual customization tools
-- Template ecosystem with child themes and derivatives
-
----
-
-## External Resources
-
-### Official Links
-- **Full Roadmap**: [https://mokoconsulting.tech/support/joomla-cms/mokocassiopeia-roadmap](https://mokoconsulting.tech/support/joomla-cms/mokocassiopeia-roadmap)
-- **Repository**: [https://git.mokoconsulting.tech/MokoConsulting/moko-cassiopeia](https://git.mokoconsulting.tech/MokoConsulting/moko-cassiopeia)
-- **Issue Tracker**: [GitHub Issues](https://git.mokoconsulting.tech/MokoConsulting/moko-cassiopeia/issues)
-- **Changelog**: [CHANGELOG.md](../CHANGELOG.md)
-
-### Community
-- **Email Support**: hello@mokoconsulting.tech
-- **Contributing**: [CONTRIBUTING.md](../CONTRIBUTING.md)
-- **Code of Conduct**: [CODE_OF_CONDUCT.md](../CODE_OF_CONDUCT.md)
-
-### Documentation
-- **Quick Start**: [docs/QUICK_START.md](./QUICK_START.md)
-- **Workflow Guide**: [docs/WORKFLOW_GUIDE.md](./WORKFLOW_GUIDE.md)
-- **Joomla Development**: [docs/JOOMLA_DEVELOPMENT.md](./JOOMLA_DEVELOPMENT.md)
-- **Main README**: [README.md](../README.md)
-
----
-
-## Contributing to the Roadmap
-
-Have ideas for future features? We welcome community input!
-
-**How to Suggest Features**:
-1. Check the [GitHub Issues](https://git.mokoconsulting.tech/MokoConsulting/moko-cassiopeia/issues) for existing requests
-2. Open a new issue with the `enhancement` label
-3. Provide clear use cases and benefits
-4. Engage in community discussion
-
-**Feature Evaluation Criteria**:
-- Alignment with core principles
-- User demand and use cases
-- Technical feasibility
-- Maintenance burden
-- Performance impact
-- Security implications
-
----
-
-## Metadata
-
-* Document: docs/ROADMAP.md
-* Repository: [https://git.mokoconsulting.tech/MokoConsulting/MokoCassiopeia](https://git.mokoconsulting.tech/MokoConsulting/MokoCassiopeia)
-* Path: /docs/ROADMAP.md
-* Owner: Moko Consulting
-* Version: 03.06.03
-* Status: Active
-* Effective Date: 2026-01-30
-* Classification: Public Open Source Documentation
-
-## Revision History
-
-| Date       | Change Summary                                        | Author          |
-| ---------- | ----------------------------------------------------- | --------------- |
-| 2026-01-27 | Initial version-specific roadmap generated from codebase scan. | GitHub Copilot |
-| 2026-01-27 | Added 5-year future roadmap with annual major version releases (v04-v08). | GitHub Copilot |
-| 2026-01-27 | Refocused roadmap to concentrate on template-oriented features only. | GitHub Copilot |
+1. Download MokoOnyx from [Gitea Releases](https://git.mokoconsulting.tech/MokoConsulting/MokoOnyx/releases/tag/v01)
+2. Install via **System → Install → Extensions**
+3. Set MokoOnyx as default in **System → Site Templates**
+4. Visit any frontend page — settings are imported automatically
+5. Uninstall MokoCassiopeia from **Extensions → Manage**

src/helper/favicon.php

@@ -1,6 +1,6 @@
 <?php
 /**
- * Copyright (C) 2025 Moko Consulting <hello@mokoconsulting.tech>
+ * Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
  *
  * This file is part of a Moko Consulting project.
  *
@@ -9,37 +9,35 @@
 
 /**
  * Favicon generator — creates ICO, Apple Touch Icon, and Android icons
- * from a single source PNG uploaded via the template config.
+ * from a single source image uploaded via the template config.
+ *
+ * Supports three backends in priority order:
+ *   1. GD (fastest, most common)
+ *   2. Imagick (common on shared hosting)
+ *   3. Pure PHP (zero-dependency fallback using raw PNG manipulation)
  */
 
 defined('_JEXEC') or die;
 
+use Joomla\CMS\Log\Log;
+
 class MokoFaviconHelper
 {
-    /**
-     * Sizes to generate: filename => [width, height, format].
-     * ICO embeds 16×16 and 32×32 internally.
-     */
     private const SIZES = [
-        'apple-touch-icon.png' => [180, 180, 'png'],
-        'favicon-32x32.png'    => [32, 32, 'png'],
-        'favicon-16x16.png'    => [16, 16, 'png'],
-        'android-chrome-192x192.png' => [192, 192, 'png'],
-        'android-chrome-512x512.png' => [512, 512, 'png'],
+        'apple-touch-icon.png' => [180, 180],
+        'favicon-32x32.png'    => [32, 32],
+        'favicon-16x16.png'    => [16, 16],
+        'android-chrome-192x192.png' => [192, 192],
+        'android-chrome-512x512.png' => [512, 512],
     ];
 
     /**
-     * Generate all favicon files from a source PNG if they don't already exist
-     * or if the source has been modified since last generation.
-     *
-     * @param  string  $sourcePath  Absolute path to the source PNG.
-     * @param  string  $outputDir   Absolute path to the output directory.
-     *
-     * @return bool  True if generation succeeded or files are up to date.
+     * Generate all favicon files from a source image.
      */
     public static function generate(string $sourcePath, string $outputDir): bool
     {
-        if (!is_file($sourcePath) || !extension_loaded('gd')) {
+        if (!is_file($sourcePath)) {
+            self::log('Favicon: source file not found: ' . $sourcePath, 'warning');
             return false;
         }
 
@@ -50,84 +48,424 @@ class MokoFaviconHelper
         $sourceTime = filemtime($sourcePath);
         $stampFile  = $outputDir . '/.favicon_generated';
 
-        // Skip if already up to date
         if (is_file($stampFile) && filemtime($stampFile) >= $sourceTime) {
             return true;
         }
 
-        $source = imagecreatefrompng($sourcePath);
+        // Strip #joomlaImage fragment if present
+        $sourcePath = strtok($sourcePath, '#');
+
+        // Select backend
+        if (extension_loaded('gd')) {
+            $result = self::generateWithGd($sourcePath, $outputDir);
+        } elseif (extension_loaded('imagick')) {
+            $result = self::generateWithImagick($sourcePath, $outputDir);
+        } else {
+            $result = self::generatePurePHP($sourcePath, $outputDir);
+        }
+
+        if ($result) {
+            self::generateManifest($outputDir);
+            file_put_contents($stampFile, date('c'));
+        }
+
+        return $result;
+    }
+
+    // ── GD Backend ──────────────────────────────────────────────────
+
+    private static function generateWithGd(string $sourcePath, string $outputDir): bool
+    {
+        $imageInfo = @getimagesize($sourcePath);
+        if ($imageInfo === false) {
+            self::log('Favicon: cannot read image: ' . $sourcePath, 'warning');
+            return false;
+        }
+
+        $source = match ($imageInfo[2]) {
+            IMAGETYPE_PNG  => @imagecreatefrompng($sourcePath),
+            IMAGETYPE_JPEG => @imagecreatefromjpeg($sourcePath),
+            IMAGETYPE_GIF  => @imagecreatefromgif($sourcePath),
+            IMAGETYPE_WEBP => function_exists('imagecreatefromwebp') ? @imagecreatefromwebp($sourcePath) : false,
+            default        => false,
+        };
+
         if (!$source) {
+            self::log('Favicon: unsupported image type', 'warning');
             return false;
         }
 
         imagealphablending($source, false);
         imagesavealpha($source, true);
-
         $srcW = imagesx($source);
         $srcH = imagesy($source);
 
-        // Generate PNG sizes
         foreach (self::SIZES as $filename => [$w, $h]) {
             $resized = imagecreatetruecolor($w, $h);
             imagealphablending($resized, false);
             imagesavealpha($resized, true);
-            $transparent = imagecolorallocatealpha($resized, 0, 0, 0, 127);
-            imagefill($resized, 0, 0, $transparent);
-
+            imagefill($resized, 0, 0, imagecolorallocatealpha($resized, 0, 0, 0, 127));
             imagecopyresampled($resized, $source, 0, 0, 0, 0, $w, $h, $srcW, $srcH);
             imagepng($resized, $outputDir . '/' . $filename, 9);
             imagedestroy($resized);
         }
 
-        // Generate ICO (contains 16×16 and 32×32)
-        self::generateIco($source, $srcW, $srcH, $outputDir . '/favicon.ico');
-
-        // Generate site.webmanifest
-        self::generateManifest($outputDir);
-
-        imagedestroy($source);
-
-        // Write timestamp stamp
-        file_put_contents($stampFile, date('c'));
-
-        return true;
-    }
-
-    /**
-     * Build a minimal ICO file containing 16×16 and 32×32 PNG entries.
-     */
-    private static function generateIco(\GdImage $source, int $srcW, int $srcH, string $outPath): void
-    {
-        $entries = [];
+        // ICO from GD
+        $icoEntries = [];
         foreach ([16, 32] as $size) {
             $resized = imagecreatetruecolor($size, $size);
             imagealphablending($resized, false);
             imagesavealpha($resized, true);
-            $transparent = imagecolorallocatealpha($resized, 0, 0, 0, 127);
-            imagefill($resized, 0, 0, $transparent);
+            imagefill($resized, 0, 0, imagecolorallocatealpha($resized, 0, 0, 0, 127));
             imagecopyresampled($resized, $source, 0, 0, 0, 0, $size, $size, $srcW, $srcH);
-
             ob_start();
             imagepng($resized, null, 9);
-            $pngData = ob_get_clean();
+            $icoEntries[] = ['size' => $size, 'data' => ob_get_clean()];
             imagedestroy($resized);
+        }
+        self::writeIco($icoEntries, $outputDir . '/favicon.ico');
 
-            $entries[] = ['size' => $size, 'data' => $pngData];
+        imagedestroy($source);
+        self::log('Favicon: generated with GD');
+        return true;
+    }
+
+    // ── Imagick Backend ─────────────────────────────────────────────
+
+    private static function generateWithImagick(string $sourcePath, string $outputDir): bool
+    {
+        try {
+            foreach (self::SIZES as $filename => [$w, $h]) {
+                $img = new \Imagick($sourcePath);
+                $img->setImageFormat('png');
+                $img->setImageCompressionQuality(95);
+                $img->thumbnailImage($w, $h, true);
+                // Center on transparent canvas if not square
+                $canvas = new \Imagick();
+                $canvas->newImage($w, $h, new \ImagickPixel('transparent'), 'png');
+                $offsetX = (int)(($w - $img->getImageWidth()) / 2);
+                $offsetY = (int)(($h - $img->getImageHeight()) / 2);
+                $canvas->compositeImage($img, \Imagick::COMPOSITE_OVER, $offsetX, $offsetY);
+                $canvas->writeImage($outputDir . '/' . $filename);
+                $img->destroy();
+                $canvas->destroy();
+            }
+
+            // ICO from Imagick
+            $icoEntries = [];
+            foreach ([16, 32] as $size) {
+                $img = new \Imagick($sourcePath);
+                $img->setImageFormat('png');
+                $img->thumbnailImage($size, $size, true);
+                $icoEntries[] = ['size' => $size, 'data' => (string) $img];
+                $img->destroy();
+            }
+            self::writeIco($icoEntries, $outputDir . '/favicon.ico');
+
+            self::log('Favicon: generated with Imagick');
+            return true;
+        } catch (\Exception $e) {
+            self::log('Favicon: Imagick failed: ' . $e->getMessage(), 'warning');
+            return false;
+        }
+    }
+
+    // ── Pure PHP Backend (zero dependencies) ────────────────────────
+
+    private static function generatePurePHP(string $sourcePath, string $outputDir): bool
+    {
+        $pngData = @file_get_contents($sourcePath);
+        if ($pngData === false) {
+            self::log('Favicon: cannot read source file', 'warning');
+            return false;
         }
 
-        // ICO header: 2 bytes reserved, 2 bytes type (1=ICO), 2 bytes count
+        // Detect format — we can only resize PNG in pure PHP
+        // For JPEG/other formats, just copy the source as-is for each size
+        $isPng = (substr($pngData, 0, 8) === "\x89PNG\r\n\x1a\n");
+
+        if (!$isPng) {
+            // Non-PNG: copy source file for all sizes (no resize capability without extensions)
+            foreach (self::SIZES as $filename => [$w, $h]) {
+                copy($sourcePath, $outputDir . '/' . $filename);
+            }
+            // ICO: embed the raw source for 16 and 32 entries
+            self::writeIco([
+                ['size' => 16, 'data' => $pngData],
+                ['size' => 32, 'data' => $pngData],
+            ], $outputDir . '/favicon.ico');
+            self::log('Favicon: non-PNG source copied without resize (no GD/Imagick)');
+            return true;
+        }
+
+        // Parse PNG dimensions from IHDR
+        $ihdr = self::parsePngIhdr($pngData);
+        if (!$ihdr) {
+            self::log('Favicon: cannot parse PNG header', 'warning');
+            return false;
+        }
+
+        $srcW = $ihdr['width'];
+        $srcH = $ihdr['height'];
+
+        // Decode PNG to raw RGBA pixel array
+        $pixels = self::decodePngToRgba($pngData, $srcW, $srcH, $ihdr);
+        if ($pixels === null) {
+            // Fallback: copy source for all sizes
+            foreach (self::SIZES as $filename => [$w, $h]) {
+                copy($sourcePath, $outputDir . '/' . $filename);
+            }
+            self::writeIco([
+                ['size' => 16, 'data' => $pngData],
+                ['size' => 32, 'data' => $pngData],
+            ], $outputDir . '/favicon.ico');
+            self::log('Favicon: PNG decode failed, copied source without resize');
+            return true;
+        }
+
+        // Generate resized PNGs
+        foreach (self::SIZES as $filename => [$w, $h]) {
+            $resized = self::resizePixels($pixels, $srcW, $srcH, $w, $h);
+            $png = self::encodePng($resized, $w, $h);
+            file_put_contents($outputDir . '/' . $filename, $png);
+        }
+
+        // ICO
+        $icoEntries = [];
+        foreach ([16, 32] as $size) {
+            $resized = self::resizePixels($pixels, $srcW, $srcH, $size, $size);
+            $icoEntries[] = ['size' => $size, 'data' => self::encodePng($resized, $size, $size)];
+        }
+        self::writeIco($icoEntries, $outputDir . '/favicon.ico');
+
+        self::log('Favicon: generated with pure PHP');
+        return true;
+    }
+
+    /**
+     * Parse PNG IHDR chunk.
+     */
+    private static function parsePngIhdr(string $data): ?array
+    {
+        if (strlen($data) < 33) return null;
+        // Skip 8-byte signature, 4-byte chunk length, 4-byte "IHDR"
+        $width     = unpack('N', substr($data, 16, 4))[1];
+        $height    = unpack('N', substr($data, 20, 4))[1];
+        $bitDepth  = ord($data[24]);
+        $colorType = ord($data[25]);
+        return ['width' => $width, 'height' => $height, 'bitDepth' => $bitDepth, 'colorType' => $colorType];
+    }
+
+    /**
+     * Decode PNG to flat RGBA array using zlib decompression.
+     *
+     * @return array|null  Flat array of [r,g,b,a, r,g,b,a, ...] or null on failure.
+     */
+    private static function decodePngToRgba(string $data, int $w, int $h, array $ihdr): ?array
+    {
+        // Only support 8-bit RGBA (color type 6) and RGB (color type 2) for simplicity
+        $colorType = $ihdr['colorType'];
+        $bitDepth  = $ihdr['bitDepth'];
+
+        if ($bitDepth !== 8 || ($colorType !== 6 && $colorType !== 2 && $colorType !== 3)) {
+            return null; // Unsupported format
+        }
+
+        // Collect all IDAT chunks
+        $idatData = '';
+        $pos = 8; // Skip PNG signature
+        $palette = null;
+        $trns = null;
+
+        while ($pos < strlen($data) - 4) {
+            $chunkLen = unpack('N', substr($data, $pos, 4))[1];
+            $chunkType = substr($data, $pos + 4, 4);
+
+            if ($chunkType === 'IDAT') {
+                $idatData .= substr($data, $pos + 8, $chunkLen);
+            } elseif ($chunkType === 'PLTE') {
+                $palette = substr($data, $pos + 8, $chunkLen);
+            } elseif ($chunkType === 'tRNS') {
+                $trns = substr($data, $pos + 8, $chunkLen);
+            } elseif ($chunkType === 'IEND') {
+                break;
+            }
+
+            $pos += 12 + $chunkLen; // 4 len + 4 type + data + 4 crc
+        }
+
+        $raw = @gzuncompress($idatData);
+        if ($raw === false) {
+            $raw = @gzinflate($idatData);
+        }
+        if ($raw === false) {
+            // Try with zlib header
+            $raw = @gzinflate(substr($idatData, 2));
+        }
+        if ($raw === false) {
+            return null;
+        }
+
+        $bpp = $colorType === 6 ? 4 : ($colorType === 2 ? 3 : 1); // bytes per pixel
+        $stride = 1 + $w * $bpp; // +1 for filter byte per row
+        $pixels = [];
+
+        $prevRow = array_fill(0, $w * $bpp, 0);
+
+        for ($y = 0; $y < $h; $y++) {
+            $rowStart = $y * $stride;
+            if ($rowStart >= strlen($raw)) break;
+
+            $filter = ord($raw[$rowStart]);
+            $row = [];
+
+            for ($x = 0; $x < $w * $bpp; $x++) {
+                $rawByte = ord($raw[$rowStart + 1 + $x]);
+                $a = ($x >= $bpp) ? $row[$x - $bpp] : 0;
+                $b = $prevRow[$x];
+                $c = ($x >= $bpp) ? $prevRow[$x - $bpp] : 0;
+
+                $val = match ($filter) {
+                    0 => $rawByte,
+                    1 => ($rawByte + $a) & 0xFF,
+                    2 => ($rawByte + $b) & 0xFF,
+                    3 => ($rawByte + (int)(($a + $b) / 2)) & 0xFF,
+                    4 => ($rawByte + self::paethPredictor($a, $b, $c)) & 0xFF,
+                    default => $rawByte,
+                };
+
+                $row[] = $val;
+            }
+
+            // Convert row to RGBA
+            for ($x = 0; $x < $w; $x++) {
+                if ($colorType === 6) { // RGBA
+                    $pixels[] = $row[$x * 4];
+                    $pixels[] = $row[$x * 4 + 1];
+                    $pixels[] = $row[$x * 4 + 2];
+                    $pixels[] = $row[$x * 4 + 3];
+                } elseif ($colorType === 2) { // RGB
+                    $pixels[] = $row[$x * 3];
+                    $pixels[] = $row[$x * 3 + 1];
+                    $pixels[] = $row[$x * 3 + 2];
+                    $pixels[] = 255;
+                } elseif ($colorType === 3 && $palette) { // Indexed
+                    $idx = $row[$x];
+                    $pixels[] = ord($palette[$idx * 3]);
+                    $pixels[] = ord($palette[$idx * 3 + 1]);
+                    $pixels[] = ord($palette[$idx * 3 + 2]);
+                    $pixels[] = ($trns && $idx < strlen($trns)) ? ord($trns[$idx]) : 255;
+                }
+            }
+
+            $prevRow = $row;
+        }
+
+        return $pixels;
+    }
+
+    private static function paethPredictor(int $a, int $b, int $c): int
+    {
+        $p = $a + $b - $c;
+        $pa = abs($p - $a);
+        $pb = abs($p - $b);
+        $pc = abs($p - $c);
+        if ($pa <= $pb && $pa <= $pc) return $a;
+        if ($pb <= $pc) return $b;
+        return $c;
+    }
+
+    /**
+     * Bilinear resize of RGBA pixel array.
+     */
+    private static function resizePixels(array $src, int $srcW, int $srcH, int $dstW, int $dstH): array
+    {
+        $dst = [];
+        $xRatio = $srcW / $dstW;
+        $yRatio = $srcH / $dstH;
+
+        for ($y = 0; $y < $dstH; $y++) {
+            $srcY = $y * $yRatio;
+            $y0 = (int) $srcY;
+            $y1 = min($y0 + 1, $srcH - 1);
+            $yFrac = $srcY - $y0;
+
+            for ($x = 0; $x < $dstW; $x++) {
+                $srcX = $x * $xRatio;
+                $x0 = (int) $srcX;
+                $x1 = min($x0 + 1, $srcW - 1);
+                $xFrac = $srcX - $x0;
+
+                for ($c = 0; $c < 4; $c++) {
+                    $tl = $src[($y0 * $srcW + $x0) * 4 + $c];
+                    $tr = $src[($y0 * $srcW + $x1) * 4 + $c];
+                    $bl = $src[($y1 * $srcW + $x0) * 4 + $c];
+                    $br = $src[($y1 * $srcW + $x1) * 4 + $c];
+
+                    $top = $tl + ($tr - $tl) * $xFrac;
+                    $bot = $bl + ($br - $bl) * $xFrac;
+                    $dst[] = (int) round($top + ($bot - $top) * $yFrac);
+                }
+            }
+        }
+
+        return $dst;
+    }
+
+    /**
+     * Encode RGBA pixel array to PNG binary.
+     */
+    private static function encodePng(array $pixels, int $w, int $h): string
+    {
+        // Build raw image data with filter byte 0 (None) per row
+        $raw = '';
+        for ($y = 0; $y < $h; $y++) {
+            $raw .= "\x00"; // filter: None
+            for ($x = 0; $x < $w; $x++) {
+                $i = ($y * $w + $x) * 4;
+                $raw .= chr($pixels[$i]) . chr($pixels[$i + 1]) . chr($pixels[$i + 2]) . chr($pixels[$i + 3]);
+            }
+        }
+
+        $compressed = gzcompress($raw);
+
+        // Build PNG
+        $png = "\x89PNG\r\n\x1a\n";
+
+        // IHDR
+        $ihdr = pack('NNCCCC', $w, $h, 8, 6, 0, 0, 0); // 8-bit RGBA
+        $png .= self::pngChunk('IHDR', $ihdr);
+
+        // IDAT
+        $png .= self::pngChunk('IDAT', $compressed);
+
+        // IEND
+        $png .= self::pngChunk('IEND', '');
+
+        return $png;
+    }
+
+    private static function pngChunk(string $type, string $data): string
+    {
+        $chunk = $type . $data;
+        return pack('N', strlen($data)) . $chunk . pack('N', crc32($chunk));
+    }
+
+    // ── Shared Utilities ────────────────────────────────────────────
+
+    /**
+     * Write ICO file from PNG data entries.
+     */
+    private static function writeIco(array $entries, string $outPath): void
+    {
         $count = count($entries);
         $ico = pack('vvv', 0, 1, $count);
-
-        // Calculate offset: header (6) + directory entries (16 each)
         $offset = 6 + ($count * 16);
         $imageData = '';
 
         foreach ($entries as $entry) {
             $size = $entry['size'] >= 256 ? 0 : $entry['size'];
             $dataLen = strlen($entry['data']);
-
-            // ICONDIRENTRY: width, height, colors, reserved, planes, bpp, size, offset
             $ico .= pack('CCCCvvVV', $size, $size, 0, 0, 1, 32, $dataLen, $offset);
             $imageData .= $entry['data'];
             $offset += $dataLen;
@@ -136,9 +474,6 @@ class MokoFaviconHelper
         file_put_contents($outPath, $ico . $imageData);
     }
 
-    /**
-     * Write a site.webmanifest for Android/PWA icon discovery.
-     */
     private static function generateManifest(string $outputDir): void
     {
         $manifest = [
@@ -153,16 +488,9 @@ class MokoFaviconHelper
         );
     }
 
-    /**
-     * Return the <link> tags to inject into <head>.
-     *
-     * @param  string  $basePath  URL path to the favicon directory (relative to site root).
-     *
-     * @return string  HTML link tags.
-     */
     public static function getHeadTags(string $basePath): string
     {
-        $basePath = rtrim($basePath, '/');
+        $basePath = htmlspecialchars(rtrim($basePath, '/'), ENT_QUOTES, 'UTF-8');
 
         return '<link rel="apple-touch-icon" sizes="180x180" href="' . $basePath . '/apple-touch-icon.png">' . "\n"
              . '<link rel="icon" type="image/png" sizes="32x32" href="' . $basePath . '/favicon-32x32.png">' . "\n"
@@ -170,4 +498,21 @@ class MokoFaviconHelper
              . '<link rel="manifest" href="' . $basePath . '/site.webmanifest">' . "\n"
              . '<link rel="shortcut icon" href="' . $basePath . '/favicon.ico">' . "\n";
     }
+
+    private static function log(string $message, string $priority = 'info'): void
+    {
+        $priorities = [
+            'info'    => Log::INFO,
+            'warning' => Log::WARNING,
+            'error'   => Log::ERROR,
+        ];
+
+        Log::addLogger(
+            ['text_file' => 'mokocassiopeia.log.php'],
+            Log::ALL,
+            ['mokocassiopeia']
+        );
+
+        Log::add($message, $priorities[$priority] ?? Log::INFO, 'mokocassiopeia');
+    }
 }

src/helper/minify.php

@@ -22,6 +22,9 @@ class MokoMinifyHelper
      */
     private const CSS_FILES = [
         'css/template.css',
+        'css/offline.css',
+        'css/editor.css',
+        'css/a11y-high-contrast.css',
         'css/theme/light.standard.css',
         'css/theme/dark.standard.css',
         'css/theme/light.custom.css',

src/html/mod_stats/default.php

@@ -26,10 +26,14 @@ $headerClass = htmlspecialchars($params->get('header_class', ''), ENT_COMPAT, 'U
     <?php if ($module->showtitle) : ?>
         <<?php echo $headerTag; ?> class="mod-stats__title<?php echo $headerClass ? ' ' . $headerClass : ''; ?>"><?php echo $module->title; ?></<?php echo $headerTag; ?>>
     <?php endif; ?>
-    <dl class="mod-stats__list">
-        <?php foreach ($list as $item) : ?>
-            <dt class="mod-stats__label"><?php echo $item->title; ?></dt>
-            <dd class="mod-stats__data"><?php echo $item->data; ?></dd>
-        <?php endforeach; ?>
-    </dl>
+    <table class="mod_stats__table">
+        <tbody>
+            <?php foreach ($list as $item) : ?>
+                <tr>
+                    <th class="mod_stats__label" scope="row"><?php echo $item->title; ?></th>
+                    <td class="mod_stats__data"><?php echo $item->data; ?></td>
+                </tr>
+            <?php endforeach; ?>
+        </tbody>
+    </table>
 </div>

src/index.php

@@ -41,7 +41,7 @@ $params_favicon_source     = (string) $this->params->get('favicon_source', '');
 $params_theme_enabled      = $this->params->get('theme_enabled', 1);
 $params_theme_control_type = (string) $this->params->get('theme_control_type', 'radios');
 $params_theme_fab_enabled  = $this->params->get('theme_fab_enabled', 1);
-$params_theme_fab_pos      = $this->params->get('theme_fab_pos', 'br');
+$params_theme_fab_pos      = 'br';
 
 // Accessibility params
 $params_a11y_toolbar    = $this->params->get('a11y_toolbar_enabled', 1);
@@ -51,7 +51,7 @@ $params_a11y_contrast   = $this->params->get('a11y_high_contrast', 1);
 $params_a11y_links      = $this->params->get('a11y_highlight_links', 1);
 $params_a11y_font       = $this->params->get('a11y_readable_font', 1);
 $params_a11y_animations = $this->params->get('a11y_pause_animations', 1);
-$params_a11y_pos        = (string) $this->params->get('a11y_toolbar_pos', 'tl');
+$params_a11y_pos        = 'br';
 
 // Detecting Active Variables
 $option    = $input->getCmd('option', '');
@@ -71,7 +71,27 @@ $templatePath = 'media/templates/site/mokocassiopeia';
 $faviconHeadTags = '';
 if ($params_favicon_source) {
     require_once __DIR__ . '/helper/favicon.php';
-    $faviconSourceAbs = JPATH_ROOT . '/' . ltrim($params_favicon_source, '/');
+    // Joomla's media field returns paths like:
+    //   'images/logo.png'                                    (images folder)
+    //   'media/templates/site/mokocassiopeia/images/logo.png' (template media)
+    //   'logo.png'                                            (bare filename)
+    // Strip Joomla's #joomlaImage:// fragment from media field value
+    $faviconSourceRel = strtok(ltrim($params_favicon_source, '/'), '#');
+    $faviconSourceAbs = JPATH_ROOT . '/' . $faviconSourceRel;
+    // Try common prefixes if not found
+    if (!is_file($faviconSourceAbs)) {
+        $candidates = [
+            JPATH_ROOT . '/images/' . $faviconSourceRel,
+            JPATH_ROOT . '/media/templates/site/' . $this->template . '/' . $faviconSourceRel,
+            JPATH_ROOT . '/media/templates/site/' . $this->template . '/images/' . basename($faviconSourceRel),
+        ];
+        foreach ($candidates as $candidate) {
+            if (is_file($candidate)) {
+                $faviconSourceAbs = $candidate;
+                break;
+            }
+        }
+    }
     $faviconOutputDir = JPATH_ROOT . '/images/favicons';
     $faviconUrlBase   = Uri::root(true) . '/images/favicons';
 
@@ -406,7 +426,7 @@ $wa->useScript('user.js');         // js/user.js
 				</div>
 				<?php if ($this->countModules('brand-aside', true)) : ?>
 					<div class="container-brand-aside">
-						<jdoc:include type="modules" name="brand-aside" style="none" />
+						<jdoc:include type="modules" name="brand-aside" style="card" />
 					</div>
 				<?php endif; ?>
 			</div>

src/joomla.asset.json

@@ -17,7 +17,7 @@
 			"defgroup": "Joomla.Template.Site",
 			"ingroup": "MokoCassiopeia.Template.Assets",
 			"path": "./media/templates/site/mokocassiopeia/joomla.asset.json",
-			"version": "03.09.14",
+			"version": "03.10.13",
 			"brief": "Joomla asset registry for MokoCassiopeia"
 		}
 	},
@@ -34,6 +34,18 @@
 			"uri": "media/templates/site/mokocassiopeia/css/template.min.css",
 			"attributes": {"media": "all"}
 		},
+		{
+			"name": "template.offline",
+			"type": "style",
+			"uri": "media/templates/site/mokocassiopeia/css/offline.css",
+			"attributes": {"media": "all"}
+		},
+		{
+			"name": "template.offline.min",
+			"type": "style",
+			"uri": "media/templates/site/mokocassiopeia/css/offline.min.css",
+			"attributes": {"media": "all"}
+		},
 		{
 			"name": "template.user",
 			"type": "style",

src/language/en-GB/tpl_mokocassiopeia.ini

@@ -259,16 +259,14 @@ TPL_MOKOCASSIOPEIA_CSS_VARS_VM_DESC="<strong>Surfaces &amp; text</strong><br><co
 TPL_MOKOCASSIOPEIA_CSS_VARS_GABLE_LABEL="Gable"
 TPL_MOKOCASSIOPEIA_CSS_VARS_GABLE_DESC="Colour tokens used by the Gable extension.<br><code>--gab-blue</code> — <code>#0066cc</code><br><code>--gab-green</code> — <code>#28a745</code><br><code>--gab-red</code> — <code>#dc3545</code><br><code>--gab-orange</code> — <code>#fd7e14</code><br><code>--gab-gray1</code> — <code>#495057</code><br><code>--gab-gray2</code> — <code>#6c757d</code><br><code>--gab-gray3</code> — <code>#adb5bd</code>"
 
+TPL_MOKOCASSIOPEIA_CSS_VARS_FOOTER_LABEL="Footer"
+TPL_MOKOCASSIOPEIA_CSS_VARS_FOOTER_DESC="<strong>Spacing</strong><br><code>--footer-padding-top</code> — Top padding (default: <code>1rem</code>)<br><code>--footer-padding-bottom</code> — Bottom padding (default: <code>80px</code>)<br><code>--footer-grid-padding-y</code> — Grid vertical padding (default: <code>2.5rem</code>)<br><code>--footer-grid-padding-x</code> — Grid horizontal padding (default: <code>0.5em</code>)"
+
 ; ===== Theme Preview tab =====
 TPL_MOKOCASSIOPEIA_THEME_PREVIEW_FIELDSET_LABEL="Theme Preview"
 TPL_MOKOCASSIOPEIA_THEME_PREVIEW_INTRO="<p>Live preview of all CSS variables, hero variants, block colours, and Bootstrap components rendered with your active theme. Use the <strong>Toggle Light / Dark</strong> button inside the preview to switch modes. This page is also available as a standalone file at <code>templates/mokocassiopeia/templates/theme-test.html</code>.</p>"
 TPL_MOKOCASSIOPEIA_THEME_PREVIEW_FRAME="<iframe src='../templates/mokocassiopeia/templates/theme-test.html' style='width:100%;height:80vh;border:1px solid #dee2e6;border-radius:.375rem;' loading='lazy' title='Theme test sheet preview'></iframe>"
 
-; ===== Brand Showcase tab =====
-TPL_MOKOCASSIOPEIA_BRAND_SHOWCASE_FIELDSET_LABEL="Brand Showcase"
-TPL_MOKOCASSIOPEIA_BRAND_SHOWCASE_INTRO="<p>Interactive brand and Bootstrap 5 component showcase with colour system gradients. <strong>Hover over any gradient</strong> to sample the exact pixel colour at that point. Use the <strong>Toggle Light / Dark</strong> button to switch themes. This page is also available standalone at <code>templates/mokocassiopeia/templates/brand-showcase.html</code>.</p>"
-TPL_MOKOCASSIOPEIA_BRAND_SHOWCASE_FRAME="<iframe src='../templates/mokocassiopeia/templates/brand-showcase.html' style='width:100%;height:80vh;border:1px solid #dee2e6;border-radius:.375rem;' loading='lazy' title='Brand and Bootstrap showcase with colour sampler'></iframe>"
-
 ; ===== Misc =====
 MOD_BREADCRUMBS_HERE="YOU ARE HERE:"
 

src/language/en-US/tpl_mokocassiopeia.ini

@@ -259,16 +259,14 @@ TPL_MOKOCASSIOPEIA_CSS_VARS_VM_DESC="<strong>Surfaces &amp; text</strong><br><co
 TPL_MOKOCASSIOPEIA_CSS_VARS_GABLE_LABEL="Gable"
 TPL_MOKOCASSIOPEIA_CSS_VARS_GABLE_DESC="Color tokens used by the Gable extension.<br><code>--gab-blue</code> — <code>#0066cc</code><br><code>--gab-green</code> — <code>#28a745</code><br><code>--gab-red</code> — <code>#dc3545</code><br><code>--gab-orange</code> — <code>#fd7e14</code><br><code>--gab-gray1</code> — <code>#495057</code><br><code>--gab-gray2</code> — <code>#6c757d</code><br><code>--gab-gray3</code> — <code>#adb5bd</code>"
 
+TPL_MOKOCASSIOPEIA_CSS_VARS_FOOTER_LABEL="Footer"
+TPL_MOKOCASSIOPEIA_CSS_VARS_FOOTER_DESC="<strong>Spacing</strong><br><code>--footer-padding-top</code> — Top padding (default: <code>1rem</code>)<br><code>--footer-padding-bottom</code> — Bottom padding (default: <code>80px</code>)<br><code>--footer-grid-padding-y</code> — Grid vertical padding (default: <code>2.5rem</code>)<br><code>--footer-grid-padding-x</code> — Grid horizontal padding (default: <code>0.5em</code>)"
+
 ; ===== Theme Preview tab =====
 TPL_MOKOCASSIOPEIA_THEME_PREVIEW_FIELDSET_LABEL="Theme Preview"
 TPL_MOKOCASSIOPEIA_THEME_PREVIEW_INTRO="<p>Live preview of all CSS variables, hero variants, block colors, and Bootstrap components rendered with your active theme. Use the <strong>Toggle Light / Dark</strong> button inside the preview to switch modes. This page is also available as a standalone file at <code>templates/mokocassiopeia/templates/theme-test.html</code>.</p>"
 TPL_MOKOCASSIOPEIA_THEME_PREVIEW_FRAME="<iframe src='../templates/mokocassiopeia/templates/theme-test.html' style='width:100%;height:80vh;border:1px solid #dee2e6;border-radius:.375rem;' loading='lazy' title='Theme test sheet preview'></iframe>"
 
-; ===== Brand Showcase tab =====
-TPL_MOKOCASSIOPEIA_BRAND_SHOWCASE_FIELDSET_LABEL="Brand Showcase"
-TPL_MOKOCASSIOPEIA_BRAND_SHOWCASE_INTRO="<p>Interactive brand and Bootstrap 5 component showcase with color system gradients. <strong>Hover over any gradient</strong> to sample the exact pixel color at that point. Use the <strong>Toggle Light / Dark</strong> button to switch themes. This page is also available standalone at <code>templates/mokocassiopeia/templates/brand-showcase.html</code>.</p>"
-TPL_MOKOCASSIOPEIA_BRAND_SHOWCASE_FRAME="<iframe src='../templates/mokocassiopeia/templates/brand-showcase.html' style='width:100%;height:80vh;border:1px solid #dee2e6;border-radius:.375rem;' loading='lazy' title='Brand and Bootstrap showcase with color sampler'></iframe>"
-
 ; ===== Misc =====
 MOD_BREADCRUMBS_HERE="YOU ARE HERE:"
 

src/media/css/offline.css

@@ -0,0 +1,258 @@
+/* Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
+
+ This file is part of a Moko Consulting project.
+
+ SPDX-License-Identifier: GPL-3.0-or-later
+ */
+
+/* === Offline Page — Full-viewport background with centered overlay card === */
+
+.moko-offline-wrap {
+	min-height: 100vh;
+	display: flex;
+	flex-direction: column;
+	align-items: center;
+	justify-content: center;
+	padding: 2rem 1rem;
+	color: #fff;
+	font-family: var(--body-font-family, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);
+	/* Background: offline_image set inline, or fall back to header background */
+	background-color: var(--color-primary, #112855);
+	background-image: var(--header-background-image, none);
+	background-position: var(--header-background-position, center);
+	background-attachment: var(--header-background-attachment, fixed);
+	background-repeat: no-repeat;
+	background-size: cover;
+}
+
+/* Dark theme: overlay to darken the background */
+:root[data-bs-theme="dark"] .moko-offline-wrap {
+	position: relative;
+}
+
+:root[data-bs-theme="dark"] .moko-offline-wrap::before {
+	content: "";
+	position: absolute;
+	inset: 0;
+	background: rgba(0, 0, 0, 0.5);
+	z-index: 0;
+}
+
+/* === Centered Card Overlay === */
+.moko-offline-card {
+	width: 100%;
+	max-width: 720px;
+	background: var(--offline-card-bg, rgba(0, 0, 0, 0.6));
+	backdrop-filter: blur(8px);
+	-webkit-backdrop-filter: blur(8px);
+	border-radius: 0.875rem;
+	padding: 2.5rem 2rem;
+	text-align: center;
+	box-shadow: 0 8px 32px rgba(0, 0, 0, 0.4);
+}
+
+@media (min-width: 768px) {
+	.moko-offline-card {
+		padding: 3rem;
+	}
+}
+
+@media (max-width: 575.98px) {
+	.moko-offline-wrap {
+		padding: 1rem 0.75rem;
+	}
+
+	.moko-offline-card {
+		padding: 2rem 1.25rem;
+	}
+}
+
+/* === Logo header area === */
+.moko-offline-brand {
+	display: block;
+	text-align: center;
+	text-decoration: none;
+	color: #fff;
+	margin-bottom: 1.5rem;
+}
+
+.moko-offline-brand:hover {
+	color: var(--accent-color-primary, #3f8ff0);
+}
+
+.moko-offline-brand img {
+	max-width: 100%;
+	height: auto;
+}
+
+.moko-offline-brand .site-title {
+	display: block;
+	font-size: 2rem;
+	font-weight: 700;
+	font-family: 'Osaka', var(--body-font-family, sans-serif);
+	color: var(--accent-color-secondary, #6fb3ff);
+}
+
+.moko-offline-brand .brand-tagline {
+	display: block;
+	opacity: 0.7;
+	font-size: 0.9rem;
+	margin-top: 0.25rem;
+}
+
+/* === Offline Message === */
+.moko-offline-message {
+	margin-bottom: 1.5rem;
+}
+
+.moko-offline-message h1 {
+	font-size: 1.5rem;
+	font-weight: 700;
+	color: #fff;
+	margin-bottom: 0.5rem;
+	text-shadow: 0 1px 3px rgba(0, 0, 0, 0.4);
+}
+
+.moko-offline-message p {
+	color: rgba(255, 255, 255, 0.85);
+	line-height: 1.6;
+	margin: 0;
+}
+
+/* === Offline Module Position === */
+.moko-offline-modules {
+	margin-bottom: 1.5rem;
+	text-align: left;
+}
+
+/* === Copyright Footer === */
+.moko-offline-copyright {
+	font-size: 0.8rem;
+	color: rgba(255, 255, 255, 0.45);
+	margin-top: 1.5rem;
+	padding-top: 1rem;
+	border-top: 1px solid rgba(255, 255, 255, 0.1);
+}
+
+.moko-offline-copyright a {
+	color: rgba(255, 255, 255, 0.6);
+	text-decoration: underline;
+}
+
+.moko-offline-copyright a:hover {
+	color: #fff;
+}
+
+/* === Login Accordion (translucent on overlay) === */
+.moko-offline-card .accordion {
+	text-align: left;
+}
+
+.moko-offline-card .accordion-item {
+	background: transparent;
+	border-color: rgba(255, 255, 255, 0.15);
+}
+
+.moko-offline-card .accordion-button {
+	background: transparent;
+	color: rgba(255, 255, 255, 0.8);
+	font-size: 0.9rem;
+	padding: 0.75rem 1rem;
+}
+
+.moko-offline-card .accordion-button:not(.collapsed) {
+	background: rgba(255, 255, 255, 0.05);
+	color: #fff;
+	box-shadow: none;
+}
+
+.moko-offline-card .accordion-button::after {
+	filter: invert(1) brightness(2);
+}
+
+.moko-offline-card .accordion-body {
+	background: transparent;
+	padding: 1rem;
+}
+
+/* === Form Controls (glass effect) === */
+.moko-offline-card .form-control {
+	background-color: rgba(255, 255, 255, 0.1);
+	border-color: rgba(255, 255, 255, 0.2);
+	color: #fff;
+}
+
+.moko-offline-card .form-control::placeholder {
+	color: rgba(255, 255, 255, 0.4);
+}
+
+.moko-offline-card .form-control:focus {
+	background-color: rgba(255, 255, 255, 0.15);
+	border-color: var(--accent-color-primary, #3f8ff0);
+	color: #fff;
+	box-shadow: 0 0 0 0.25rem rgba(63, 143, 240, 0.25);
+}
+
+.moko-offline-card .form-label {
+	color: rgba(255, 255, 255, 0.8);
+	font-size: 0.875rem;
+}
+
+.moko-offline-card .form-check-label {
+	color: rgba(255, 255, 255, 0.7);
+}
+
+.moko-offline-card .form-check-input {
+	background-color: rgba(255, 255, 255, 0.1);
+	border-color: rgba(255, 255, 255, 0.3);
+}
+
+.moko-offline-card .form-check-input:checked {
+	background-color: var(--accent-color-primary, #3f8ff0);
+	border-color: var(--accent-color-primary, #3f8ff0);
+}
+
+/* === Button === */
+.moko-offline-card .btn-primary {
+	background-color: var(--color-primary, #112855);
+	border-color: rgba(255, 255, 255, 0.15);
+	color: #fff;
+}
+
+.moko-offline-card .btn-primary:hover {
+	background-color: var(--accent-color-primary, #3f8ff0);
+	border-color: var(--accent-color-primary, #3f8ff0);
+}
+
+/* === Links === */
+.moko-offline-card a {
+	color: var(--accent-color-primary, #3f8ff0);
+}
+
+.moko-offline-card a:hover {
+	color: #fff;
+}
+
+/* === Joomla system messages === */
+.moko-offline-messages {
+	width: 100%;
+	max-width: 720px;
+	margin-bottom: 1rem;
+}
+
+/* === Skip Link === */
+.skip-link {
+	position: absolute;
+	left: -9999px;
+	top: auto;
+	width: 1px;
+	height: 1px;
+	overflow: hidden;
+}
+
+.skip-link:focus {
+	position: static;
+	width: auto;
+	height: auto;
+	padding: 0.5rem 1rem;
+}

src/media/css/template.css

@@ -2593,8 +2593,8 @@ progress {
 	font-size: 1rem;
 	font-weight: 400;
 	line-height: 1;
-	color: var(--input-color, #e6ebf1);
-	background-color: var(--input-bg, #1a2332);
+	color: var(--input-color, #1a2332);
+	background-color: var(--input-bg, #e6ebf1);
 	background-clip: padding-box;
 	border: 1px solid var(--input-border-color, #3a4250);
 	-webkit-appearance: none;
@@ -13912,7 +13912,7 @@ meter {
 	height: 4px;
 	margin: 1rem auto 2rem;
 	content: "";
-	background: var(--body-color, #e6ebf1);
+	background: var(--body-bg, #e6ebf1);
 }
 
 .container-banner .banner-overlay .overlay .text-thin .lead {
@@ -14099,7 +14099,7 @@ td .form-control {
 	margin: 0.5em;
 	color: hsl(0, 0%, 0%);
 	text-align: start;
-	background: var(--body-color, #e6ebf1);
+	background: var(--body-bg, #e6ebf1);
 	border: 1px solid hsl(210, 7%, 46%);
 	border-radius: 0.25rem;
 	-webkit-box-shadow: 0 0 0.5rem rgba(0, 0, 0, 0.8);
@@ -14233,6 +14233,28 @@ fieldset>* {
 	margin-inline-start: auto;
 	display: flex;
 	align-items: center;
+	gap: 1em;
+}
+
+.container-brand-aside>* {
+	flex: 1;
+	margin: 0.5em 0;
+}
+
+@media (max-width: 991.98px) {
+	.header-brand-wrap {
+		flex-direction: column;
+		align-items: stretch;
+	}
+
+	.container-brand-aside {
+		margin-inline-start: 0;
+		flex-direction: column;
+	}
+
+	.container-brand-aside>* {
+		flex: 0 1 auto;
+	}
 }
 
 .container-header .navbar-brand {
@@ -15527,7 +15549,7 @@ joomla-alert {
 	min-height: 43px;
 	padding: 0.25rem;
 	color: var(--subhead-color, #9fa6ad);
-	background: var(--body-color, #e6ebf1);
+	background: var(--body-bg, #e6ebf1);
 	-webkit-box-shadow: -3px -2px 22px var(--box-shadow-gray, #1a2027);
 	box-shadow: -3px -2px 22px var(--box-shadow-gray, #1a2027);
 }
@@ -15569,7 +15591,7 @@ joomla-alert {
 	font-size: 1rem;
 	line-height: 2.45rem;
 	color: var(--subhead-color, #9fa6ad);
-	background: var(--body-color, #e6ebf1);
+	background: var(--body-bg, #e6ebf1);
 	border-color: hsl(210, 11%, 71%);
 }
 
@@ -15771,7 +15793,13 @@ body.wrapper-fluid header>.grid-child {
 }
 
 footer .grid-child>div {
-	padding: var(--navbar-padding-y, 1rem) var(--navbar-padding-x, 1rem) 0;
+	padding: calc(var(--navbar-padding-y, 1rem) * 3)
+         calc(var(--navbar-padding-x, 1rem) * 1)
+         0;
+}
+
+.mod-footer {
+	border-top: 1px solid var(--border-gray, #b2bfcds);
 }
 
 header .grid-child .navbar-brand {
@@ -16302,7 +16330,7 @@ body:not(.has-sidebar-right) .site-grid .container-component {
 
 .nav-tabs+.tab-content {
 	padding: 0.9375rem;
-	background: var(--body-color, #e6ebf1);
+	background: var(--body-bg, #e6ebf1);
 	border: 1px solid;
 	border-color: hsl(210, 14%, 89%);
 	border-radius: 0 0 0.25rem 0.25rem;
@@ -16377,7 +16405,7 @@ body:not(.has-sidebar-right) .site-grid .container-component {
 }
 
 .chosen-container.chosen-container-single .chosen-drop {
-	background: var(--body-color, #e6ebf1);
+	background: var(--body-bg, #e6ebf1);
 	border: 1px solid hsl(210, 14%, 83%);
 }
 
@@ -17064,14 +17092,20 @@ form .form-select {
 	display: flex;
 	align-items: center;
 	gap: .5rem;
-	padding: calc(var(--padding-x, 0.25rem) * 2) calc(var(--padding-y, 0.25rem) * 3) calc(var(--padding-x, 0.25rem) * 2) calc(var(--padding-y, 0.25rem) * 8);
+	padding: .5rem .75rem;
 	border-radius: 999px;
-	border: none;
-	background: var(--muted-color, #6d757e);
-	box-shadow: var(--box-shadow, 0 .5rem 1rem #00000066);
+	border: 2px solid var(--theme-fab-border, rgba(255,255,255,.3));
+	background: var(--theme-fab-bg, var(--color-primary, #112855));
+	color: var(--theme-fab-color, #fff);
+	box-shadow: 0 4px 20px rgba(0, 0, 0, 0.4), 0 0 0 1px rgba(255, 255, 255, 0.1);
 	font: inherit;
-	color: #fff;
 	font-weight: 600;
+	transition: transform .15s, box-shadow .15s;
+}
+
+#mokoThemeFab:hover {
+	transform: scale(1.05);
+	box-shadow: 0 6px 28px rgba(0, 0, 0, 0.5), 0 0 0 1px rgba(255, 255, 255, 0.15);
 }
 
 #mokoThemeFab.pos-br {
@@ -17094,50 +17128,47 @@ form .form-select {
 	top: 1rem;
 }
 
-#mokoThemeFab .switch {
-	display: inline-flex;
+/* Sun/Moon theme toggle button */
+.theme-icon-btn {
+	display: flex;
 	align-items: center;
+	justify-content: center;
+	width: 36px;
+	height: 36px;
+	border: none;
+	border-radius: 50%;
+	background: var(--theme-fab-btn-bg, rgba(255,255,255,.15));
+	color: inherit;
+	font-size: 1.25rem;
+	cursor: pointer;
+	padding: 0;
 	position: relative;
-	width: 44px;
-	height: 24px;
-	background: var(--secondary-color, #e6ebf1bf);
-	transition: background .2s, border-color .2s;
-	border-radius: var(--border-radius-xxl, 2rem);
 }
 
-#mokoThemeFab .knob {
+.theme-icon-btn .fa-sun,
+.theme-icon-btn .fa-moon {
 	position: absolute;
-	top: 2px;
-	left: 2px;
-	width: 20px;
-	height: 20px;
-	border-radius: var(--border-radius-xxl, 2rem);
-	background: var(--bs-body-bg, #fff);
-	box-shadow: var(--box-shadow, 0 .5rem 1rem #00000066);
-	transition: transform .2s ease;
+	transition: opacity .2s, transform .2s;
 }
 
-#mokoThemeFab [role="switch"][aria-checked="true"] .knob {
-	transform: translateX(20px);
+/* Light mode: show sun, hide moon */
+.theme-icon-btn.is-light .fa-sun {
+	opacity: 1;
+	transform: rotate(0deg);
+}
+.theme-icon-btn.is-light .fa-moon {
+	opacity: 0;
+	transform: rotate(-90deg);
 }
 
-#mokoThemeFab [role="switch"][aria-checked="true"] .switch {
-	background: rgba(var(--secondary-color, #e6ebf1bf), .15);
+/* Dark mode: show moon, hide sun */
+.theme-icon-btn.is-dark .fa-moon {
+	opacity: 1;
+	transform: rotate(0deg);
 }
-
-button#mokoThemeSwitch {
-	border: unset;
-	background-color: unset;
-}
-
-#mokoThemeFab .label {
-	user-select: none;
-	font-size: .875rem;
-	color: #fff;
-}
-
-#mokoThemeFab button {
-	color: #fff;
+.theme-icon-btn.is-dark .fa-sun {
+	opacity: 0;
+	transform: rotate(90deg);
 }
 
 /* Auto toggle switch (on/off style) */
@@ -17164,14 +17195,14 @@ button#mokoThemeSwitch {
 	height: 18px;
 	border: none;
 	border-radius: 999px;
-	background: var(--secondary-color, #6c757d);
+	background: var(--danger, #c23a31);
 	cursor: pointer;
 	padding: 0;
 	transition: background .2s;
 }
 
 .auto-switch.on {
-	background: var(--link-color, #3565e5);
+	background: var(--success, #4aa664);
 }
 
 .auto-track {
@@ -17207,6 +17238,15 @@ button#mokoThemeSwitch {
 }
 
 /* Inline a11y toggle inside theme FAB */
+/* Light mode: darker blue */
+:root[data-bs-theme="light"] .a11y-toggle-inline {
+	--a11y-btn-bg: #1565c0;
+}
+/* Dark mode: lighter blue */
+:root[data-bs-theme="dark"] .a11y-toggle-inline {
+	--a11y-btn-bg: #42a5f5;
+}
+
 .a11y-toggle-inline {
 	display: flex;
 	align-items: center;
@@ -17214,25 +17254,16 @@ button#mokoThemeSwitch {
 	width: 28px;
 	height: 28px;
 	border-radius: 50%;
-	border: 1.5px solid currentColor;
-	background: transparent;
-	color: inherit;
+	border: none;
+	background: var(--a11y-btn-bg, #1976d2);
+	color: #fff;
 	font-size: 1rem;
 	cursor: pointer;
 	padding: 0;
-	transition: background .2s, color .2s;
-	opacity: .8;
-}
-
-.a11y-toggle-inline:hover,
-.a11y-toggle-inline:focus-visible {
-	opacity: 1;
-	background: rgba(255,255,255,.15);
 }
 
 .a11y-toggle-inline.active {
-	opacity: 1;
-	background: rgba(255,255,255,.25);
+	box-shadow: 0 0 0 2px #fff, 0 0 0 4px var(--a11y-btn-bg, #1976d2);
 }
 
 /* Floating a11y panel when inline */
@@ -17361,36 +17392,6 @@ body.site.error-page {
 	text-decoration: none;
 }
 
-#mokoThemeFab .knob {
-  position: absolute;
-  top: 2px;
-  left: 2px;
-  width: 20px;
-  height: 20px;
-  border-radius: var(--border-radius-xxl, 2rem);
-  background: var(--bs-body-bg, #fff);
-  box-shadow: var(--box-shadow, 0 .5rem 1rem #00000066);
-  transition: transform .2s ease;
-}
-
-#mokoThemeFab [role="switch"][aria-checked="true"] .knob {
-  transform: translateX(20px);
-}
-
-#mokoThemeFab [role="switch"][aria-checked="true"] .switch {
-  background: rgba(var(--secondary-color, #e6ebf1bf), .15);
-}
-
-button#mokoThemeSwitch {
-  border: unset;
-  background-color: unset;
-}
-
-#mokoThemeFab .label {
-  user-select: none;
-  font-size: .875rem;
-}
-
 #mokoThemeFab.debug-outline {
   outline: 2px dashed var(--pink, #ff8fc0);
   outline-offset: 2px;
@@ -17499,12 +17500,13 @@ body[data-theme-fab-enabled="1"] #mokoA11yToolbar {
 
 /* Panel */
 .a11y-panel {
-  background: var(--bs-body-bg, #fff);
+  background: var(--body-bg, var(--bs-body-bg, #fff));
   border: 1px solid var(--border-color, #dee2e6);
   border-radius: var(--border-radius, .375rem);
   padding: .75rem;
   min-width: 200px;
   box-shadow: var(--box-shadow-lg, 0 1rem 3rem rgba(0,0,0,.175));
+  color: var(--body-font-color, var(--body-color, #e6ebf1));
 }
 
 .a11y-group {
@@ -17540,8 +17542,8 @@ body[data-theme-fab-enabled="1"] #mokoA11yToolbar {
   height: 34px;
   border: 1px solid var(--border-color, #dee2e6);
   border-radius: var(--border-radius, .375rem);
-  background: var(--bs-body-bg, #fff);
-  color: var(--body-font-color, #444);
+  background: var(--secondary-bg, var(--bs-body-bg, #fff));
+  color: var(--body-font-color, var(--body-color, #e6ebf1));
   font-size: .875rem;
   cursor: pointer;
   transition: background .15s, border-color .15s;
@@ -17559,7 +17561,7 @@ body[data-theme-fab-enabled="1"] #mokoA11yToolbar {
   font-weight: 600;
   min-width: 3ch;
   text-align: center;
-  color: var(--body-font-color, #444);
+  color: var(--body-font-color, var(--body-color, #e6ebf1));
 }
 
 .a11y-btn-wide {
@@ -18686,7 +18688,7 @@ nav[data-toggle=toc] .nav-link.active+ul{
 	flex: 0 0 auto;
 	background-color: var(--color-primary, #112855);
 	color: var(--mainmenu-nav-link-color, #fff);
-	border-color: var(--color-primary, #112855);
+	border: 1px solid var(--input-border-color, #3a4250);
 	padding: 0.6rem 1rem;
 	border-radius: 0 0.25rem 0.25rem 0;
 	transition: background-color 0.15s ease-in-out, border-color 0.15s ease-in-out;
@@ -18695,7 +18697,7 @@ nav[data-toggle=toc] .nav-link.active+ul{
 .mod-finder__search.input-group button:hover,
 .container-search button[type="submit"]:hover {
 	background-color: var(--color-hover, gray);
-	border-color: var(--color-hover, gray);
+	border-color: var(--input-border-color, #3a4250);
 }
 
 .mod-finder__search.input-group button:focus,
@@ -21664,6 +21666,33 @@ nav[data-toggle=toc] .nav-link.active+ul{
 	color: var(--gray-600, #48525d);
 }
 
+/* === mod_stats === */
+.mod_stats__table {
+	width: 100%;
+	border-collapse: collapse;
+}
+
+.mod_stats__table tr {
+	border-bottom: 1px solid var(--border-color, #2b323b);
+}
+
+.mod_stats__table tr:last-child {
+	border-bottom: none;
+}
+
+.mod_stats__label {
+	text-align: start;
+	font-weight: 600;
+	padding: 0.6rem 1rem 0.6rem 0;
+	color: var(--body-font-color, #e6ebf1);
+}
+
+.mod_stats__data {
+	text-align: end;
+	padding: 0.6rem 0;
+	color: var(--gray-600, #48525d);
+}
+
 /* === Mobile Responsive Adjustments === */
 @media (max-width: 575.98px) {
 	.mod-kunena-login__input {

src/media/images/bg.svg

@@ -4,6 +4,7 @@
 <svg
    width="800"
    height="400"
+   viewBox="0 0 800 400"
    id="svg2"
    version="1.1"
    sodipodi:docname="bg.svg"
@@ -93,14 +94,14 @@
        style="display:inline;fill:#e5e5e5;fill-opacity:1;stroke:none;stroke-width:2.20303"
        id="rect4741"
        width="800"
-       height="400"
+       height="494"
        x="0"
        y="46.331768" />
     <rect
        style="display:inline;fill:url(#pattern4758);fill-opacity:1;stroke:none;stroke-width:2.20303"
        id="rect4737"
        width="800"
-       height="400"
+       height="494"
        x="0"
        y="46.699127" />
   </g>

src/media/js/template.js

@@ -62,30 +62,33 @@
 		wrap.id = 'mokoThemeFab';
 		wrap.className = posClassFromBody();
 
-		// Light label
-		var lblL = doc.createElement('span');
-		lblL.className = 'label';
-		lblL.textContent = 'Light';
-
-		// Switch
+		// Sun/Moon toggle button
 		var switchWrap = doc.createElement('button');
 		switchWrap.id = 'mokoThemeSwitch';
 		switchWrap.type = 'button';
-		switchWrap.setAttribute('role', 'switch');
+		switchWrap.className = 'theme-icon-btn';
 		switchWrap.setAttribute('aria-label', 'Toggle dark mode');
-		switchWrap.setAttribute('aria-checked', 'false');
 
-		var track = doc.createElement('span');
-		track.className = 'switch';
-		var knob = doc.createElement('span');
-		knob.className = 'knob';
-		track.appendChild(knob);
-		switchWrap.appendChild(track);
+		var sunIcon = doc.createElement('i');
+		sunIcon.className = 'fa-solid fa-sun';
+		sunIcon.setAttribute('aria-hidden', 'true');
 
-		// Dark label
-		var lblD = doc.createElement('span');
-		lblD.className = 'label';
-		lblD.textContent = 'Dark';
+		var moonIcon = doc.createElement('i');
+		moonIcon.className = 'fa-solid fa-moon';
+		moonIcon.setAttribute('aria-hidden', 'true');
+
+		switchWrap.appendChild(sunIcon);
+		switchWrap.appendChild(moonIcon);
+
+		function updateThemeIcon(theme) {
+			if (theme === 'dark') {
+				switchWrap.classList.add('is-dark');
+				switchWrap.classList.remove('is-light');
+			} else {
+				switchWrap.classList.add('is-light');
+				switchWrap.classList.remove('is-dark');
+			}
+		}
 
 		// Auto toggle (on/off switch style)
 		var autoWrap = doc.createElement('div');
@@ -127,7 +130,7 @@
 			var current = (root.getAttribute('data-bs-theme') || 'light').toLowerCase();
 			var next = current === 'dark' ? 'light' : 'dark';
 			applyTheme(next);
-			switchWrap.setAttribute('aria-checked', next === 'dark' ? 'true' : 'false');
+			updateThemeIcon(next);
 			// Turn off auto when manually switching
 			auto.classList.remove('on');
 			auto.setAttribute('aria-checked', 'false');
@@ -145,7 +148,7 @@
 				clearStored();
 				var sys = systemTheme();
 				applyTheme(sys);
-				switchWrap.setAttribute('aria-checked', sys === 'dark' ? 'true' : 'false');
+				updateThemeIcon(sys);
 			}
 		});
 
@@ -154,7 +157,7 @@
 			if (!getStored()) {
 				var sys = systemTheme();
 				applyTheme(sys);
-				switchWrap.setAttribute('aria-checked', sys === 'dark' ? 'true' : 'false');
+				updateThemeIcon(sys);
 			}
 		};
 		if (typeof mql.addEventListener === 'function') mql.addEventListener('change', onMql);
@@ -162,12 +165,10 @@
 
 		// Initial state
 		var initial = getStored() || systemTheme();
-		switchWrap.setAttribute('aria-checked', initial === 'dark' ? 'true' : 'false');
+		updateThemeIcon(initial);
 
 		// Mount
-		wrap.appendChild(lblL);
 		wrap.appendChild(switchWrap);
-		wrap.appendChild(lblD);
 		wrap.appendChild(autoWrap);
 		wrap.appendChild(divider);
 		wrap.appendChild(a11ySlot);
@@ -292,7 +293,17 @@
 		toggle.className = "a11y-toggle";
 		toggle.setAttribute("aria-label", "Accessibility options");
 		toggle.setAttribute("aria-expanded", "false");
-		toggle.appendChild(faIcon("fa-solid fa-universal-access"));
+		var a11yIcon = faIcon("fa-solid fa-universal-access");
+		// Unicode fallback if FA7 glyph doesn't render (e.g. FA6/FA7 conflict)
+		setTimeout(function () {
+			var cs = win.getComputedStyle(a11yIcon, "::before");
+			if (!cs.content || cs.content === "none" || cs.content === '""' || cs.content === '"" / ""') {
+				a11yIcon.className = "";
+				a11yIcon.textContent = "\u267F";
+				a11yIcon.style.fontSize = "1.1rem";
+			}
+		}, 500);
+		toggle.appendChild(a11yIcon);
 
 		// Panel
 		var panel = doc.createElement("div");
@@ -630,6 +641,154 @@
 		});
 	}
 
+	// ========================================================================
+	// CSS VARIABLE CLICK-TO-COPY
+	// ========================================================================
+
+	/**
+	 * Inject toast + variable-chip styles once.
+	 */
+	function injectVarCopyStyles() {
+		if (doc.getElementById("moko-var-copy-styles")) return;
+		var style = doc.createElement("style");
+		style.id = "moko-var-copy-styles";
+		style.textContent =
+			".moko-var-chip{cursor:pointer;font-family:var(--font-monospace,monospace);font-size:.875em;" +
+			"background:var(--secondary-bg,#151b22);color:var(--link-color,#8ab4f8);" +
+			"border:1px solid var(--border-color,#2b323b);border-radius:.25rem;padding:.1em .4em;" +
+			"transition:background .15s,border-color .15s;white-space:nowrap;display:inline}" +
+			".moko-var-chip:hover{background:var(--color-primary,#112855);color:#fff;border-color:var(--color-primary,#112855)}" +
+			".moko-toast{position:fixed;bottom:1.5rem;left:50%;transform:translateX(-50%);z-index:10000;" +
+			"background:var(--color-primary,#112855);color:#fff;padding:.6rem 1.25rem;" +
+			"border-radius:.375rem;font-size:.875rem;box-shadow:0 4px 12px rgba(0,0,0,.25);" +
+			"opacity:0;transition:opacity .2s;pointer-events:none}" +
+			".moko-toast--show{opacity:1}";
+		doc.head.appendChild(style);
+	}
+
+	/**
+	 * Show a brief "Copied to clipboard" toast.
+	 * @param {string} text - The variable name that was copied
+	 */
+	function showCopyToast(text) {
+		var existing = doc.querySelector(".moko-toast");
+		if (existing) existing.remove();
+
+		var toast = doc.createElement("div");
+		toast.className = "moko-toast";
+		toast.textContent = "Copied to clipboard: " + text;
+		doc.body.appendChild(toast);
+
+		// Trigger reflow then show
+		void toast.offsetWidth;
+		toast.classList.add("moko-toast--show");
+
+		setTimeout(function () {
+			toast.classList.remove("moko-toast--show");
+			setTimeout(function () { toast.remove(); }, 200);
+		}, 2000);
+	}
+
+	/**
+	 * Copy text to clipboard and show toast.
+	 * @param {string} text
+	 */
+	function copyVariable(text) {
+		if (navigator.clipboard && navigator.clipboard.writeText) {
+			navigator.clipboard.writeText(text).then(function () {
+				showCopyToast(text);
+			});
+		} else {
+			// Fallback for older browsers using deprecated API
+			var ta = doc.createElement("textarea");
+			ta.value = text;
+			ta.style.cssText = "position:fixed;left:-9999px";
+			doc.body.appendChild(ta);
+			ta.select();
+			try { doc.execCommand("copy"); } catch (e) { /* noop */ }
+			ta.remove();
+			showCopyToast(text);
+		}
+	}
+
+	/**
+	 * Scan text nodes for CSS variable patterns (--variable-name) and wrap
+	 * each match in a clickable chip that copies the variable to clipboard.
+	 */
+	function initVarCopy() {
+		injectVarCopyStyles();
+
+		// Pattern: --[a-zA-Z] followed by word/hyphen chars
+		var varPattern = /--[a-zA-Z][\w-]*/g;
+
+		// Elements to skip (inputs, scripts, styles, already-processed, code editors)
+		var SKIP_TAGS = { SCRIPT: 1, STYLE: 1, TEXTAREA: 1, INPUT: 1, SELECT: 1, NOSCRIPT: 1 };
+
+		var walker = doc.createTreeWalker(
+			doc.body,
+			NodeFilter.SHOW_TEXT,
+			{
+				acceptNode: function (node) {
+					if (SKIP_TAGS[node.parentNode.tagName]) return NodeFilter.FILTER_REJECT;
+					if (node.parentNode.classList && node.parentNode.classList.contains("moko-var-chip")) return NodeFilter.FILTER_REJECT;
+					if (!varPattern.test(node.nodeValue)) return NodeFilter.FILTER_REJECT;
+					varPattern.lastIndex = 0;
+					return NodeFilter.FILTER_ACCEPT;
+				}
+			}
+		);
+
+		var textNodes = [];
+		while (walker.nextNode()) textNodes.push(walker.currentNode);
+
+		textNodes.forEach(function (node) {
+			var text = node.nodeValue;
+			var frag = doc.createDocumentFragment();
+			var lastIndex = 0;
+			var match;
+
+			varPattern.lastIndex = 0;
+			while ((match = varPattern.exec(text)) !== null) {
+				// Text before the match
+				if (match.index > lastIndex) {
+					frag.appendChild(doc.createTextNode(text.slice(lastIndex, match.index)));
+				}
+
+				// Clickable chip
+				var chip = doc.createElement("span");
+				chip.className = "moko-var-chip";
+				chip.textContent = match[0];
+				chip.setAttribute("role", "button");
+				chip.setAttribute("tabindex", "0");
+				chip.setAttribute("title", "Click to copy " + match[0]);
+				chip.addEventListener("click", (function (varName) {
+					return function (e) {
+						e.preventDefault();
+						copyVariable(varName);
+					};
+				})(match[0]));
+				chip.addEventListener("keydown", (function (varName) {
+					return function (e) {
+						if (e.key === "Enter" || e.key === " ") {
+							e.preventDefault();
+							copyVariable(varName);
+						}
+					};
+				})(match[0]));
+				frag.appendChild(chip);
+
+				lastIndex = match.index + match[0].length;
+			}
+
+			// Remaining text after last match
+			if (lastIndex < text.length) {
+				frag.appendChild(doc.createTextNode(text.slice(lastIndex)));
+			}
+
+			node.parentNode.replaceChild(frag, node);
+		});
+	}
+
 	/**
 	 * Run all template JS initializations
 	 */
@@ -656,6 +815,7 @@
 		initBackTop();
 		initSearchToggle();
 		initSidebarAccordion();
+		initVarCopy();
 	}
 
 	if (doc.readyState === "loading") {

src/offline.php

@@ -1,5 +1,5 @@
 <?php
-/* Copyright (C) 2025 Moko Consulting <hello@mokoconsulting.tech>
+/* Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
 
  This file is part of a Moko Consulting project.
 
@@ -26,59 +26,90 @@ use Joomla\CMS\Uri\Uri;
 
 $app       = Factory::getApplication();
 $doc       = Factory::getDocument();
+$wa        = $doc->getWebAssetManager();
 $params    = $this->params ?: $app->getTemplate(true)->params;
 $direction = $this->direction ?: 'ltr';
 
+// Register the template's asset manifest (not auto-loaded in offline context)
+$manifestPath = JPATH_ROOT . '/media/templates/site/' . $this->template . '/joomla.asset.json';
+if (is_file($manifestPath)) {
+	$wa->getRegistry()->addRegistryFile($manifestPath);
+}
+
+// Load language files (not auto-loaded in offline context)
+$lang = Factory::getLanguage();
+$lang->load('tpl_' . $this->template, JPATH_ROOT . '/templates/' . $this->template);
+$lang->load('tpl_' . $this->template, JPATH_ROOT);
+$lang->load('com_users', JPATH_ROOT);
+$lang->load('com_users', JPATH_ROOT . '/components/com_users');
+$lang->load('', JPATH_ROOT);
+
 /* -----------------------
-   Load ONLY template.css + theme palettes (with min toggle)
+   Load assets via WebAssetManager (matches index.php pattern)
 ------------------------ */
-$useMin      = !((int) $params->get('development_mode', 0) === 1);
-$assetSuffix = $useMin ? '.min' : '';
-$base        = rtrim(Uri::root(true), '/') . '/templates/' . $this->template . '/css/';
-$jsBase      = rtrim(Uri::root(true), '/') . '/templates/' . $this->template . '/js/';
+$params_developmentmode = (bool) $params->get('developmentmode', false) || (bool) $app->get('debug', false);
+$suffix = $params_developmentmode ? '' : '.min';
 
-$doc->addStyleSheet($base . 'template' . $assetSuffix . '.css', ['version' => 'auto'], ['id' => 'moko-template']);
+// Core template CSS + offline overlay CSS
+$wa->useStyle('template.base' . $suffix);
+$wa->useStyle('template.offline' . $suffix);
 
-/* Load theme palettes */
-$doc->addStyleSheet($base . 'theme/light.standard' . $assetSuffix . '.css', ['version' => 'auto'], ['id' => 'moko-light-standard']);
-$doc->addStyleSheet($base . 'theme/dark.standard' . $assetSuffix . '.css', ['version' => 'auto'], ['id' => 'moko-dark-standard']);
+// Osaka font
+$wa->useStyle('template.font.osaka');
 
-/* Load custom palettes only if selected in template configuration AND files exist */
+// Font Awesome 7 Free
+$wa->useStyle('vendor.fa7free.all' . $suffix);
+
+// Theme palettes
+$wa->useStyle('template.light.standard' . $suffix);
+$wa->useStyle('template.dark.standard' . $suffix);
+
+// Custom palettes (if selected and files exist)
 $params_LightColorName = (string) $params->get('colorLightName', 'standard');
 $params_DarkColorName = (string) $params->get('colorDarkName', 'standard');
 if ($params_LightColorName === 'custom' && file_exists(JPATH_ROOT . '/media/templates/site/mokocassiopeia/css/theme/light.custom.css'))
 {
-	$doc->addStyleSheet($base . 'theme/light.custom' . $assetSuffix . '.css', ['version' => 'auto'], ['id' => 'moko-light-custom']);
+	$wa->useStyle('template.light.custom' . $suffix);
 }
 if ($params_DarkColorName === 'custom' && file_exists(JPATH_ROOT . '/media/templates/site/mokocassiopeia/css/theme/dark.custom.css'))
 {
-	$doc->addStyleSheet($base . 'theme/dark.custom' . $assetSuffix . '.css', ['version' => 'auto'], ['id' => 'moko-dark-custom']);
+	$wa->useStyle('template.dark.custom' . $suffix);
 }
 
-/* Load user assets last (after all other styles and scripts) */
-$doc->addStyleSheet($base . 'user' . $assetSuffix . '.css', ['version' => 'auto'], ['id' => 'moko-user']);
+// User overrides (loaded last)
+$wa->useStyle('template.user');
 
-/* Bootstrap CSS/JS for accordion behavior; safe to keep. */
-HTMLHelper::_('bootstrap.loadCss', true, $doc);
+// Accessibility high-contrast stylesheet
+$wa->useStyle('template.a11y-high-contrast');
+
+// Template JS (theme switcher, a11y toolbar, var-copy, etc.)
+if ($params_developmentmode) {
+	$wa->useScript('template.js');
+} else {
+	$wa->useScript('template.js.min');
+}
+$wa->useScript('user.js');
+
+// Bootstrap CSS + JS (accordion, responsive grid, utilities)
+try {
+	$wa->useStyle('bootstrap.css');
+} catch (\Exception $e) {
+	// Fallback: load via HTMLHelper
+	HTMLHelper::_('bootstrap.loadCss', true, $doc);
+}
 HTMLHelper::_('bootstrap.framework');
 
-/* Load template.js for theme switcher and other functionality */
-$doc->addScript($jsBase . 'template' . $assetSuffix . '.js', ['version' => 'auto', 'defer' => true], ['id' => 'moko-template-js']);
-
-/* Load user.js last for custom user scripts */
-$doc->addScript($jsBase . 'user' . $assetSuffix . '.js', ['version' => 'auto', 'defer' => true], ['id' => 'moko-user-js']);
-
 /* -----------------------
-   Title + Meta (Include Site Name in Page Titles)
+   Title + Meta
 ------------------------ */
 $sitename  = (string) $app->get('sitename');
 $baseTitle = Text::_('JGLOBAL_OFFLINE') ?: 'Offline';
-$snSetting = (int) $app->get('sitename_pagetitles', 0); // 0=no, 1=before, 2=after
+$snSetting = (int) $app->get('sitename_pagetitles', 0);
 
 if ($snSetting === 1) {
-	$doc->setTitle(Text::sprintf('JPAGETITLE', $sitename, $baseTitle));  // Site Name BEFORE
+	$doc->setTitle(Text::sprintf('JPAGETITLE', $sitename, $baseTitle));
 } elseif ($snSetting === 2) {
-	$doc->setTitle(Text::sprintf('JPAGETITLE', $baseTitle, $sitename));  // Site Name AFTER
+	$doc->setTitle(Text::sprintf('JPAGETITLE', $baseTitle, $sitename));
 } else {
 	$doc->setTitle($baseTitle);
 }
@@ -87,11 +118,21 @@ $doc->setMetaData('robots', 'noindex, nofollow');
 /* -----------------------
    Offline content from Global Config
 ------------------------ */
-$displayOfflineMessage = (int) $app->get('display_offline_message', 1); // 0|1|2
+$displayOfflineMessage = (int) $app->get('display_offline_message', 1);
 $offlineMessage        = trim((string) $app->get('offline_message', ''));
 
 /* -----------------------
-   Brand: logo from params OR siteTitle (matches index.php)
+   Offline image from Joomla Global Config (System > Global Configuration > Site > Offline Image)
+   Used as the full-viewport background image.
+------------------------ */
+$offlineImage = trim((string) $app->get('offline_image', ''));
+$bgStyle = '';
+if ($offlineImage !== '') {
+	$bgStyle = 'background-image: url(\'' . htmlspecialchars(Uri::root(false) . $offlineImage, ENT_QUOTES, 'UTF-8') . '\');';
+}
+
+/* -----------------------
+   Brand: logo from template params OR siteTitle
 ------------------------ */
 $brandHtml = '';
 $logoFile  = (string) $params->get('logoFile');
@@ -106,9 +147,8 @@ if ($logoFile !== '') {
 		0
 	);
 } else {
-	// If no logo file, show the title (defaults to "MokoCassiopeia" if not set)
 	$siteTitle = $params->get('siteTitle', 'MokoCassiopeia');
-	$brandHtml = '<span class="site-title" title="' . $sitename . '">'
+	$brandHtml = '<span class="site-title" title="' . htmlspecialchars($sitename, ENT_QUOTES, 'UTF-8') . '">'
 			   . htmlspecialchars($siteTitle, ENT_COMPAT, 'UTF-8')
 			   . '</span>';
 }
@@ -116,8 +156,34 @@ if ($logoFile !== '') {
 $brandTagline = (string) ($params->get('brand_tagline') ?: $params->get('siteDescription') ?: '');
 $showTagline  = (int) $params->get('show_brand_tagline', 0);
 
+// Favicon
+$params_favicon_source = (string) $params->get('favicon_source', '');
+$faviconHeadTags = '';
+if ($params_favicon_source) {
+	require_once JPATH_ROOT . '/templates/' . $this->template . '/helper/favicon.php';
+	$faviconSourceAbs = JPATH_ROOT . '/' . ltrim($params_favicon_source, '/');
+	$faviconOutputDir = JPATH_ROOT . '/images/favicons';
+	$faviconUrlBase   = Uri::root(true) . '/images/favicons';
+
+	if (MokoFaviconHelper::generate($faviconSourceAbs, $faviconOutputDir)) {
+		$faviconHeadTags = MokoFaviconHelper::getHeadTags($faviconUrlBase);
+	}
+}
+
 // Theme params
-$params_theme_enabled = (int) $params->get('theme_enabled', 1);
+$params_theme_enabled     = (int) $params->get('theme_enabled', 1);
+$params_theme_fab_enabled = (int) $params->get('theme_fab_enabled', 1);
+$params_theme_fab_pos     = 'br';
+
+// Accessibility params
+$params_a11y_toolbar    = (int) $params->get('a11y_toolbar_enabled', 1);
+$params_a11y_resize     = (int) $params->get('a11y_text_resize', 1);
+$params_a11y_invert     = (int) $params->get('a11y_color_inversion', 1);
+$params_a11y_contrast   = (int) $params->get('a11y_high_contrast', 1);
+$params_a11y_links      = (int) $params->get('a11y_highlight_links', 1);
+$params_a11y_font       = (int) $params->get('a11y_readable_font', 1);
+$params_a11y_animations = (int) $params->get('a11y_pause_animations', 1);
+$params_a11y_pos        = 'br';
 
 // Analytics params
 $params_googletagmanager   = $params->get('googletagmanager', false);
@@ -131,7 +197,7 @@ if (!empty($params_googlesitekey)) {
 }
 
 /* -----------------------
-   Login routes & Users
+   Login routes
 ------------------------ */
 $action = Route::_('index.php', true);
 $return = base64_encode(Uri::base());
@@ -152,10 +218,12 @@ if (class_exists('\Joomla\Component\Users\Site\Helper\RouteHelper')) {
 <head>
 	<jdoc:include type="head" />
 	<meta name="viewport" content="width=device-width, initial-scale=1" />
+	<?php if ($faviconHeadTags) : ?>
+	<?php echo $faviconHeadTags; ?>
+	<?php endif; ?>
 
 	<?php if ($params_theme_enabled) : ?>
 	<script>
-	  // Early theme application to avoid FOUC
 	  (function () {
 		try {
 		  var stored = localStorage.getItem('theme');
@@ -168,20 +236,21 @@ if (class_exists('\Joomla\Component\Users\Site\Helper\RouteHelper')) {
 	</script>
 	<?php endif; ?>
 
-	<style>
-		.moko-offline-wrap { min-height: 100vh; display: grid; grid-template-rows: auto 1fr auto; }
-		.moko-offline-main { display: grid; place-items: center; padding: 2rem 1rem; }
-		.moko-card { max-width: 720px; width: 100%; }
-		.moko-brand { display:flex; align-items:center; gap:.75rem; text-decoration:none; }
-		.moko-brand .brand-tagline { display:block; opacity:.75; font-size:.875rem; line-height:1.2; }
-		.skip-link { position:absolute; left:-9999px; top:auto; width:1px; height:1px; overflow:hidden; }
-		.skip-link:focus { position:static; width:auto; height:auto; padding:.5rem 1rem; }
-	</style>
 </head>
-<body class="site moko-offline-wrap <?php echo htmlspecialchars($direction, ENT_QUOTES, 'UTF-8'); ?>">
+<body class="site moko-offline-wrap"
+	data-theme-fab-enabled="<?php echo $params_theme_fab_enabled ? '1' : '0'; ?>"
+	data-theme-fab-pos="<?php echo htmlspecialchars($params_theme_fab_pos, ENT_QUOTES, 'UTF-8'); ?>"
+	data-a11y-toolbar="<?php echo $params_a11y_toolbar ? '1' : '0'; ?>"
+	data-a11y-resize="<?php echo $params_a11y_resize ? '1' : '0'; ?>"
+	data-a11y-invert="<?php echo $params_a11y_invert ? '1' : '0'; ?>"
+	data-a11y-contrast="<?php echo $params_a11y_contrast ? '1' : '0'; ?>"
+	data-a11y-links="<?php echo $params_a11y_links ? '1' : '0'; ?>"
+	data-a11y-font="<?php echo $params_a11y_font ? '1' : '0'; ?>"
+	data-a11y-animations="<?php echo $params_a11y_animations ? '1' : '0'; ?>"
+	data-a11y-pos="<?php echo htmlspecialchars($params_a11y_pos, ENT_QUOTES, 'UTF-8'); ?>"
+	<?php if ($bgStyle) : ?>style="<?php echo $bgStyle; ?>"<?php endif; ?>>
 <?php if (!empty($params_googletagmanager) && !empty($params_googletagmanagerid)) :
 	$gtmID = htmlspecialchars($params_googletagmanagerid, ENT_QUOTES, 'UTF-8'); ?>
-	<!-- Google Tag Manager -->
 	<script>
 		(function(w,d,s,l,i){
 			w[l]=w[l]||[];
@@ -194,19 +263,14 @@ if (class_exists('\Joomla\Component\Users\Site\Helper\RouteHelper')) {
 			f.parentNode.insertBefore(j,f);
 		})(window,document,'script','dataLayer','<?php echo $gtmID; ?>');
 	</script>
-	<!-- End Google Tag Manager -->
-
-	<!-- Google Tag Manager (noscript) -->
 	<noscript>
 		<iframe src="https://www.googletagmanager.com/ns.html?id=<?php echo $gtmID; ?>"
 				height="0" width="0" style="display:none;visibility:hidden"></iframe>
 	</noscript>
-	<!-- End Google Tag Manager (noscript) -->
 <?php endif; ?>
 
 <?php if (!empty($params_googleanalytics) && !empty($params_googleanalyticsid)) :
 	$gaId = htmlspecialchars($params_googleanalyticsid, ENT_QUOTES, 'UTF-8'); ?>
-	<!-- Google Analytics (gtag.js) -->
 	<script async src="https://www.googletagmanager.com/gtag/js?id=<?php echo $gaId; ?>"></script>
 	<script>
 		window.dataLayer = window.dataLayer || [];
@@ -223,136 +287,128 @@ if (class_exists('\Joomla\Component\Users\Site\Helper\RouteHelper')) {
 				gtag('config', id, { 'anonymize_ip': true });
 			} else if (/^UA-/.test(id)) {
 				gtag('config', id, { 'anonymize_ip': true });
-				console.warn('Using a UA- ID. Universal Analytics is sunset; consider migrating to GA4.');
 			} else {
 				console.warn('Unrecognized Google Analytics ID format:', id);
 			}
 		})('<?php echo $gaId; ?>');
 	</script>
-	<!-- End Google Analytics -->
 <?php endif; ?>
 
 	<a class="skip-link" href="#maincontent"><?php echo Text::_('JSKIP_TO_CONTENT') ?: 'Skip to content'; ?></a>
 
-	<header class="container-header header py-3">
-		<div class="grid-child container-nav d-flex align-items-center gap-3">
+	<!-- Centered overlay card -->
+	<main id="maincontent">
+		<div class="moko-offline-card">
 
-			<!-- Brand (mutually exclusive image/text) -->
-			<a class="moko-brand me-auto" href="<?php echo htmlspecialchars(Uri::base(), ENT_QUOTES, 'UTF-8'); ?>" aria-label="<?php echo htmlspecialchars($sitename, ENT_COMPAT, 'UTF-8'); ?>">
+			<!-- Logo -->
+			<a class="moko-offline-brand" href="<?php echo htmlspecialchars(Uri::base(), ENT_QUOTES, 'UTF-8'); ?>" aria-label="<?php echo htmlspecialchars($sitename, ENT_COMPAT, 'UTF-8'); ?>">
 				<?php echo $brandHtml; ?>
 				<?php if ($showTagline && $brandTagline): ?>
 					<small class="brand-tagline"><?php echo htmlspecialchars($brandTagline, ENT_COMPAT, 'UTF-8'); ?></small>
 				<?php endif; ?>
 			</a>
 
-			<!-- Header module position: offline-header -->
-			<?php if ($this->countModules('offline-header')) : ?>
-				<div class="ms-2">
-					<jdoc:include type="modules" name="offline-header" style="none" />
+			<!-- Offline message: 0=hidden, 1=custom message, 2=system language string -->
+			<?php if ($displayOfflineMessage === 1 && $offlineMessage !== '') : ?>
+				<div class="moko-offline-message">
+					<p><?php echo $offlineMessage; ?></p>
+				</div>
+			<?php elseif ($displayOfflineMessage === 2) : ?>
+				<div class="moko-offline-message">
+					<p><?php echo Text::_('JOFFLINE_MESSAGE') ?: 'This site is down for maintenance.'; ?></p>
 				</div>
 			<?php endif; ?>
 
-		</div>
-	</header>
+			<!-- Offline module position -->
+			<?php if ($this->countModules('offline')) : ?>
+				<div class="moko-offline-modules">
+					<jdoc:include type="modules" name="offline" style="none" />
+				</div>
+			<?php endif; ?>
 
-	<main id="maincontent" class="moko-offline-main">
-		<div class="container">
-			<jdoc:include type="message" />
+			<!-- Login accordion -->
+			<div class="accordion" id="offlineAccordion">
+				<div class="accordion-item">
+					<h2 class="accordion-header" id="headingLogin">
+						<button class="accordion-button collapsed" type="button"
+							data-bs-toggle="collapse" data-bs-target="#collapseLogin"
+							aria-expanded="false" aria-controls="collapseLogin">
+							<?php echo Text::_('JLOGIN'); ?>
+						</button>
+					</h2>
+					<div id="collapseLogin" class="accordion-collapse collapse" aria-labelledby="headingLogin" data-bs-parent="#offlineAccordion">
+						<div class="accordion-body">
+							<form action="<?php echo $action; ?>" method="post" class="form-validate">
+								<fieldset>
+									<legend class="visually-hidden"><?php echo Text::_('JLOGIN'); ?></legend>
 
-			<div class="moko-card card shadow-sm rounded-3 p-4 p-md-5">
-				<?php if ($displayOfflineMessage === 1 && $offlineMessage !== '') : ?>
-					<div class="mb-4">
-						<h1 class="h3 mb-2"><?php echo Text::_('JOFFLINE_MESSAGE') ?: 'Site Offline'; ?></h1>
-						<p class="lead mb-0"><?php echo $offlineMessage; ?></p>
-					</div>
-				<?php elseif ($displayOfflineMessage === 2) : ?>
-					<div class="mb-4">
-						<h1 class="h3 mb-2"><?php echo Text::_('JOFFLINE_MESSAGE') ?: 'Site Offline'; ?></h1>
-						<p class="lead mb-0">
-							<?php echo Text::_('JOFFLINE_MESSAGE_DEFAULT') ?: 'This site is down for maintenance. Please check back soon.'; ?>
-						</p>
-					</div>
-				<?php endif; ?>
+									<div class="mb-3">
+										<label class="form-label" for="username"><?php echo Text::_('JGLOBAL_USERNAME'); ?></label>
+										<input class="form-control" type="text" name="username" id="username" autocomplete="username" required aria-required="true">
+									</div>
 
-				<!-- Main offline module position -->
-				<?php if ($this->countModules('offline')) : ?>
-					<section class="mb-4" aria-label="Offline modules">
-						<jdoc:include type="modules" name="offline" style="none" />
-					</section>
-				<?php endif; ?>
+									<div class="mb-3">
+										<label class="form-label" for="password"><?php echo Text::_('JGLOBAL_PASSWORD'); ?></label>
+										<input class="form-control" type="password" name="password" id="password" autocomplete="current-password" required aria-required="true">
+									</div>
 
-				<!-- Login UNDER an accordion (collapsed by default) -->
-				<div class="accordion" id="offlineAccordion">
-					<div class="accordion-item">
-						<h2 class="accordion-header" id="headingLogin">
-							<button class="accordion-button collapsed" type="button"
-								data-bs-toggle="collapse" data-bs-target="#collapseLogin"
-								aria-expanded="false" aria-controls="collapseLogin">
-								<?php echo Text::_('JLOGIN'); ?>
-							</button>
-						</h2>
-						<div id="collapseLogin" class="accordion-collapse collapse" aria-labelledby="headingLogin" data-bs-parent="#offlineAccordion">
-							<div class="accordion-body">
-								<form action="<?php echo $action; ?>" method="post" class="form-validate">
-									<fieldset>
-										<legend class="visually-hidden"><?php echo Text::_('JLOGIN'); ?></legend>
+									<div class="mb-3">
+										<label class="form-label" for="secretkey"><?php echo Text::_('JGLOBAL_SECRETKEY'); ?></label>
+										<input class="form-control" type="text" name="secretkey" id="secretkey" autocomplete="one-time-code" placeholder="<?php echo Text::_('JGLOBAL_SECRETKEY'); ?>">
+									</div>
 
-										<div class="mb-3">
-											<label class="form-label" for="username"><?php echo Text::_('JGLOBAL_USERNAME'); ?></label>
-											<input class="form-control" type="text" name="username" id="username" autocomplete="username" required aria-required="true">
-										</div>
+									<div class="form-check mb-4">
+										<input class="form-check-input" type="checkbox" name="remember" id="remember">
+										<label class="form-check-label" for="remember"><?php echo Text::_('JGLOBAL_REMEMBER_ME'); ?></label>
+									</div>
 
-										<div class="mb-3">
-											<label class="form-label" for="password"><?php echo Text::_('JGLOBAL_PASSWORD'); ?></label>
-											<input class="form-control" type="password" name="password" id="password" autocomplete="current-password" required aria-required="true">
-										</div>
+									<div class="d-grid">
+										<button type="submit" class="btn btn-primary"><?php echo Text::_('JLOGIN'); ?></button>
+									</div>
 
-										<div class="mb-3">
-											<label class="form-label" for="secretkey"><?php echo Text::_('JGLOBAL_SECRETKEY'); ?></label>
-											<input class="form-control" type="text" name="secretkey" id="secretkey" autocomplete="one-time-code" placeholder="<?php echo Text::_('JGLOBAL_SECRETKEY'); ?>">
-										</div>
+									<input type="hidden" name="option" value="com_users">
+									<input type="hidden" name="task" value="user.login">
+									<input type="hidden" name="return" value="<?php echo $return; ?>">
+									<?php echo HTMLHelper::_('form.token'); ?>
+								</fieldset>
 
-										<div class="form-check mb-4">
-											<input class="form-check-input" type="checkbox" name="remember" id="remember">
-											<label class="form-check-label" for="remember"><?php echo Text::_('JGLOBAL_REMEMBER_ME'); ?></label>
-										</div>
-
-										<div class="d-grid">
-											<button type="submit" class="btn btn-primary"><?php echo Text::_('JLOGIN'); ?></button>
-										</div>
-
-										<input type="hidden" name="option" value="com_users">
-										<input type="hidden" name="task" value="user.login">
-										<input type="hidden" name="return" value="<?php echo $return; ?>">
-										<?php echo HTMLHelper::_('form.token'); ?>
-									</fieldset>
-
-									<nav class="mt-3 small" aria-label="<?php echo Text::_('COM_USERS'); ?>">
-										<ul class="list-inline m-0">
+								<nav class="mt-3 small" aria-label="<?php echo Text::_('COM_USERS'); ?>">
+									<ul class="list-inline m-0">
+										<li class="list-inline-item">
+											<a href="<?php echo $resetUrl; ?>"><?php echo Text::_('COM_USERS_LOGIN_RESET'); ?></a>
+										</li>
+										<li class="list-inline-item">
+											<a href="<?php echo $remindUrl; ?>"><?php echo Text::_('COM_USERS_LOGIN_REMIND'); ?></a>
+										</li>
+										<?php if ($allowRegistration) : ?>
 											<li class="list-inline-item">
-												<a href="<?php echo $resetUrl; ?>"><?php echo Text::_('COM_USERS_LOGIN_RESET'); ?></a>
+												<a href="<?php echo $registrationUrl; ?>"><?php echo Text::_('COM_USERS_REGISTER'); ?></a>
 											</li>
-											<li class="list-inline-item">
-												<a href="<?php echo $remindUrl; ?>"><?php echo Text::_('COM_USERS_LOGIN_REMIND'); ?></a>
-											</li>
-											<?php if ($allowRegistration) : ?>
-												<li class="list-inline-item">
-													<a href="<?php echo $registrationUrl; ?>"><?php echo Text::_('COM_USERS_REGISTER'); ?></a>
-												</li>
-											<?php endif; ?>
-										</ul>
-									</nav>
-								</form>
-							</div>
+										<?php endif; ?>
+									</ul>
+								</nav>
+							</form>
 						</div>
 					</div>
 				</div>
-				<!-- /accordion -->
 			</div>
+
+			<!-- Copyright -->
+			<div class="moko-offline-copyright">
+				<div>&copy; <?php echo date('Y'); ?> <?php echo htmlspecialchars($sitename, ENT_COMPAT, 'UTF-8'); ?></div>
+				<div><?php echo Text::_('MOD_FOOTER_LINE2'); ?></div>
+			</div>
+
 		</div>
 	</main>
 
-	<!-- No footer modules on offline page -->
+	<!-- Offline footer module position -->
+	<?php if ($this->countModules('offline-footer')) : ?>
+		<div class="moko-offline-messages mt-3">
+			<jdoc:include type="modules" name="offline-footer" style="none" />
+		</div>
+	<?php endif; ?>
+
 	<jdoc:include type="modules" name="debug" style="none" />
 </body>
 </html>

src/script.php

@@ -1,6 +1,6 @@
 <?php
 /**
- * Copyright (C) 2025 Moko Consulting <hello@mokoconsulting.tech>
+ * Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
  *
  * This file is part of a Moko Consulting project.
  *
@@ -8,49 +8,40 @@
  */
 
 /**
- * Template install/update/uninstall script.
- * Joomla calls the methods in this class automatically during template
- * install, update, and uninstall via the <scriptfile> element in
- * templateDetails.xml.
- * Joomla 5 and 6 compatible — uses the InstallerScriptInterface when
- * available, falls back to the legacy class-based approach otherwise.
+ * MokoCassiopeia install/update/uninstall script.
+ *
+ * On update: copies the template as MokoOnyx (new directory), updates the
+ * database to register MokoOnyx, migrates styles + params, and sets it as
+ * the default site template. The old MokoCassiopeia directory stays intact
+ * (Joomla's installer still needs it) — the user can uninstall it later.
  */
 
 defined('_JEXEC') or die;
 
 use Joomla\CMS\Factory;
 use Joomla\CMS\Installer\InstallerAdapter;
+use Joomla\CMS\Installer\InstallerScriptInterface;
 use Joomla\CMS\Log\Log;
 
-class Tpl_MokocassiopeiaInstallerScript
+class Tpl_MokocassiopeiaInstallerScript implements InstallerScriptInterface
 {
-    /**
-     * Minimum PHP version required by this template.
-     */
-    private const MIN_PHP = '8.1.0';
-
-    /**
-     * Minimum Joomla version required by this template.
-     */
+    private const MIN_PHP    = '8.1.0';
     private const MIN_JOOMLA = '4.4.0';
 
-    /**
-     * Called before install/update/uninstall.
-     *
-     * @param   string            $type     install, update, discover_install, or uninstall.
-     * @param   InstallerAdapter  $parent   The adapter calling this method.
-     *
-     * @return  bool  True to proceed, false to abort.
-     */
+    private const OLD_NAME    = 'mokocassiopeia';
+    private const NEW_NAME    = 'mokoonyx';
+    private const OLD_DISPLAY = 'MokoCassiopeia';
+    private const NEW_DISPLAY = 'MokoOnyx';
+
+    private const ONYX_UPDATES_URL = 'https://git.mokoconsulting.tech/MokoConsulting/MokoOnyx/raw/branch/main/updates.xml';
+
+    // ── Joomla lifecycle ───────────────────────────────────────────────
+
     public function preflight(string $type, InstallerAdapter $parent): bool
     {
         if (version_compare(PHP_VERSION, self::MIN_PHP, '<')) {
             Factory::getApplication()->enqueueMessage(
-                sprintf(
-                    'MokoCassiopeia requires PHP %s or later. You are running PHP %s.',
-                    self::MIN_PHP,
-                    PHP_VERSION
-                ),
+                sprintf('MokoCassiopeia requires PHP %s+. Running %s.', self::MIN_PHP, PHP_VERSION),
                 'error'
             );
             return false;
@@ -58,11 +49,7 @@ class Tpl_MokocassiopeiaInstallerScript
 
         if (version_compare(JVERSION, self::MIN_JOOMLA, '<')) {
             Factory::getApplication()->enqueueMessage(
-                sprintf(
-                    'MokoCassiopeia requires Joomla %s or later. You are running Joomla %s.',
-                    self::MIN_JOOMLA,
-                    JVERSION
-                ),
+                sprintf('MokoCassiopeia requires Joomla %s+. Running %s.', self::MIN_JOOMLA, JVERSION),
                 'error'
             );
             return false;
@@ -71,151 +58,364 @@ class Tpl_MokocassiopeiaInstallerScript
         return true;
     }
 
-    /**
-     * Called after a successful install.
-     *
-     * @param   InstallerAdapter  $parent  The adapter calling this method.
-     *
-     * @return  bool
-     */
     public function install(InstallerAdapter $parent): bool
     {
-        $this->logMessage('MokoCassiopeia template installed.');
+        $this->log('MokoCassiopeia installed.');
         return true;
     }
 
-    /**
-     * Called after a successful update.
-     *
-     * This is where the CSS variable sync runs — it detects variables that
-     * were added in the new version and injects them into the user's custom
-     * palette files without overwriting existing values.
-     *
-     * @param   InstallerAdapter  $parent  The adapter calling this method.
-     *
-     * @return  bool
-     */
     public function update(InstallerAdapter $parent): bool
     {
-        $this->logMessage('MokoCassiopeia template updated.');
-
-        // Run CSS variable sync to inject any new variables into user's custom palettes.
-        $synced = $this->syncCustomVariables($parent);
-
-        if ($synced > 0) {
-            Factory::getApplication()->enqueueMessage(
-                sprintf(
-                    'MokoCassiopeia: %d new CSS variable(s) were added to your custom palette files. '
-                    . 'Review them in your light.custom.css and/or dark.custom.css to customise the new defaults.',
-                    $synced
-                ),
-                'notice'
-            );
-        }
-
+        $this->log('MokoCassiopeia update() — version ' . ($parent->getManifest()->version ?? '?'));
         return true;
     }
 
-    /**
-     * Called after a successful uninstall.
-     *
-     * @param   InstallerAdapter  $parent  The adapter calling this method.
-     *
-     * @return  bool
-     */
     public function uninstall(InstallerAdapter $parent): bool
     {
-        $this->logMessage('MokoCassiopeia template uninstalled.');
+        $this->log('MokoCassiopeia uninstalled.');
         return true;
     }
 
-    /**
-     * Called after install/update completes (regardless of type).
-     *
-     * @param   string            $type    install, update, or discover_install.
-     * @param   InstallerAdapter  $parent  The adapter calling this method.
-     *
-     * @return  bool
-     */
     public function postflight(string $type, InstallerAdapter $parent): bool
     {
+        // Debug: write directly to confirm script runs
+        @file_put_contents(
+            JPATH_ROOT . '/administrator/logs/bridge_debug.txt',
+            date('Y-m-d H:i:s') . " postflight called, type={$type}\n",
+            FILE_APPEND
+        );
+
+        if ($type === 'update') {
+            $this->log('=== MokoCassiopeia → MokoOnyx bridge ===');
+            $this->bridge();
+        }
+
         return true;
     }
 
-    /**
-     * Run the CSS variable sync utility.
-     *
-     * Loads sync_custom_vars.php from the template directory and calls
-     * MokoCssVarSync::run() to detect and inject missing variables.
-     *
-     * @param   InstallerAdapter  $parent  The adapter calling this method.
-     *
-     * @return  int  Number of variables added across all files.
-     */
-    private function syncCustomVariables(InstallerAdapter $parent): int
+    // ── Bridge ─────────────────────────────────────────────────────────
+
+    private function bridge(): void
     {
-        $templateDir = $parent->getParent()->getPath('source');
+        $app = Factory::getApplication();
 
-        // The sync script lives alongside this script in the template root.
-        $syncScript = $templateDir . '/sync_custom_vars.php';
-
-        if (!is_file($syncScript)) {
-            $this->logMessage('CSS variable sync script not found at: ' . $syncScript, 'warning');
-            return 0;
+        // 1. Copy template directory (don't rename — Joomla still needs the old one)
+        $copied = $this->copyTemplateDir();
+        if (!$copied && !is_dir(JPATH_ROOT . '/templates/' . self::NEW_NAME)) {
+            $app->enqueueMessage(
+                'MokoOnyx bridge: could not create template directory. '
+                . 'Please copy <code>templates/mokocassiopeia</code> to <code>templates/mokoonyx</code> manually.',
+                'warning'
+            );
+            return;
         }
 
-        require_once $syncScript;
+        // 2. Copy media directory
+        $this->copyMediaDir();
 
-        if (!class_exists('MokoCssVarSync')) {
-            $this->logMessage('MokoCssVarSync class not found after loading script.', 'warning');
-            return 0;
+        // 3. Register MokoOnyx in #__extensions (if not already there)
+        $this->registerExtension();
+
+        // 4. Migrate template styles (create MokoOnyx styles with same params)
+        $this->migrateStyles();
+
+        // 5. Redirect update server to MokoOnyx
+        $this->updateUpdateServer();
+
+        // 6. Unlock MokoCassiopeia (allow uninstall) + lock MokoOnyx (prevent accidental uninstall)
+        $this->updateExtensionLocks();
+
+        // 7. Notify
+        $app->enqueueMessage(
+            '<strong>MokoOnyx has been installed as a replacement for MokoCassiopeia.</strong><br>'
+            . 'Your template settings have been migrated. MokoOnyx is now your active site template.<br>'
+            . 'MokoCassiopeia has been unlocked — you can uninstall it from Extensions &rarr; Manage.',
+            'success'
+        );
+
+        $this->log('=== Bridge completed ===');
+    }
+
+    // ── Copy directories ───────────────────────────────────────────────
+
+    private function copyTemplateDir(): bool
+    {
+        $src = JPATH_ROOT . '/templates/' . self::OLD_NAME;
+        $dst = JPATH_ROOT . '/templates/' . self::NEW_NAME;
+
+        if (is_dir($dst)) {
+            $this->log('Bridge: templates/' . self::NEW_NAME . ' already exists — skipping copy.');
+            return true;
+        }
+
+        if (!is_dir($src)) {
+            $this->log('Bridge: source template dir not found.', 'error');
+            return false;
+        }
+
+        $result = $this->recursiveCopy($src, $dst);
+        $this->log('Bridge: ' . ($result ? 'copied' : 'FAILED to copy') . ' template dir → ' . self::NEW_NAME);
+        return $result;
+    }
+
+    private function copyMediaDir(): void
+    {
+        $src = JPATH_ROOT . '/media/templates/site/' . self::OLD_NAME;
+        $dst = JPATH_ROOT . '/media/templates/site/' . self::NEW_NAME;
+
+        if (is_dir($dst)) {
+            $this->log('Bridge: media dir already exists — skipping.');
+            return;
+        }
+
+        if (!is_dir($src)) {
+            $this->log('Bridge: source media dir not found — skipping.');
+            return;
+        }
+
+        $result = $this->recursiveCopy($src, $dst);
+        $this->log('Bridge: ' . ($result ? 'copied' : 'FAILED to copy') . ' media dir → ' . self::NEW_NAME);
+    }
+
+    private function recursiveCopy(string $src, string $dst): bool
+    {
+        if (!mkdir($dst, 0755, true) && !is_dir($dst)) {
+            return false;
+        }
+
+        $dir = opendir($src);
+        if ($dir === false) {
+            return false;
+        }
+
+        while (($file = readdir($dir)) !== false) {
+            if ($file === '.' || $file === '..') {
+                continue;
+            }
+
+            $srcPath = $src . '/' . $file;
+            $dstPath = $dst . '/' . $file;
+
+            if (is_dir($srcPath)) {
+                $this->recursiveCopy($srcPath, $dstPath);
+            } else {
+                copy($srcPath, $dstPath);
+            }
+        }
+
+        closedir($dir);
+        return true;
+    }
+
+    // ── Database updates ───────────────────────────────────────────────
+
+    private function registerExtension(): void
+    {
+        $db = Factory::getDbo();
+
+        // Check if MokoOnyx is already registered
+        $query = $db->getQuery(true)
+            ->select('extension_id')
+            ->from('#__extensions')
+            ->where($db->quoteName('element') . ' = ' . $db->quote(self::NEW_NAME))
+            ->where($db->quoteName('type') . ' = ' . $db->quote('template'));
+        $exists = (int) $db->setQuery($query)->loadResult();
+
+        if ($exists) {
+            $this->log('Bridge: MokoOnyx already registered in #__extensions (id=' . $exists . ').');
+            return;
+        }
+
+        // Copy the MokoCassiopeia extension row and change element/name
+        $query = $db->getQuery(true)
+            ->select('*')
+            ->from('#__extensions')
+            ->where($db->quoteName('element') . ' = ' . $db->quote(self::OLD_NAME))
+            ->where($db->quoteName('type') . ' = ' . $db->quote('template'));
+        $oldExt = $db->setQuery($query)->loadObject();
+
+        if (!$oldExt) {
+            $this->log('Bridge: MokoCassiopeia not found in #__extensions.', 'warning');
+            return;
+        }
+
+        $newExt = clone $oldExt;
+        unset($newExt->extension_id);
+        $newExt->element = self::NEW_NAME;
+        $newExt->name    = self::NEW_NAME;
+
+        // Update manifest_cache to reflect new name
+        if (is_string($newExt->manifest_cache)) {
+            $newExt->manifest_cache = str_replace(self::OLD_NAME, self::NEW_NAME, $newExt->manifest_cache);
+            $newExt->manifest_cache = str_replace(self::OLD_DISPLAY, self::NEW_DISPLAY, $newExt->manifest_cache);
         }
 
         try {
-            $joomlaRoot = JPATH_ROOT;
-            $results = MokoCssVarSync::run($joomlaRoot);
-
-            $totalAdded = 0;
-            foreach ($results as $filePath => $result) {
-                $totalAdded += count($result['added']);
-                if (!empty($result['added'])) {
-                    $this->logMessage(
-                        sprintf(
-                            'CSS sync: added %d variable(s) to %s',
-                            count($result['added']),
-                            basename($filePath)
-                        )
-                    );
-                }
-            }
-
-            return $totalAdded;
+            $db->insertObject('#__extensions', $newExt, 'extension_id');
+            $this->log('Bridge: registered MokoOnyx in #__extensions (id=' . $newExt->extension_id . ').');
         } catch (\Throwable $e) {
-            $this->logMessage('CSS variable sync failed: ' . $e->getMessage(), 'error');
-            return 0;
+            $this->log('Bridge: failed to register extension: ' . $e->getMessage(), 'error');
         }
     }
 
-    /**
-     * Log a message to Joomla's log system.
-     *
-     * @param   string  $message   The log message.
-     * @param   string  $priority  Log priority (info, warning, error).
-     */
-    private function logMessage(string $message, string $priority = 'info'): void
+    private function migrateStyles(): void
     {
-        $priorities = [
-            'info'    => Log::INFO,
-            'warning' => Log::WARNING,
-            'error'   => Log::ERROR,
-        ];
+        $db = Factory::getDbo();
 
-        Log::addLogger(
-            ['text_file' => 'mokocassiopeia.log.php'],
-            Log::ALL,
-            ['mokocassiopeia']
-        );
+        // Get all MokoCassiopeia styles
+        $query = $db->getQuery(true)
+            ->select('*')
+            ->from('#__template_styles')
+            ->where($db->quoteName('template') . ' = ' . $db->quote(self::OLD_NAME))
+            ->where($db->quoteName('client_id') . ' = 0');
+        $oldStyles = $db->setQuery($query)->loadObjectList();
 
-        Log::add($message, $priorities[$priority] ?? Log::INFO, 'mokocassiopeia');
+        if (empty($oldStyles)) {
+            $this->log('Bridge: no MokoCassiopeia styles found.');
+            return;
+        }
+
+        $this->log('Bridge: migrating ' . count($oldStyles) . ' style(s).');
+
+        foreach ($oldStyles as $old) {
+            $newTitle = str_replace(self::OLD_DISPLAY, self::NEW_DISPLAY, $old->title);
+            $newTitle = str_replace(self::OLD_NAME, self::NEW_NAME, $newTitle);
+
+            // Skip if MokoOnyx already has this style
+            $check = $db->getQuery(true)
+                ->select('COUNT(*)')
+                ->from('#__template_styles')
+                ->where($db->quoteName('template') . ' = ' . $db->quote(self::NEW_NAME))
+                ->where($db->quoteName('title') . ' = ' . $db->quote($newTitle));
+            if ((int) $db->setQuery($check)->loadResult() > 0) {
+                $this->log("Bridge: style '{$newTitle}' already exists — skipping.");
+                continue;
+            }
+
+            $newParams = is_string($old->params)
+                ? str_replace(self::OLD_NAME, self::NEW_NAME, $old->params)
+                : $old->params;
+
+            $new = clone $old;
+            unset($new->id);
+            $new->template = self::NEW_NAME;
+            $new->title    = $newTitle;
+            $new->params   = $newParams;
+            $new->home     = 0;
+
+            try {
+                $db->insertObject('#__template_styles', $new, 'id');
+                $newId = $new->id;
+
+                // If old was default, make new default
+                if ($old->home == 1) {
+                    $db->setQuery(
+                        $db->getQuery(true)
+                            ->update('#__template_styles')
+                            ->set($db->quoteName('home') . ' = 1')
+                            ->where('id = ' . (int) $newId)
+                    )->execute();
+
+                    $db->setQuery(
+                        $db->getQuery(true)
+                            ->update('#__template_styles')
+                            ->set($db->quoteName('home') . ' = 0')
+                            ->where('id = ' . (int) $old->id)
+                    )->execute();
+
+                    $this->log('Bridge: set MokoOnyx as default site template.');
+                }
+
+                $this->log("Bridge: created style '{$newTitle}'.");
+            } catch (\Throwable $e) {
+                $this->log("Bridge: failed to create style '{$newTitle}': " . $e->getMessage(), 'warning');
+            }
+        }
+    }
+
+    private function updateUpdateServer(): void
+    {
+        $db = Factory::getDbo();
+
+        try {
+            $query = $db->getQuery(true)
+                ->update('#__update_sites')
+                ->set($db->quoteName('location') . ' = ' . $db->quote(self::ONYX_UPDATES_URL))
+                ->set($db->quoteName('name') . ' = ' . $db->quote(self::NEW_DISPLAY))
+                ->where($db->quoteName('location') . ' LIKE ' . $db->quote('%MokoCassiopeia%'));
+            $db->setQuery($query)->execute();
+
+            $n = $db->getAffectedRows();
+            if ($n > 0) {
+                $this->log("Bridge: redirected {$n} update site(s) to MokoOnyx.");
+            }
+        } catch (\Throwable $e) {
+            $this->log('Bridge: update server redirect failed: ' . $e->getMessage(), 'warning');
+        }
+
+        // Clear cached updates
+        try {
+            $db->setQuery(
+                $db->getQuery(true)
+                    ->delete('#__updates')
+                    ->where($db->quoteName('element') . ' = ' . $db->quote(self::OLD_NAME))
+            )->execute();
+        } catch (\Throwable $e) {
+            // Not critical
+        }
+    }
+
+    private function updateExtensionLocks(): void
+    {
+        $db = Factory::getDbo();
+
+        // Unlock MokoCassiopeia — allow uninstall
+        try {
+            $query = $db->getQuery(true)
+                ->update('#__extensions')
+                ->set($db->quoteName('locked') . ' = 0')
+                ->set($db->quoteName('protected') . ' = 0')
+                ->where($db->quoteName('element') . ' = ' . $db->quote(self::OLD_NAME))
+                ->where($db->quoteName('type') . ' = ' . $db->quote('template'));
+            $db->setQuery($query)->execute();
+            if ($db->getAffectedRows() > 0) {
+                $this->log('Bridge: unlocked MokoCassiopeia (can be uninstalled).');
+            }
+        } catch (\Throwable $e) {
+            $this->log('Bridge: failed to unlock MokoCassiopeia: ' . $e->getMessage(), 'warning');
+        }
+
+        // Lock MokoOnyx — prevent accidental uninstall
+        try {
+            $query = $db->getQuery(true)
+                ->update('#__extensions')
+                ->set($db->quoteName('locked') . ' = 1')
+                ->where($db->quoteName('element') . ' = ' . $db->quote(self::NEW_NAME))
+                ->where($db->quoteName('type') . ' = ' . $db->quote('template'));
+            $db->setQuery($query)->execute();
+            if ($db->getAffectedRows() > 0) {
+                $this->log('Bridge: locked MokoOnyx (protected from uninstall).');
+            }
+        } catch (\Throwable $e) {
+            $this->log('Bridge: failed to lock MokoOnyx: ' . $e->getMessage(), 'warning');
+        }
+    }
+
+    // ── Logging ────────────────────────────────────────────────────────
+
+    private function log(string $message, string $priority = 'info'): void
+    {
+        static $init = false;
+        if (!$init) {
+            Log::addLogger(
+                ['text_file' => 'mokocassiopeia_bridge.log.php'],
+                Log::ALL,
+                ['mokocassiopeia_bridge']
+            );
+            $init = true;
+        }
+
+        $levels = ['info' => Log::INFO, 'warning' => Log::WARNING, 'error' => Log::ERROR];
+        Log::add($message, $levels[$priority] ?? Log::INFO, 'mokocassiopeia_bridge');
     }
 }

src/sync_custom_vars.php

@@ -34,11 +34,11 @@ final class MokoCssVarSync
      */
     private const PALETTES = [
         [
-            'starter' => 'templates/light.custom.css',
+            'starter' => 'media/css/theme/light.standard.css',
             'user'    => 'media/templates/site/%s/css/theme/light.custom.css',
         ],
         [
-            'starter' => 'templates/dark.custom.css',
+            'starter' => 'media/css/theme/dark.standard.css',
             'user'    => 'media/templates/site/%s/css/theme/dark.custom.css',
         ],
     ];
@@ -97,28 +97,24 @@ final class MokoCssVarSync
     private static function syncFile(string $starterPath, string $userPath): array
     {
         $starterVars = self::extractVarsWithContext($starterPath);
-        $userVars    = self::extractVarNames($userPath);
+        $userVarsMap = self::extractVarsWithContext($userPath);
+        $userNames   = self::extractVarNames($userPath);
 
+        // Find missing variables
         $missing = [];
         foreach ($starterVars as $name => $declaration) {
-            if (!isset($userVars[$name])) {
+            if (!isset($userNames[$name])) {
                 $missing[$name] = $declaration;
             }
         }
 
-        if (empty($missing)) {
-            return ['added' => [], 'skipped' => []];
-        }
+        // Rebuild the entire :root block in starter file order.
+        // User's custom values are preserved; missing vars get starter defaults.
+        $reordered = self::rebuildInStarterOrder($starterPath, $userVarsMap, $missing);
 
-        // Group missing variables by their section comment header.
-        $sections = self::groupBySection($missing, $starterPath);
-
-        // Build the injection block.
-        $injection = self::buildInjectionBlock($sections);
-
-        // Insert before the closing } of the :root rule.
+        // Replace the :root block in the user file with the reordered version.
         $userCss = file_get_contents($userPath);
-        $userCss = self::injectBeforeRootClose($userCss, $injection);
+        $userCss = self::replaceRootBlock($userCss, $reordered);
 
         // Write back (atomic: write to .tmp then rename).
         $tmpPath = $userPath . '.tmp';
@@ -128,6 +124,104 @@ final class MokoCssVarSync
         return ['added' => array_keys($missing), 'skipped' => []];
     }
 
+    /**
+     * Rebuild all variables in the order they appear in the starter file.
+     * User values are preserved; missing vars use starter defaults.
+     *
+     * @param  string  $starterPath  Path to starter file.
+     * @param  array   $userVars     User's variable name => declaration.
+     * @param  array   $missing      Missing variable name => starter declaration.
+     * @return string  Complete CSS content for inside :root { }.
+     */
+    private static function rebuildInStarterOrder(string $starterPath, array $userVars, array $missing): string
+    {
+        $lines   = file($starterPath, FILE_IGNORE_NEW_LINES);
+        $output  = [];
+        $inRoot  = false;
+        $depth   = 0;
+
+        foreach ($lines as $line) {
+            // Track when we enter :root (brace may be on same line)
+            if (!$inRoot && preg_match('/:root/', $line)) {
+                $inRoot = true;
+                // If { is on this same line, don't skip it — just continue processing
+                if (strpos($line, '{') === false) {
+                    continue;
+                }
+                // Fall through to process the rest of this line
+            }
+
+            if (!$inRoot) {
+                continue;
+            }
+
+            // Track braces (skip lines that are ONLY a brace)
+            $trimmed = trim($line);
+            if ($trimmed === '{') {
+                continue;
+            }
+            if ($trimmed === '}') {
+                break; // End of :root
+            }
+
+            // Section comment headers — always include
+            if (preg_match('/\/\*\s*=+\s*.+?\s*=+\s*\*\//', $line)) {
+                $output[] = $line;
+                continue;
+            }
+
+            // Regular comments — include
+            if (preg_match('/^\s*\/\*/', $line) || preg_match('/^\s*\*/', $line)) {
+                $output[] = $line;
+                continue;
+            }
+
+            // Blank lines — include
+            if (trim($line) === '') {
+                $output[] = '';
+                continue;
+            }
+
+            // Variable declaration
+            if (preg_match('/^\s*(--[\w-]+)\s*:/', $line, $m)) {
+                $name = trim($m[1]);
+                if (isset($userVars[$name])) {
+                    // Use the user's custom value
+                    $output[] = $userVars[$name];
+                } elseif (isset($missing[$name])) {
+                    // New variable — use starter default
+                    $output[] = $missing[$name];
+                }
+                continue;
+            }
+
+            // Other lines (e.g. color-scheme) — include as-is
+            $output[] = $line;
+        }
+
+        return implode("\n", $output);
+    }
+
+    /**
+     * Replace the content inside :root { ... } with new content.
+     */
+    private static function replaceRootBlock(string $css, string $newContent): string
+    {
+        $rootStart = preg_match('/:root[^{]*\{/', $css, $m, PREG_OFFSET_CAPTURE);
+        if (!$rootStart) {
+            return $css;
+        }
+
+        $openBrace = $m[0][1] + strlen($m[0][0]);
+        $closeBrace = self::findRootClosingBrace($css);
+
+        if ($closeBrace === false) {
+            return $css;
+        }
+
+        return substr($css, 0, $openBrace) . "\n" . $newContent . "\n" . substr($css, $closeBrace);
+    }
+
     /**
      * Extract CSS custom property declarations with their full text (name: value).
      * Only extracts from the first :root block.
@@ -181,29 +275,25 @@ final class MokoCssVarSync
     {
         $lines   = file($starterPath, FILE_IGNORE_NEW_LINES);
         $section = 'Uncategorised';
-        $map     = [];  // variable name => section
+
+        // Walk the starter file in order — this preserves the original
+        // variable ordering so injected variables match the standard theme layout.
+        $sections = [];
 
         foreach ($lines as $line) {
             // Detect section comment headers like /* ===== HERO VARIANTS ===== */
             if (preg_match('/\/\*\s*=+\s*(.+?)\s*=+\s*\*\//', $line, $m)) {
                 $section = trim($m[1]);
             }
-            // Detect variable declaration
+            // Detect variable declaration — only include if it's missing from user file
             if (preg_match('/^\s*(--[\w-]+)\s*:/', $line, $m)) {
                 $name = trim($m[1]);
                 if (isset($missing[$name])) {
-                    $map[$name] = $section;
+                    $sections[$section][] = $missing[$name];
                 }
             }
         }
 
-        // Group by section
-        $sections = [];
-        foreach ($missing as $name => $declaration) {
-            $sec = $map[$name] ?? 'Uncategorised';
-            $sections[$sec][] = $declaration;
-        }
-
         return $sections;
     }
 

src/templateDetails.xml

@@ -39,13 +39,13 @@
 		</server>
 	</updateservers>
 	<name>MokoCassiopeia</name>
-	<version>03.09.14</version>
+	<version>03.10.23</version>
 	<scriptfile>script.php</scriptfile>
-	<creationDate>2026-04-14</creationDate>
+	<creationDate>2026-04-19</creationDate>
 	<author>Jonathan Miller || Moko Consulting</author>
 	<authorEmail>hello@mokoconsulting.tech</authorEmail>
 	<copyright>(C)GNU General Public License Version 3 - 2026 Moko Consulting</copyright>
-	<description><![CDATA[<p><img src="https://img.shields.io/badge/version-03.09.14-blue.svg?logo=v&amp;logoColor=white" alt="Version 03.09.14" /> <img src="https://img.shields.io/badge/license-GPL--3.0--or--later-green.svg?logo=gnu&amp;logoColor=white" alt="License" /> <img src="https://img.shields.io/badge/Joomla-5.x%20%7C%206.x-red.svg?logo=joomla&amp;logoColor=white" alt="Joomla" /> <img src="https://img.shields.io/badge/PHP-8.1%2B-777BB4.svg?logo=php&amp;logoColor=white" alt="PHP" /></p> <h3>MokoCassiopeia Template Description</h3> <p>  <strong>MokoCassiopeia</strong> continues Joomla's tradition of space-themed default templates—  building on the legacy of <em>Solarflare</em> (Joomla 1.0), <em>Milkyway</em> (Joomla 1.5),  and <em>Protostar</em> (Joomla 3.0). </p> <p>  This template is a customized fork of the <strong>Cassiopeia</strong> template introduced in Joomla 4,  preserving its modern, accessible, and mobile-first foundation while introducing new stylistic  enhancements and structural refinements specifically tailored for use by Moko Consulting. </p>  <h4>Custom Colour Themes</h4> <p>  Starter palette files are included with the template. To create a custom colour scheme,  copy <code>templates/mokocassiopeia/templates/light.custom.css</code> to  <code>media/templates/site/mokocassiopeia/css/theme/light.custom.css</code>,  or <code>templates/mokocassiopeia/templates/dark.custom.css</code> to  <code>media/templates/site/mokocassiopeia/css/theme/dark.custom.css</code>.  Customise the CSS variables to match your brand, then activate your palette in  <em>System → Site Templates → MokoCassiopeia → Theme tab</em>  by selecting "Custom" for the Light or Dark Mode Palette.  A full variable reference is available in the <em>CSS Variables</em> tab in template options. </p>  <h4>Custom CSS &amp; JavaScript</h4> <p>  For site-specific styles and scripts that should survive template updates, create the following files: </p> <ul>  <li><code>media/templates/site/mokocassiopeia/css/user.css</code> — loaded on every page for custom CSS overrides.</li>  <li><code>media/templates/site/mokocassiopeia/js/user.js</code> — loaded on every page for custom JavaScript.</li> </ul> <p>  These files are gitignored and will not be overwritten by template updates. </p>  <h4>Code Attribution</h4> <p>  This template is based on the original <strong>Cassiopeia</strong> template developed by the  <a href="https://www.joomla.org" target="_blank" rel="noopener">Joomla! Project</a> and released under the GNU General Public License. </p> <p>  Modifications and enhancements have been made by Moko Consulting in accordance with open-source licensing standards. </p> <p>  It includes integration with  <a href="https://afeld.github.io/bootstrap-toc/" target="_blank" rel="noopener">Bootstrap TOC</a>,  an open-source table of contents generator by A. Feld, licensed under the MIT License. </p> <p>  All third-party libraries and assets remain the property of their respective authors and are credited within their source files where applicable. </p>]]></description>
+	<description><![CDATA[<div style="padding:1.25rem;border:2px solid #dc2626;border-radius:8px;background:#fef2f2;margin-bottom:1rem;"> <h3 style="color:#991b1b;margin:0 0 .75rem;">⚠️ MokoCassiopeia has been renamed to MokoOnyx</h3> <p style="margin:0 0 1rem;">  <strong>This template is no longer maintained.</strong> Please install MokoOnyx manually to continue receiving updates.  MokoOnyx has the same features and will automatically import your MokoCassiopeia settings on first install. </p> <p style="margin:0 0 1rem;">  <strong>Steps to migrate:</strong> </p> <ol style="margin:0 0 1rem 1.5rem;">  <li>Download MokoOnyx from <a href="https://git.mokoconsulting.tech/MokoConsulting/MokoOnyx/releases/tag/v01" style="color:#2563eb;font-weight:600;">Gitea Releases (v01)</a></li>  <li>Install via <strong>System → Install → Extensions → Upload Package File</strong></li>  <li>Set MokoOnyx as default in <strong>System → Site Templates</strong></li>  <li>Visit any frontend page — your settings are imported automatically</li>  <li>Uninstall MokoCassiopeia from <strong>Extensions → Manage</strong></li> </ol> <p style="margin:0;">  <a href="https://git.mokoconsulting.tech/MokoConsulting/MokoOnyx/releases" style="display:inline-block;padding:.5rem 1.25rem;background:#2563eb;color:#fff;border-radius:6px;text-decoration:none;font-weight:600;">Download MokoOnyx</a> </p></div> <p><img src="https://img.shields.io/badge/license-GPL--3.0--or--later-green.svg?logo=gnu&amp;logoColor=white" alt="License" /> <img src="https://img.shields.io/badge/Joomla-5.x%20%7C%206.x-red.svg?logo=joomla&amp;logoColor=white" alt="Joomla" /> <img src="https://img.shields.io/badge/PHP-8.1%2B-777BB4.svg?logo=php&amp;logoColor=white" alt="PHP" /></p> <p>  <strong>MokoCassiopeia</strong> is succeeded by <strong>MokoOnyx</strong> — same features, new name.  All future development continues under the <a href="https://git.mokoconsulting.tech/MokoConsulting/MokoOnyx">MokoOnyx project</a>. </p>]]></description>
 	<inheritable>1</inheritable>
 	<files>
 		<filename>component.php</filename>
@@ -295,7 +295,8 @@
 					<option value="0">JNO</option>
 					<option value="1">JYES</option>
 				</field>
-				<field name="a11y_toolbar_pos" type="list" default="tl"
+				<!-- Position forced to bottom-right in index.php -->
+				<field name="a11y_toolbar_pos" type="hidden" default="br"
 							 label="TPL_MOKO_A11Y_TOOLBAR_POS" description="TPL_MOKO_A11Y_TOOLBAR_POS_DESC"
 							 showon="a11y_toolbar_enabled:1">
 					<option value="br">Bottom-right</option>
@@ -312,7 +313,8 @@
 					<option value="0">JNO</option>
 					<option value="1">JYES</option>
 				</field>
-				<field name="theme_fab_pos" type="list" default="br"
+				<!-- Position forced to bottom-right in index.php -->
+				<field name="theme_fab_pos" type="hidden" default="br"
 							 label="TPL_MOKO_THEME_FAB_POS" description="TPL_MOKO_THEME_FAB_POS_DESC">
 					<option value="br">Bottom-right</option>
 					<option value="bl">Bottom-left</option>
@@ -365,6 +367,7 @@
 				<field name="css_vars_offcanvas" type="note" label="TPL_MOKOCASSIOPEIA_CSS_VARS_OFFCANVAS_LABEL" description="TPL_MOKOCASSIOPEIA_CSS_VARS_OFFCANVAS_DESC" class="alert alert-light" />
 				<field name="css_vars_virtuemart" type="note" label="TPL_MOKOCASSIOPEIA_CSS_VARS_VM_LABEL" description="TPL_MOKOCASSIOPEIA_CSS_VARS_VM_DESC" class="alert alert-light" />
 				<field name="css_vars_gable" type="note" label="TPL_MOKOCASSIOPEIA_CSS_VARS_GABLE_LABEL" description="TPL_MOKOCASSIOPEIA_CSS_VARS_GABLE_DESC" class="alert alert-light" />
+				<field name="css_vars_footer" type="note" label="TPL_MOKOCASSIOPEIA_CSS_VARS_FOOTER_LABEL" description="TPL_MOKOCASSIOPEIA_CSS_VARS_FOOTER_DESC" class="alert alert-light" />
 			</fieldset>
 
 			<!-- Theme Preview tab — embedded test sheet -->
@@ -372,12 +375,6 @@
 				<field name="theme_preview_intro" type="note" description="TPL_MOKOCASSIOPEIA_THEME_PREVIEW_INTRO" />
 				<field name="theme_preview_frame" type="note" description="TPL_MOKOCASSIOPEIA_THEME_PREVIEW_FRAME" />
 			</fieldset>
-
-			<!-- Brand Showcase tab — color system, gradients, interactive sampler -->
-			<fieldset name="brand_showcase" label="TPL_MOKOCASSIOPEIA_BRAND_SHOWCASE_FIELDSET_LABEL">
-				<field name="brand_showcase_intro" type="note" description="TPL_MOKOCASSIOPEIA_BRAND_SHOWCASE_INTRO" />
-				<field name="brand_showcase_frame" type="note" description="TPL_MOKOCASSIOPEIA_BRAND_SHOWCASE_FRAME" />
-			</fieldset>
 		</fields>
 	</config>
 </extension>

templates/dark.custom.css

@@ -1,327 +0,0 @@
-@charset "UTF-8";
-/* Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
-
- This file is part of a Moko Consulting project.
-
- SPDX-License-Identifier: GPL-3.0-or-later
-
-
-
- # FILE INFORMATION
- DEFGROUP: Joomla.Template.Site
- INGROUP: MokoCassiopeia.Templates
- PATH: ./templates/dark.custom.css
- VERSION: 03.09.03
- BRIEF: Custom dark theme color template with Bootstrap button definitions
- */
-
-/* -----------------------------------------------
- * CUSTOM DARK THEME TEMPLATE
- * 
- * Copy this file to:
- *   src/media/css/theme/dark.custom.css
- * 
- * Then register it in src/joomla.asset.json under
- * template.dark.custom asset.
- * --------------------------------------------- */
-
-:root[data-bs-theme='dark'] {
-	/* ===== BRAND COLORS (Customize these) ===== */
-	--color-primary: #3399ff;
-	--accent-color-primary: #66b3ff;
-	--accent-color-secondary: #99ccff;
-	
-	/* ===== LINKS ===== */
-	--link-color: #6bb3ff;
-	--link-hover-color: #99ccff;
-	
-	/* ===== BODY & TYPOGRAPHY ===== */
-	--body-color: #e9ecef;
-	--body-bg: #0e1318;
-	
-	/* ===== BOOTSTRAP STATE COLORS ===== */
-	--success: #5cb85c;
-	--info: #5bc0de;
-	--warning: #ffc107;
-	--danger: #d9534f;
-	
-	/* ===== NAVIGATION ===== */
-	--nav-bg-color: var(--color-primary);
-	--nav-text-color: #ffffff;
-}
-
-/* ===== BOOTSTRAP BUTTON VARIANTS ===== */
-
-.btn-primary {
-	--btn-color: hsl(0, 0%, 100%);
-	--btn-bg: var(--color-primary);
-	--btn-border-color: var(--color-primary);
-	--btn-hover-color: hsl(0, 0%, 100%);
-	--btn-hover-bg: #2680e6;
-	--btn-hover-border-color: #1f73d9;
-	--btn-focus-shadow-rgb: 82, 168, 255;
-	--btn-active-color: hsl(0, 0%, 100%);
-	--btn-active-bg: #1f73d9;
-	--btn-active-border-color: #1a66cc;
-	--btn-active-shadow: inset 0 3px 5px rgba(0, 0, 0, 0.125);
-	--btn-disabled-color: hsl(0, 0%, 100%);
-	--btn-disabled-bg: var(--color-primary);
-	--btn-disabled-border-color: var(--color-primary);
-}
-
-.btn-secondary {
-	--btn-color: hsl(0, 0%, 100%);
-	--btn-bg: #6c757d;
-	--btn-border-color: #6c757d;
-	--btn-hover-color: hsl(0, 0%, 100%);
-	--btn-hover-bg: #5c636a;
-	--btn-hover-border-color: #565e64;
-	--btn-focus-shadow-rgb: 130, 138, 145;
-	--btn-active-color: hsl(0, 0%, 100%);
-	--btn-active-bg: #565e64;
-	--btn-active-border-color: #51585e;
-	--btn-active-shadow: inset 0 3px 5px rgba(0, 0, 0, 0.125);
-	--btn-disabled-color: hsl(0, 0%, 100%);
-	--btn-disabled-bg: #6c757d;
-	--btn-disabled-border-color: #6c757d;
-}
-
-.btn-success {
-	--btn-color: hsl(0, 0%, 100%);
-	--btn-bg: var(--success);
-	--btn-border-color: var(--success);
-	--btn-hover-color: hsl(0, 0%, 100%);
-	--btn-hover-bg: #4cae4c;
-	--btn-hover-border-color: #449d44;
-	--btn-focus-shadow-rgb: 113, 198, 113;
-	--btn-active-color: hsl(0, 0%, 100%);
-	--btn-active-bg: #449d44;
-	--btn-active-border-color: #398439;
-	--btn-active-shadow: inset 0 3px 5px rgba(0, 0, 0, 0.125);
-	--btn-disabled-color: hsl(0, 0%, 100%);
-	--btn-disabled-bg: var(--success);
-	--btn-disabled-border-color: var(--success);
-}
-
-.btn-info {
-	--btn-color: hsl(0, 0%, 100%);
-	--btn-bg: var(--info);
-	--btn-border-color: var(--info);
-	--btn-hover-color: hsl(0, 0%, 100%);
-	--btn-hover-bg: #46b8da;
-	--btn-hover-border-color: #31b0d5;
-	--btn-focus-shadow-rgb: 116, 204, 233;
-	--btn-active-color: hsl(0, 0%, 100%);
-	--btn-active-bg: #31b0d5;
-	--btn-active-border-color: #269abc;
-	--btn-active-shadow: inset 0 3px 5px rgba(0, 0, 0, 0.125);
-	--btn-disabled-color: hsl(0, 0%, 100%);
-	--btn-disabled-bg: var(--info);
-	--btn-disabled-border-color: var(--info);
-}
-
-.btn-warning {
-	--btn-color: hsl(0, 0%, 0%);
-	--btn-bg: var(--warning);
-	--btn-border-color: var(--warning);
-	--btn-hover-color: hsl(0, 0%, 0%);
-	--btn-hover-bg: #edb100;
-	--btn-hover-border-color: #d39e00;
-	--btn-focus-shadow-rgb: 222, 170, 12;
-	--btn-active-color: hsl(0, 0%, 0%);
-	--btn-active-bg: #d39e00;
-	--btn-active-border-color: #c69500;
-	--btn-active-shadow: inset 0 3px 5px rgba(0, 0, 0, 0.125);
-	--btn-disabled-color: hsl(0, 0%, 0%);
-	--btn-disabled-bg: var(--warning);
-	--btn-disabled-border-color: var(--warning);
-}
-
-.btn-danger {
-	--btn-color: hsl(0, 0%, 100%);
-	--btn-bg: var(--danger);
-	--btn-border-color: var(--danger);
-	--btn-hover-color: hsl(0, 0%, 100%);
-	--btn-hover-bg: #d43f3a;
-	--btn-hover-border-color: #c9302c;
-	--btn-focus-shadow-rgb: 223, 109, 105;
-	--btn-active-color: hsl(0, 0%, 100%);
-	--btn-active-bg: #c9302c;
-	--btn-active-border-color: #ac2925;
-	--btn-active-shadow: inset 0 3px 5px rgba(0, 0, 0, 0.125);
-	--btn-disabled-color: hsl(0, 0%, 100%);
-	--btn-disabled-bg: var(--danger);
-	--btn-disabled-border-color: var(--danger);
-}
-
-.btn-light {
-	--btn-color: hsl(0, 0%, 0%);
-	--btn-bg: #e9ecef;
-	--btn-border-color: #e9ecef;
-	--btn-hover-color: hsl(0, 0%, 0%);
-	--btn-hover-bg: #d3d6d9;
-	--btn-hover-border-color: #c8cbcf;
-	--btn-focus-shadow-rgb: 204, 207, 210;
-	--btn-active-color: hsl(0, 0%, 0%);
-	--btn-active-bg: #c8cbcf;
-	--btn-active-border-color: #bdc1c5;
-	--btn-active-shadow: inset 0 3px 5px rgba(0, 0, 0, 0.125);
-	--btn-disabled-color: hsl(0, 0%, 0%);
-	--btn-disabled-bg: #e9ecef;
-	--btn-disabled-border-color: #e9ecef;
-}
-
-.btn-dark {
-	--btn-color: hsl(0, 0%, 100%);
-	--btn-bg: #2c3136;
-	--btn-border-color: #2c3136;
-	--btn-hover-color: hsl(0, 0%, 100%);
-	--btn-hover-bg: #1e2124;
-	--btn-hover-border-color: #191c1f;
-	--btn-focus-shadow-rgb: 70, 75, 80;
-	--btn-active-color: hsl(0, 0%, 100%);
-	--btn-active-bg: #191c1f;
-	--btn-active-border-color: #14161a;
-	--btn-active-shadow: inset 0 3px 5px rgba(0, 0, 0, 0.125);
-	--btn-disabled-color: hsl(0, 0%, 100%);
-	--btn-disabled-bg: #2c3136;
-	--btn-disabled-border-color: #2c3136;
-}
-
-/* ===== OUTLINE BUTTON VARIANTS ===== */
-
-.btn-outline-primary {
-	--btn-color: var(--color-primary);
-	--btn-border-color: var(--color-primary);
-	--btn-hover-color: hsl(0, 0%, 0%);
-	--btn-hover-bg: var(--color-primary);
-	--btn-hover-border-color: var(--color-primary);
-	--btn-focus-shadow-rgb: 82, 168, 255;
-	--btn-active-color: hsl(0, 0%, 0%);
-	--btn-active-bg: var(--color-primary);
-	--btn-active-border-color: var(--color-primary);
-	--btn-active-shadow: inset 0 3px 5px rgba(0, 0, 0, 0.125);
-	--btn-disabled-color: var(--color-primary);
-	--btn-disabled-bg: transparent;
-	--btn-disabled-border-color: var(--color-primary);
-	--gradient: none;
-}
-
-.btn-outline-secondary {
-	--btn-color: #8c959f;
-	--btn-border-color: #8c959f;
-	--btn-hover-color: hsl(0, 0%, 0%);
-	--btn-hover-bg: #8c959f;
-	--btn-hover-border-color: #8c959f;
-	--btn-focus-shadow-rgb: 150, 158, 167;
-	--btn-active-color: hsl(0, 0%, 0%);
-	--btn-active-bg: #8c959f;
-	--btn-active-border-color: #8c959f;
-	--btn-active-shadow: inset 0 3px 5px rgba(0, 0, 0, 0.125);
-	--btn-disabled-color: #8c959f;
-	--btn-disabled-bg: transparent;
-	--btn-disabled-border-color: #8c959f;
-	--gradient: none;
-}
-
-.btn-outline-success {
-	--btn-color: var(--success);
-	--btn-border-color: var(--success);
-	--btn-hover-color: hsl(0, 0%, 0%);
-	--btn-hover-bg: var(--success);
-	--btn-hover-border-color: var(--success);
-	--btn-focus-shadow-rgb: 113, 198, 113;
-	--btn-active-color: hsl(0, 0%, 0%);
-	--btn-active-bg: var(--success);
-	--btn-active-border-color: var(--success);
-	--btn-active-shadow: inset 0 3px 5px rgba(0, 0, 0, 0.125);
-	--btn-disabled-color: var(--success);
-	--btn-disabled-bg: transparent;
-	--btn-disabled-border-color: var(--success);
-	--gradient: none;
-}
-
-.btn-outline-info {
-	--btn-color: var(--info);
-	--btn-border-color: var(--info);
-	--btn-hover-color: hsl(0, 0%, 0%);
-	--btn-hover-bg: var(--info);
-	--btn-hover-border-color: var(--info);
-	--btn-focus-shadow-rgb: 116, 204, 233;
-	--btn-active-color: hsl(0, 0%, 0%);
-	--btn-active-bg: var(--info);
-	--btn-active-border-color: var(--info);
-	--btn-active-shadow: inset 0 3px 5px rgba(0, 0, 0, 0.125);
-	--btn-disabled-color: var(--info);
-	--btn-disabled-bg: transparent;
-	--btn-disabled-border-color: var(--info);
-	--gradient: none;
-}
-
-.btn-outline-warning {
-	--btn-color: var(--warning);
-	--btn-border-color: var(--warning);
-	--btn-hover-color: hsl(0, 0%, 0%);
-	--btn-hover-bg: var(--warning);
-	--btn-hover-border-color: var(--warning);
-	--btn-focus-shadow-rgb: 222, 170, 12;
-	--btn-active-color: hsl(0, 0%, 0%);
-	--btn-active-bg: var(--warning);
-	--btn-active-border-color: var(--warning);
-	--btn-active-shadow: inset 0 3px 5px rgba(0, 0, 0, 0.125);
-	--btn-disabled-color: var(--warning);
-	--btn-disabled-bg: transparent;
-	--btn-disabled-border-color: var(--warning);
-	--gradient: none;
-}
-
-.btn-outline-danger {
-	--btn-color: var(--danger);
-	--btn-border-color: var(--danger);
-	--btn-hover-color: hsl(0, 0%, 100%);
-	--btn-hover-bg: var(--danger);
-	--btn-hover-border-color: var(--danger);
-	--btn-focus-shadow-rgb: 223, 109, 105;
-	--btn-active-color: hsl(0, 0%, 100%);
-	--btn-active-bg: var(--danger);
-	--btn-active-border-color: var(--danger);
-	--btn-active-shadow: inset 0 3px 5px rgba(0, 0, 0, 0.125);
-	--btn-disabled-color: var(--danger);
-	--btn-disabled-bg: transparent;
-	--btn-disabled-border-color: var(--danger);
-	--gradient: none;
-}
-
-.btn-outline-light {
-	--btn-color: #e9ecef;
-	--btn-border-color: #e9ecef;
-	--btn-hover-color: hsl(0, 0%, 0%);
-	--btn-hover-bg: #e9ecef;
-	--btn-hover-border-color: #e9ecef;
-	--btn-focus-shadow-rgb: 204, 207, 210;
-	--btn-active-color: hsl(0, 0%, 0%);
-	--btn-active-bg: #e9ecef;
-	--btn-active-border-color: #e9ecef;
-	--btn-active-shadow: inset 0 3px 5px rgba(0, 0, 0, 0.125);
-	--btn-disabled-color: #e9ecef;
-	--btn-disabled-bg: transparent;
-	--btn-disabled-border-color: #e9ecef;
-	--gradient: none;
-}
-
-.btn-outline-dark {
-	--btn-color: #4a5057;
-	--btn-border-color: #4a5057;
-	--btn-hover-color: hsl(0, 0%, 100%);
-	--btn-hover-bg: #4a5057;
-	--btn-hover-border-color: #4a5057;
-	--btn-focus-shadow-rgb: 90, 95, 100;
-	--btn-active-color: hsl(0, 0%, 100%);
-	--btn-active-bg: #4a5057;
-	--btn-active-border-color: #4a5057;
-	--btn-active-shadow: inset 0 3px 5px rgba(0, 0, 0, 0.125);
-	--btn-disabled-color: #4a5057;
-	--btn-disabled-bg: transparent;
-	--btn-disabled-border-color: #4a5057;
-	--gradient: none;
-}

templates/light.custom.css

@@ -1,327 +0,0 @@
-@charset "UTF-8";
-/* Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
-
- This file is part of a Moko Consulting project.
-
- SPDX-License-Identifier: GPL-3.0-or-later
-
-
-
- # FILE INFORMATION
- DEFGROUP: Joomla.Template.Site
- INGROUP: MokoCassiopeia.Templates
- PATH: ./templates/light.custom.css
- VERSION: 03.09.03
- BRIEF: Custom light theme color template with Bootstrap button definitions
- */
-
-/* -----------------------------------------------
- * CUSTOM LIGHT THEME TEMPLATE
- * 
- * Copy this file to:
- *   src/media/css/theme/light.custom.css
- * 
- * Then register it in src/joomla.asset.json under
- * template.light.custom asset.
- * --------------------------------------------- */
-
-:root[data-bs-theme="light"] {
-	/* ===== BRAND COLORS (Customize these) ===== */
-	--color-primary: #0066cc;
-	--accent-color-primary: #3399ff;
-	--accent-color-secondary: #66b3ff;
-	
-	/* ===== LINKS ===== */
-	--link-color: #0066cc;
-	--link-hover-color: #0052a3;
-	
-	/* ===== BODY & TYPOGRAPHY ===== */
-	--body-color: #212529;
-	--body-bg: #ffffff;
-	
-	/* ===== BOOTSTRAP STATE COLORS ===== */
-	--success: #28a745;
-	--info: #17a2b8;
-	--warning: #ffc107;
-	--danger: #dc3545;
-	
-	/* ===== NAVIGATION ===== */
-	--nav-bg-color: var(--color-primary);
-	--nav-text-color: #ffffff;
-}
-
-/* ===== BOOTSTRAP BUTTON VARIANTS ===== */
-
-.btn-primary {
-	--btn-color: hsl(0, 0%, 100%);
-	--btn-bg: var(--color-primary);
-	--btn-border-color: var(--color-primary);
-	--btn-hover-color: hsl(0, 0%, 100%);
-	--btn-hover-bg: #0052a3;
-	--btn-hover-border-color: #004d99;
-	--btn-focus-shadow-rgb: 38, 128, 217;
-	--btn-active-color: hsl(0, 0%, 100%);
-	--btn-active-bg: #004d99;
-	--btn-active-border-color: #004788;
-	--btn-active-shadow: inset 0 3px 5px rgba(0, 0, 0, 0.125);
-	--btn-disabled-color: hsl(0, 0%, 100%);
-	--btn-disabled-bg: var(--color-primary);
-	--btn-disabled-border-color: var(--color-primary);
-}
-
-.btn-secondary {
-	--btn-color: hsl(0, 0%, 100%);
-	--btn-bg: #6c757d;
-	--btn-border-color: #6c757d;
-	--btn-hover-color: hsl(0, 0%, 100%);
-	--btn-hover-bg: #5c636a;
-	--btn-hover-border-color: #565e64;
-	--btn-focus-shadow-rgb: 130, 138, 145;
-	--btn-active-color: hsl(0, 0%, 100%);
-	--btn-active-bg: #565e64;
-	--btn-active-border-color: #51585e;
-	--btn-active-shadow: inset 0 3px 5px rgba(0, 0, 0, 0.125);
-	--btn-disabled-color: hsl(0, 0%, 100%);
-	--btn-disabled-bg: #6c757d;
-	--btn-disabled-border-color: #6c757d;
-}
-
-.btn-success {
-	--btn-color: hsl(0, 0%, 100%);
-	--btn-bg: var(--success);
-	--btn-border-color: var(--success);
-	--btn-hover-color: hsl(0, 0%, 100%);
-	--btn-hover-bg: #218838;
-	--btn-hover-border-color: #1e7e34;
-	--btn-focus-shadow-rgb: 72, 180, 97;
-	--btn-active-color: hsl(0, 0%, 100%);
-	--btn-active-bg: #1e7e34;
-	--btn-active-border-color: #1c7430;
-	--btn-active-shadow: inset 0 3px 5px rgba(0, 0, 0, 0.125);
-	--btn-disabled-color: hsl(0, 0%, 100%);
-	--btn-disabled-bg: var(--success);
-	--btn-disabled-border-color: var(--success);
-}
-
-.btn-info {
-	--btn-color: hsl(0, 0%, 100%);
-	--btn-bg: var(--info);
-	--btn-border-color: var(--info);
-	--btn-hover-color: hsl(0, 0%, 100%);
-	--btn-hover-bg: #138496;
-	--btn-hover-border-color: #117a8b;
-	--btn-focus-shadow-rgb: 58, 176, 195;
-	--btn-active-color: hsl(0, 0%, 100%);
-	--btn-active-bg: #117a8b;
-	--btn-active-border-color: #10707f;
-	--btn-active-shadow: inset 0 3px 5px rgba(0, 0, 0, 0.125);
-	--btn-disabled-color: hsl(0, 0%, 100%);
-	--btn-disabled-bg: var(--info);
-	--btn-disabled-border-color: var(--info);
-}
-
-.btn-warning {
-	--btn-color: hsl(0, 0%, 0%);
-	--btn-bg: var(--warning);
-	--btn-border-color: var(--warning);
-	--btn-hover-color: hsl(0, 0%, 0%);
-	--btn-hover-bg: #e0a800;
-	--btn-hover-border-color: #d39e00;
-	--btn-focus-shadow-rgb: 222, 170, 12;
-	--btn-active-color: hsl(0, 0%, 0%);
-	--btn-active-bg: #d39e00;
-	--btn-active-border-color: #c69500;
-	--btn-active-shadow: inset 0 3px 5px rgba(0, 0, 0, 0.125);
-	--btn-disabled-color: hsl(0, 0%, 0%);
-	--btn-disabled-bg: var(--warning);
-	--btn-disabled-border-color: var(--warning);
-}
-
-.btn-danger {
-	--btn-color: hsl(0, 0%, 100%);
-	--btn-bg: var(--danger);
-	--btn-border-color: var(--danger);
-	--btn-hover-color: hsl(0, 0%, 100%);
-	--btn-hover-bg: #c82333;
-	--btn-hover-border-color: #bd2130;
-	--btn-focus-shadow-rgb: 225, 83, 97;
-	--btn-active-color: hsl(0, 0%, 100%);
-	--btn-active-bg: #bd2130;
-	--btn-active-border-color: #b21f2d;
-	--btn-active-shadow: inset 0 3px 5px rgba(0, 0, 0, 0.125);
-	--btn-disabled-color: hsl(0, 0%, 100%);
-	--btn-disabled-bg: var(--danger);
-	--btn-disabled-border-color: var(--danger);
-}
-
-.btn-light {
-	--btn-color: hsl(0, 0%, 0%);
-	--btn-bg: #f8f9fa;
-	--btn-border-color: #f8f9fa;
-	--btn-hover-color: hsl(0, 0%, 0%);
-	--btn-hover-bg: #e2e6ea;
-	--btn-hover-border-color: #dae0e5;
-	--btn-focus-shadow-rgb: 216, 217, 219;
-	--btn-active-color: hsl(0, 0%, 0%);
-	--btn-active-bg: #dae0e5;
-	--btn-active-border-color: #d3d9df;
-	--btn-active-shadow: inset 0 3px 5px rgba(0, 0, 0, 0.125);
-	--btn-disabled-color: hsl(0, 0%, 0%);
-	--btn-disabled-bg: #f8f9fa;
-	--btn-disabled-border-color: #f8f9fa;
-}
-
-.btn-dark {
-	--btn-color: hsl(0, 0%, 100%);
-	--btn-bg: #343a40;
-	--btn-border-color: #343a40;
-	--btn-hover-color: hsl(0, 0%, 100%);
-	--btn-hover-bg: #23272b;
-	--btn-hover-border-color: #1d2124;
-	--btn-focus-shadow-rgb: 82, 88, 93;
-	--btn-active-color: hsl(0, 0%, 100%);
-	--btn-active-bg: #1d2124;
-	--btn-active-border-color: #171a1d;
-	--btn-active-shadow: inset 0 3px 5px rgba(0, 0, 0, 0.125);
-	--btn-disabled-color: hsl(0, 0%, 100%);
-	--btn-disabled-bg: #343a40;
-	--btn-disabled-border-color: #343a40;
-}
-
-/* ===== OUTLINE BUTTON VARIANTS ===== */
-
-.btn-outline-primary {
-	--btn-color: var(--color-primary);
-	--btn-border-color: var(--color-primary);
-	--btn-hover-color: hsl(0, 0%, 100%);
-	--btn-hover-bg: var(--color-primary);
-	--btn-hover-border-color: var(--color-primary);
-	--btn-focus-shadow-rgb: 38, 128, 217;
-	--btn-active-color: hsl(0, 0%, 100%);
-	--btn-active-bg: var(--color-primary);
-	--btn-active-border-color: var(--color-primary);
-	--btn-active-shadow: inset 0 3px 5px rgba(0, 0, 0, 0.125);
-	--btn-disabled-color: var(--color-primary);
-	--btn-disabled-bg: transparent;
-	--btn-disabled-border-color: var(--color-primary);
-	--gradient: none;
-}
-
-.btn-outline-secondary {
-	--btn-color: #6c757d;
-	--btn-border-color: #6c757d;
-	--btn-hover-color: hsl(0, 0%, 100%);
-	--btn-hover-bg: #6c757d;
-	--btn-hover-border-color: #6c757d;
-	--btn-focus-shadow-rgb: 130, 138, 145;
-	--btn-active-color: hsl(0, 0%, 100%);
-	--btn-active-bg: #6c757d;
-	--btn-active-border-color: #6c757d;
-	--btn-active-shadow: inset 0 3px 5px rgba(0, 0, 0, 0.125);
-	--btn-disabled-color: #6c757d;
-	--btn-disabled-bg: transparent;
-	--btn-disabled-border-color: #6c757d;
-	--gradient: none;
-}
-
-.btn-outline-success {
-	--btn-color: var(--success);
-	--btn-border-color: var(--success);
-	--btn-hover-color: hsl(0, 0%, 100%);
-	--btn-hover-bg: var(--success);
-	--btn-hover-border-color: var(--success);
-	--btn-focus-shadow-rgb: 72, 180, 97;
-	--btn-active-color: hsl(0, 0%, 100%);
-	--btn-active-bg: var(--success);
-	--btn-active-border-color: var(--success);
-	--btn-active-shadow: inset 0 3px 5px rgba(0, 0, 0, 0.125);
-	--btn-disabled-color: var(--success);
-	--btn-disabled-bg: transparent;
-	--btn-disabled-border-color: var(--success);
-	--gradient: none;
-}
-
-.btn-outline-info {
-	--btn-color: var(--info);
-	--btn-border-color: var(--info);
-	--btn-hover-color: hsl(0, 0%, 100%);
-	--btn-hover-bg: var(--info);
-	--btn-hover-border-color: var(--info);
-	--btn-focus-shadow-rgb: 58, 176, 195;
-	--btn-active-color: hsl(0, 0%, 100%);
-	--btn-active-bg: var(--info);
-	--btn-active-border-color: var(--info);
-	--btn-active-shadow: inset 0 3px 5px rgba(0, 0, 0, 0.125);
-	--btn-disabled-color: var(--info);
-	--btn-disabled-bg: transparent;
-	--btn-disabled-border-color: var(--info);
-	--gradient: none;
-}
-
-.btn-outline-warning {
-	--btn-color: var(--warning);
-	--btn-border-color: var(--warning);
-	--btn-hover-color: hsl(0, 0%, 0%);
-	--btn-hover-bg: var(--warning);
-	--btn-hover-border-color: var(--warning);
-	--btn-focus-shadow-rgb: 222, 170, 12;
-	--btn-active-color: hsl(0, 0%, 0%);
-	--btn-active-bg: var(--warning);
-	--btn-active-border-color: var(--warning);
-	--btn-active-shadow: inset 0 3px 5px rgba(0, 0, 0, 0.125);
-	--btn-disabled-color: var(--warning);
-	--btn-disabled-bg: transparent;
-	--btn-disabled-border-color: var(--warning);
-	--gradient: none;
-}
-
-.btn-outline-danger {
-	--btn-color: var(--danger);
-	--btn-border-color: var(--danger);
-	--btn-hover-color: hsl(0, 0%, 100%);
-	--btn-hover-bg: var(--danger);
-	--btn-hover-border-color: var(--danger);
-	--btn-focus-shadow-rgb: 225, 83, 97;
-	--btn-active-color: hsl(0, 0%, 100%);
-	--btn-active-bg: var(--danger);
-	--btn-active-border-color: var(--danger);
-	--btn-active-shadow: inset 0 3px 5px rgba(0, 0, 0, 0.125);
-	--btn-disabled-color: var(--danger);
-	--btn-disabled-bg: transparent;
-	--btn-disabled-border-color: var(--danger);
-	--gradient: none;
-}
-
-.btn-outline-light {
-	--btn-color: #f8f9fa;
-	--btn-border-color: #f8f9fa;
-	--btn-hover-color: hsl(0, 0%, 0%);
-	--btn-hover-bg: #f8f9fa;
-	--btn-hover-border-color: #f8f9fa;
-	--btn-focus-shadow-rgb: 216, 217, 219;
-	--btn-active-color: hsl(0, 0%, 0%);
-	--btn-active-bg: #f8f9fa;
-	--btn-active-border-color: #f8f9fa;
-	--btn-active-shadow: inset 0 3px 5px rgba(0, 0, 0, 0.125);
-	--btn-disabled-color: #f8f9fa;
-	--btn-disabled-bg: transparent;
-	--btn-disabled-border-color: #f8f9fa;
-	--gradient: none;
-}
-
-.btn-outline-dark {
-	--btn-color: #343a40;
-	--btn-border-color: #343a40;
-	--btn-hover-color: hsl(0, 0%, 100%);
-	--btn-hover-bg: #343a40;
-	--btn-hover-border-color: #343a40;
-	--btn-focus-shadow-rgb: 82, 88, 93;
-	--btn-active-color: hsl(0, 0%, 100%);
-	--btn-active-bg: #343a40;
-	--btn-active-border-color: #343a40;
-	--btn-active-shadow: inset 0 3px 5px rgba(0, 0, 0, 0.125);
-	--btn-disabled-color: #343a40;
-	--btn-disabled-bg: transparent;
-	--btn-disabled-border-color: #343a40;
-	--gradient: none;
-}

updates.xml

@@ -1,26 +1,28 @@
 <?xml version='1.0' encoding='UTF-8'?>
 <!-- Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
  SPDX-License-Identifier: GPL-3.0-or-later
- VERSION: 03.09.14
+ VERSION: 03.10.23
+ NOTE: This repository is RETIRED. All channels point to the same final stable release.
+ All future development is at https://git.mokoconsulting.tech/MokoConsulting/MokoOnyx
  -->
 
 <updates>
 
-  <!-- 1. DEVELOPMENT — dev → -->
+  <!-- All channels point to the same final release so every site sees the update -->
+
   <update>
     <name>MokoCassiopeia</name>
-    <description>MokoCassiopeia development build — unstable.</description>
+    <description>MokoCassiopeia is retired. Please install MokoOnyx instead.</description>
     <element>mokocassiopeia</element>
     <type>template</type>
     <client>site</client>
-    <version>03.09.14</version>
-    <creationDate>2026-04-14</creationDate>
-    <infourl title='MokoCassiopeia Dev'>https://git.mokoconsulting.tech/MokoConsulting/MokoCassiopeia/releases/tag/development</infourl>
+    <version>03.10.23</version>
+    <creationDate>2026-04-21</creationDate>
+    <infourl title='MokoCassiopeia'>https://git.mokoconsulting.tech/MokoConsulting/MokoCassiopeia/releases/tag/v03</infourl>
     <downloads>
-      <downloadurl type='full' format='zip'>https://git.mokoconsulting.tech/MokoConsulting/MokoCassiopeia/releases/download/development/mokocassiopeia-03.09.14-dev.zip</downloadurl>
-      <downloadurl type='full' format='zip'>https://git.mokoconsulting.tech/MokoConsulting/MokoCassiopeia/releases/download/development/mokocassiopeia-03.09.14-dev.zip</downloadurl>
+      <downloadurl type='full' format='zip'>https://git.mokoconsulting.tech/MokoConsulting/MokoCassiopeia/releases/download/v03/mokocassiopeia-03.10.23.zip</downloadurl>
     </downloads>
-    <sha256>4cbe4fc379182ef17580396e7d12ce4ce95a90017ef364b922bdc2d04b0b3d97</sha256>
+    <sha256>314ead3bafbaea370796b7ed9d8353ae9964becbf7ccf9be09e94229973440fc</sha256>
     <tags><tag>development</tag></tags>
     <maintainer>Moko Consulting</maintainer>
     <maintainerurl>https://mokoconsulting.tech</maintainerurl>
@@ -28,21 +30,19 @@
     <php_minimum>8.1</php_minimum>
   </update>
 
-  <!-- 2. ALPHA — dev → alpha → -->
   <update>
     <name>MokoCassiopeia</name>
-    <description>MokoCassiopeia alpha build — early testing.</description>
+    <description>MokoCassiopeia is retired. Please install MokoOnyx instead.</description>
     <element>mokocassiopeia</element>
     <type>template</type>
     <client>site</client>
-    <version>03.09.14</version>
-    <creationDate>2026-04-14</creationDate>
-    <infourl title='MokoCassiopeia Alpha'>https://git.mokoconsulting.tech/MokoConsulting/MokoCassiopeia/releases/tag/alpha</infourl>
+    <version>03.10.23</version>
+    <creationDate>2026-04-21</creationDate>
+    <infourl title='MokoCassiopeia'>https://git.mokoconsulting.tech/MokoConsulting/MokoCassiopeia/releases/tag/v03</infourl>
     <downloads>
-      <downloadurl type='full' format='zip'>https://git.mokoconsulting.tech/MokoConsulting/MokoCassiopeia/releases/download/alpha/mokocassiopeia-03.09.14-alpha.zip</downloadurl>
-      <downloadurl type='full' format='zip'>https://git.mokoconsulting.tech/MokoConsulting/MokoCassiopeia/releases/download/alpha/mokocassiopeia-03.09.14-alpha.zip</downloadurl>
+      <downloadurl type='full' format='zip'>https://git.mokoconsulting.tech/MokoConsulting/MokoCassiopeia/releases/download/v03/mokocassiopeia-03.10.23.zip</downloadurl>
     </downloads>
-    <sha256>c2660acdf7389244462485f7ab4c286e9f851366a148acc16739a184576f7932</sha256>
+    <sha256>314ead3bafbaea370796b7ed9d8353ae9964becbf7ccf9be09e94229973440fc</sha256>
     <tags><tag>alpha</tag></tags>
     <maintainer>Moko Consulting</maintainer>
     <maintainerurl>https://mokoconsulting.tech</maintainerurl>
@@ -50,21 +50,19 @@
     <php_minimum>8.1</php_minimum>
   </update>
 
-  <!-- 3. BETA — dev → alpha → beta → -->
   <update>
     <name>MokoCassiopeia</name>
-    <description>MokoCassiopeia beta build — feature complete, stability testing.</description>
+    <description>MokoCassiopeia is retired. Please install MokoOnyx instead.</description>
     <element>mokocassiopeia</element>
     <type>template</type>
     <client>site</client>
-    <version>03.09.14</version>
-    <creationDate>2026-04-14</creationDate>
-    <infourl title='MokoCassiopeia Beta'>https://git.mokoconsulting.tech/MokoConsulting/MokoCassiopeia/releases/tag/beta</infourl>
+    <version>03.10.23</version>
+    <creationDate>2026-04-21</creationDate>
+    <infourl title='MokoCassiopeia'>https://git.mokoconsulting.tech/MokoConsulting/MokoCassiopeia/releases/tag/v03</infourl>
     <downloads>
-      <downloadurl type='full' format='zip'>https://git.mokoconsulting.tech/MokoConsulting/MokoCassiopeia/releases/download/beta/mokocassiopeia-03.09.14-beta.zip</downloadurl>
-      <downloadurl type='full' format='zip'>https://git.mokoconsulting.tech/MokoConsulting/MokoCassiopeia/releases/download/beta/mokocassiopeia-03.09.14-beta.zip</downloadurl>
+      <downloadurl type='full' format='zip'>https://git.mokoconsulting.tech/MokoConsulting/MokoCassiopeia/releases/download/v03/mokocassiopeia-03.10.23.zip</downloadurl>
     </downloads>
-    <sha256>4cbe4fc379182ef17580396e7d12ce4ce95a90017ef364b922bdc2d04b0b3d97</sha256>
+    <sha256>314ead3bafbaea370796b7ed9d8353ae9964becbf7ccf9be09e94229973440fc</sha256>
     <tags><tag>beta</tag></tags>
     <maintainer>Moko Consulting</maintainer>
     <maintainerurl>https://mokoconsulting.tech</maintainerurl>
@@ -72,21 +70,19 @@
     <php_minimum>8.1</php_minimum>
   </update>
 
-  <!-- 4. RC — dev → alpha → beta → rc → -->
   <update>
     <name>MokoCassiopeia</name>
-    <description>MokoCassiopeia release candidate — testing only.</description>
+    <description>MokoCassiopeia is retired. Please install MokoOnyx instead.</description>
     <element>mokocassiopeia</element>
     <type>template</type>
     <client>site</client>
-    <version>03.09.14</version>
-    <creationDate>2026-04-14</creationDate>
-    <infourl title='MokoCassiopeia RC'>https://git.mokoconsulting.tech/MokoConsulting/MokoCassiopeia/releases/tag/release-candidate</infourl>
+    <version>03.10.23</version>
+    <creationDate>2026-04-21</creationDate>
+    <infourl title='MokoCassiopeia'>https://git.mokoconsulting.tech/MokoConsulting/MokoCassiopeia/releases/tag/v03</infourl>
     <downloads>
-      <downloadurl type='full' format='zip'>https://git.mokoconsulting.tech/MokoConsulting/MokoCassiopeia/releases/download/release-candidate/mokocassiopeia-03.09.14-rc.zip</downloadurl>
-      <downloadurl type='full' format='zip'>https://git.mokoconsulting.tech/MokoConsulting/MokoCassiopeia/releases/download/release-candidate/mokocassiopeia-03.09.14-rc.zip</downloadurl>
+      <downloadurl type='full' format='zip'>https://git.mokoconsulting.tech/MokoConsulting/MokoCassiopeia/releases/download/v03/mokocassiopeia-03.10.23.zip</downloadurl>
     </downloads>
-    <sha256>c2660acdf7389244462485f7ab4c286e9f851366a148acc16739a184576f7932</sha256>
+    <sha256>314ead3bafbaea370796b7ed9d8353ae9964becbf7ccf9be09e94229973440fc</sha256>
     <tags><tag>rc</tag></tags>
     <maintainer>Moko Consulting</maintainer>
     <maintainerurl>https://mokoconsulting.tech</maintainerurl>
@@ -94,21 +90,19 @@
     <php_minimum>8.1</php_minimum>
   </update>
 
-  <!-- 5. STABLE — dev → alpha → beta → rc → version/XX → main -->
   <update>
     <name>MokoCassiopeia</name>
-    <description>Moko Consulting's site template based on Cassiopeia.</description>
+    <description>MokoCassiopeia is retired. Please install MokoOnyx instead.</description>
     <element>mokocassiopeia</element>
     <type>template</type>
     <client>site</client>
-    <version>03.09.14</version>
-    <creationDate>2026-04-14</creationDate>
+    <version>03.10.23</version>
+    <creationDate>2026-04-21</creationDate>
     <infourl title='MokoCassiopeia'>https://git.mokoconsulting.tech/MokoConsulting/MokoCassiopeia/releases/tag/v03</infourl>
     <downloads>
-      <downloadurl type='full' format='zip'>https://git.mokoconsulting.tech/MokoConsulting/MokoCassiopeia/releases/download/v03/mokocassiopeia-03.09.14.zip</downloadurl>
-      <downloadurl type='full' format='zip'>https://git.mokoconsulting.tech/MokoConsulting/MokoCassiopeia/releases/download/v03/mokocassiopeia-03.09.14.zip</downloadurl>
+      <downloadurl type='full' format='zip'>https://git.mokoconsulting.tech/MokoConsulting/MokoCassiopeia/releases/download/v03/mokocassiopeia-03.10.23.zip</downloadurl>
     </downloads>
-    <sha256>c2660acdf7389244462485f7ab4c286e9f851366a148acc16739a184576f7932</sha256>
+    <sha256>314ead3bafbaea370796b7ed9d8353ae9964becbf7ccf9be09e94229973440fc</sha256>
     <tags><tag>stable</tag></tags>
     <maintainer>Moko Consulting</maintainer>
     <maintainerurl>https://mokoconsulting.tech</maintainerurl>