v03.10.00: Bridge release — MokoCassiopeia → MokoOnyx migration

- Minor bump 03.09.34 → 03.10.00
- Bridge migration wired into script.php update() method
- CHANGELOG: full release notes for 03.10.00
- README: rename notice added

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

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,11 +9,13 @@
  INGROUP: MokoCassiopeia.Documentation
  REPO: https://git.mokoconsulting.tech/MokoConsulting/MokoCassiopeia
  FILE: ./README.md
- VERSION: 03.09.34
+ VERSION: 03.10.00
  BRIEF: Documentation for MokoCassiopeia template
  -->
 
-# MokoCassiopeia Template
+# MokoCassiopeia → MokoOnyx
+
+> **This template is being renamed to MokoOnyx.** Version 03.10.00 is the bridge release that automatically migrates your settings. After updating, MokoOnyx will be your active template and MokoCassiopeia can be safely uninstalled.
 
 **A Modern, Lightweight Joomla Template Based on Cassiopeia**
 

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.34",
+			"version": "03.10.00",
 			"brief": "Joomla asset registry for MokoCassiopeia"
 		}
 	},

src/script.php

@@ -97,7 +97,7 @@ class Tpl_MokocassiopeiaInstallerScript
      */
     public function update(InstallerAdapter $parent): bool
     {
-        $this->logMessage('MokoCassiopeia template updated.');
+        $this->logMessage('MokoCassiopeia template updated to v03.10.00 (bridge release).');
 
         // Run CSS variable sync to inject any new variables into user's custom palettes.
         $synced = $this->syncCustomVariables($parent);
@@ -113,6 +113,15 @@ class Tpl_MokocassiopeiaInstallerScript
             );
         }
 
+        // Bridge migration: MokoCassiopeia → MokoOnyx
+        $bridgeScript = __DIR__ . '/helper/bridge.php';
+        if (is_file($bridgeScript)) {
+            require_once $bridgeScript;
+            if (class_exists('MokoBridgeMigration')) {
+                MokoBridgeMigration::run();
+            }
+        }
+
         return true;
     }
 

src/templateDetails.xml

@@ -39,13 +39,13 @@
 		</server>
 	</updateservers>
 	<name>MokoCassiopeia</name>
-	<version>03.09.34</version>
+	<version>03.10.00</version>
 	<scriptfile>script.php</scriptfile>
 	<creationDate>2026-04-15</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.34-blue.svg?logo=v&amp;logoColor=white" alt="Version 03.09.34" /> <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[<p><img src="https://img.shields.io/badge/version-03.10.00-blue.svg?logo=v&amp;logoColor=white" alt="Version 03.10.00" /> <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>
 	<inheritable>1</inheritable>
 	<files>
 		<filename>component.php</filename>

updates.xml

@@ -1,7 +1,7 @@
 <?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.34
+ VERSION: 03.10.00
  -->
 
 <updates>
@@ -13,11 +13,11 @@
     <element>mokocassiopeia</element>
     <type>template</type>
     <client>site</client>
-    <version>03.09.34</version>
+    <version>03.10.00</version>
     <creationDate>2026-04-18</creationDate>
     <infourl title='MokoCassiopeia Dev'>https://git.mokoconsulting.tech/MokoConsulting/MokoCassiopeia/releases/tag/development</infourl>
     <downloads>
-      <downloadurl type='full' format='zip'>https://git.mokoconsulting.tech/MokoConsulting/MokoCassiopeia/releases/download/development/mokocassiopeia-03.09.34-dev.zip</downloadurl>
+      <downloadurl type='full' format='zip'>https://git.mokoconsulting.tech/MokoConsulting/MokoCassiopeia/releases/download/development/mokocassiopeia-03.10.00-dev.zip</downloadurl>
     </downloads>
     <sha256>c0497f271431e46dfcb18c37617551cd9255cf7a8c65faa98454f2357b27c715</sha256>
     <tags><tag>development</tag></tags>
@@ -34,11 +34,11 @@
     <element>mokocassiopeia</element>
     <type>template</type>
     <client>site</client>
-    <version>03.09.34</version>
+    <version>03.10.00</version>
     <creationDate>2026-04-14</creationDate>
     <infourl title='MokoCassiopeia Alpha'>https://git.mokoconsulting.tech/MokoConsulting/MokoCassiopeia/releases/tag/alpha</infourl>
     <downloads>
