diff --git a/CHANGELOG.md b/CHANGELOG.md
index 19339fb..22a17a8 100644
--- a/CHANGELOG.md
+++ b/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
diff --git a/README.md b/README.md
index 77f1e01..a98ddac 100644
--- a/README.md
+++ b/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**
diff --git a/src/joomla.asset.json b/src/joomla.asset.json
index c1e1813..137be85 100644
--- a/src/joomla.asset.json
+++ b/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"
}
},
diff --git a/src/script.php b/src/script.php
index 5af080c..793548a 100644
--- a/src/script.php
+++ b/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;
}
diff --git a/src/templateDetails.xml b/src/templateDetails.xml
index 44754a4..34d1a88 100644
--- a/src/templateDetails.xml
+++ b/src/templateDetails.xml
@@ -39,13 +39,13 @@
MokoCassiopeia continues Joomla's tradition of space-themed default templates— building on the legacy of Solarflare (Joomla 1.0), Milkyway (Joomla 1.5), and Protostar (Joomla 3.0).
This template is a customized fork of the Cassiopeia 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.
Starter palette files are included with the template. To create a custom colour scheme, copy templates/mokocassiopeia/templates/light.custom.css to media/templates/site/mokocassiopeia/css/theme/light.custom.css, or templates/mokocassiopeia/templates/dark.custom.css to media/templates/site/mokocassiopeia/css/theme/dark.custom.css. Customise the CSS variables to match your brand, then activate your palette in System → Site Templates → MokoCassiopeia → Theme tab by selecting "Custom" for the Light or Dark Mode Palette. A full variable reference is available in the CSS Variables tab in template options.
For site-specific styles and scripts that should survive template updates, create the following files:
media/templates/site/mokocassiopeia/css/user.css — loaded on every page for custom CSS overrides.media/templates/site/mokocassiopeia/js/user.js — loaded on every page for custom JavaScript.These files are gitignored and will not be overwritten by template updates.
This template is based on the original Cassiopeia template developed by the Joomla! Project and released under the GNU General Public License.
Modifications and enhancements have been made by Moko Consulting in accordance with open-source licensing standards.
It includes integration with Bootstrap TOC, an open-source table of contents generator by A. Feld, licensed under the MIT License.
All third-party libraries and assets remain the property of their respective authors and are credited within their source files where applicable.
]]> +MokoCassiopeia continues Joomla's tradition of space-themed default templates— building on the legacy of Solarflare (Joomla 1.0), Milkyway (Joomla 1.5), and Protostar (Joomla 3.0).
This template is a customized fork of the Cassiopeia 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.
Starter palette files are included with the template. To create a custom colour scheme, copy templates/mokocassiopeia/templates/light.custom.css to media/templates/site/mokocassiopeia/css/theme/light.custom.css, or templates/mokocassiopeia/templates/dark.custom.css to media/templates/site/mokocassiopeia/css/theme/dark.custom.css. Customise the CSS variables to match your brand, then activate your palette in System → Site Templates → MokoCassiopeia → Theme tab by selecting "Custom" for the Light or Dark Mode Palette. A full variable reference is available in the CSS Variables tab in template options.
For site-specific styles and scripts that should survive template updates, create the following files:
media/templates/site/mokocassiopeia/css/user.css — loaded on every page for custom CSS overrides.media/templates/site/mokocassiopeia/js/user.js — loaded on every page for custom JavaScript.These files are gitignored and will not be overwritten by template updates.
This template is based on the original Cassiopeia template developed by the Joomla! Project and released under the GNU General Public License.
Modifications and enhancements have been made by Moko Consulting in accordance with open-source licensing standards.
It includes integration with Bootstrap TOC, an open-source table of contents generator by A. Feld, licensed under the MIT License.
All third-party libraries and assets remain the property of their respective authors and are credited within their source files where applicable.
]]>