22ead38402
The repo health workflow previously required at least one dev/* branch to exist, which is too strict after the plain 'dev' branch was deleted. This change removes that requirement while keeping the validation that prohibits plain 'dev' branches. The workflow now: - Allows dev/* branches (e.g., dev/01.00.00) - Prohibits plain 'dev' branches - Does not require any dev/* branch to exist Co-authored-by: jmiller-moko <230051081+jmiller-moko@users.noreply.github.com>
Moko-Cassiopeia (VERSION: 03.05.00)
A modern, lightweight enhancement layer for Joomla's Cassiopeia template. Moko-Cassiopeia adds Font Awesome 7, Bootstrap 5 helpers, an automatic Table of Contents (TOC) utility, and optional Moko Expansions including Google Tag Manager and Google Analytics (GA4) hooks---all while keeping core template overrides minimal and upgrade-friendly.
Table of Contents
Features
Core Enhancements
- Built on top of Joomla's default Cassiopeia template.
- Font Awesome 6 integration.
- Bootstrap 5 helpers (grid, utility classes).
- Automatic TOC insertion for articles (activated via layout
toc-leftortoc-right).
Added in 2.0
- Dark Mode Toggle
- User-facing switch in the header.
- Persists preference with local storage.
- Admins can override default mode in template settings.
- Improved Template Params
- Configure logo, GTM container ID, and dark mode defaults directly from template settings.
New in 2.1.5 (In Development)
- Soft Offline Mode
- Keeps articles in specific categories available when the site is offline.
- Example: legal or policy documents remain publicly viewable even during maintenance.
- Admin can configure which categories remain accessible.
Requirements
- Joomla 4.4.x or 5.x
- PHP 8.0+
- MySQL/MariaDB compatible database
Quick Start
- Install
moko-cassiopeia.zipvia Joomla's Template Installer. - Set Moko-Cassiopeia as your default template.
- Configure template options under System → Site Templates → Moko-Cassiopeia.
Installation
Upload and install through Joomla's extension manager. If upgrading from a prior version, Joomla will safely overwrite files --- no manual uninstall required.
Configuration
Global Params
- Logo: Upload a custom site logo.
- Color Scheme: Toggle light/dark defaults.
- Analytics/GTM: Enable/disable optional expansions.
Font Awesome 7
- Fully integrated into Joomla's asset manager.
- No extra scripts required.
Bootstrap 5 Helpers
- Adds extended utility classes and responsive tweaks.
Table of Contents
- Select
toc-leftortoc-rightin article Options → Layout to insert TOC automatically.
Dark Mode Toggle
- User-facing switch in the header.
- Remembers preference via local storage.
- Default behavior can be set in template settings.
Soft Offline Mode
- Introduced in 2.1.5.
- Allows articles in selected categories to remain viewable during offline/maintenance mode.
- Useful for compliance, legal, or policy content.
Changelog
See the CHANGELOG.md for detailed version history.
Metadata
- Maintainer: Moko Consulting Engineering
- Repository: [https: //github.com/mokoconsulting-tech/moko-cassiopeoa](https: //github.com/mokoconsulting-tech/moko-cassiopeoa)
- File: README.md
- Version: 3.0
- Classification: Public Open Source Standards
Revision History
| Version | Date | Author | Description | | ------- | ---------- | -----------------------------_-- | ------------------------------------- | | 3.0 | 2025-12-09 | Jonathan Miller (@jmiller-moko) | Added Metadata and Revision History |