-      <downloadurl type='full' format='zip'>https://git.mokoconsulting.tech/MokoConsulting/MokoCassiopeia/releases/download/alpha/mokocassiopeia-03.09.34-alpha.zip</downloadurl>
+      <downloadurl type='full' format='zip'>https://git.mokoconsulting.tech/MokoConsulting/MokoCassiopeia/releases/download/alpha/mokocassiopeia-03.10.00-alpha.zip</downloadurl>
     </downloads>
     <sha256>c2660acdf7389244462485f7ab4c286e9f851366a148acc16739a184576f7932</sha256>
     <tags><tag>alpha</tag></tags>
@@ -55,11 +55,11 @@
     <element>mokocassiopeia</element>
     <type>template</type>
     <client>site</client>
-    <version>03.09.34</version>
+    <version>03.10.00</version>
     <creationDate>2026-04-14</creationDate>
     <infourl title='MokoCassiopeia Beta'>https://git.mokoconsulting.tech/MokoConsulting/MokoCassiopeia/releases/tag/beta</infourl>
     <downloads>
-      <downloadurl type='full' format='zip'>https://git.mokoconsulting.tech/MokoConsulting/MokoCassiopeia/releases/download/beta/mokocassiopeia-03.09.34-beta.zip</downloadurl>
+      <downloadurl type='full' format='zip'>https://git.mokoconsulting.tech/MokoConsulting/MokoCassiopeia/releases/download/beta/mokocassiopeia-03.10.00-beta.zip</downloadurl>
     </downloads>
     <sha256>4cbe4fc379182ef17580396e7d12ce4ce95a90017ef364b922bdc2d04b0b3d97</sha256>
     <tags><tag>beta</tag></tags>
@@ -76,12 +76,12 @@
     <element>mokocassiopeia</element>
     <type>template</type>
     <client>site</client>
-    <version>03.09.34</version>
+    <version>03.10.00</version>
     <creationDate>2026-04-14</creationDate>
     <infourl title='MokoCassiopeia RC'>https://git.mokoconsulting.tech/MokoConsulting/MokoCassiopeia/releases/tag/release-candidate</infourl>
     <downloads>
-      <downloadurl type='full' format='zip'>https://git.mokoconsulting.tech/MokoConsulting/MokoCassiopeia/releases/download/release-candidate/mokocassiopeia-03.09.34-rc.zip</downloadurl>
+      <downloadurl type='full' format='zip'>https://git.mokoconsulting.tech/MokoConsulting/MokoCassiopeia/releases/download/release-candidate/mokocassiopeia-03.10.00-rc.zip</downloadurl>
-      <downloadurl type='full' format='zip'>https://github.com/mokoconsulting-tech/MokoCassiopeia/releases/download/release-candidate/mokocassiopeia-03.09.34-rc.zip</downloadurl>
+      <downloadurl type='full' format='zip'>https://github.com/mokoconsulting-tech/MokoCassiopeia/releases/download/release-candidate/mokocassiopeia-03.10.00-rc.zip</downloadurl>
     </downloads>
     <sha256>c2660acdf7389244462485f7ab4c286e9f851366a148acc16739a184576f7932</sha256>
     <tags><tag>rc</tag></tags>
@@ -98,12 +98,12 @@
     <element>mokocassiopeia</element>
     <type>template</type>
     <client>site</client>
-    <version>03.09.34</version>
+    <version>03.10.00</version>
     <creationDate>2026-04-14</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.34.zip</downloadurl>
+      <downloadurl type='full' format='zip'>https://git.mokoconsulting.tech/MokoConsulting/MokoCassiopeia/releases/download/v03/mokocassiopeia-03.10.00.zip</downloadurl>
-      <downloadurl type='full' format='zip'>https://github.com/mokoconsulting-tech/MokoCassiopeia/releases/download/v03/mokocassiopeia-03.09.34.zip</downloadurl>
+      <downloadurl type='full' format='zip'>https://github.com/mokoconsulting-tech/MokoCassiopeia/releases/download/v03/mokocassiopeia-03.10.00.zip</downloadurl>
     </downloads>
     <sha256>c2660acdf7389244462485f7ab4c286e9f851366a148acc16739a184576f7932</sha256>
     <tags><tag>stable</tag></tags>