<!--
 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: Moko-Cassiopeia.Documentation
 REPO: https://github.com/mokoconsulting-tech/moko-cassiopeia
 FILE: docs/ROADMAP.md
 VERSION: 03.05.00
 BRIEF: Version-specific roadmap for Moko-Cassiopeia template
 PATH: /docs/ROADMAP.md
-->

# Moko-Cassiopeia Roadmap (VERSION: 03.05.00)

This document provides a comprehensive, version-specific roadmap for the Moko-Cassiopeia Joomla template, tracking feature evolution, current capabilities, and planned enhancements.

## Table of Contents

- [Version Timeline](#version-timeline)
  - [Past Releases](#past-releases)
  - [Future Roadmap (5-Year Plan)](#future-roadmap-5-year-plan)
- [Current Release (v03.05.00)](#current-release-v030500)
- [Implemented Features](#implemented-features)
- [Planned Features](#planned-features)
- [Development Priorities](#development-priorities)
- [Long-term Vision](#long-term-vision)
- [External Resources](#external-resources)

---

## 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.05.00 (2026-01-04) - Workflow & Governance
**Status**: Current Release (in code)

**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 Features**:
- **WCAG 2.1 AA Compliance**
  - Full accessibility audit and remediation
  - High-contrast theme options
  - Screen reader optimizations
  - Keyboard navigation enhancements
  - ARIA landmark improvements

- **Performance Optimizations**
  - Critical CSS inlining
  - Lazy loading for images and below-fold content
  - WebP image support with automatic fallbacks
  - Advanced asset bundling and minification
  - Service worker for offline functionality

- **Developer Experience**
  - Development mode enablement (unminified assets, debug output)
  - Live reload during development
  - Enhanced error logging and diagnostics
  - Template debugging tools

- **Content Features**
  - Soft offline mode (category-based access during maintenance)
  - Enhanced article layouts (grid, masonry options)
  - Advanced typography controls

**Infrastructure**:
- Codeception test coverage expanded to 80%+
- Automated performance testing in CI/CD
- Enhanced security scanning with additional tools

---

#### v05.00.00 (Q4 2028) - Visual Builder & Advanced SEO
**Status**: Planned  
**Target Release**: December 2028

**Major Features**:
- **Visual Page Builder Integration**
  - Drag-and-drop layout editor
  - Real-time preview
  - Preset layout templates library
  - Custom component builder
  - Style preset management

- **Advanced SEO Module**
  - Schema markup generator (JSON-LD)
  - Open Graph and Twitter Card management
  - Automatic sitemap generation
  - Meta tag optimization tools
  - Rich snippets support

- **E-commerce Enhancements**
  - Expanded VirtueMart integration
  - WooCommerce bridge support
  - Shopping cart widget improvements
  - Product showcase layouts

- **Social Integration**
  - Social media feed aggregation
  - Share buttons with analytics
  - Social login integration
  - Comment system enhancements

**Infrastructure**:
- Joomla 6.x compatibility (if released)
- PHP 8.2+ requirement
- Multi-site template synchronization
- Cloud storage integration for media

---

#### v06.00.00 (Q4 2029) - Enterprise Features & Headless CMS
**Status**: Planned  
**Target Release**: December 2029

**Major Features**:
- **Headless CMS Mode**
  - API-first rendering capability
  - RESTful API endpoints for template data
  - JSON:API compliance
  - GraphQL support
  - Decoupled frontend options

- **Enterprise Support Tier**
  - Advanced caching strategies
  - CDN integration (Cloudflare, AWS CloudFront)
  - Multi-language management system
  - Advanced user role customization
  - White-label branding options

- **AI-Powered Features**
  - AI accessibility checker
  - Automated content suggestions
  - Smart image optimization
  - Intelligent layout recommendations

- **Advanced Customization**
  - Theme marketplace ecosystem
  - Community-contributed extensions
  - Style inheritance system
  - CSS variable management UI

**Infrastructure**:
- Containerized deployment options (Docker)
- Kubernetes support for scaling
- Advanced monitoring and analytics
- Enterprise security features (SSO, 2FA)

---

#### v07.00.00 (Q4 2030) - AI Integration & Advanced Personalization
**Status**: Planned  
**Target Release**: December 2030

**Major Features**:
- **AI-Powered Personalization**
  - Content recommendation engine
  - Adaptive layouts based on user behavior
  - A/B testing framework
  - Predictive analytics dashboard
  - Smart content organization

- **Advanced Newsletter Integration**
  - Mailchimp, Sendinblue, SendGrid support
  - Automated email campaigns
  - Subscriber segmentation
  - Template-based email design
  - Analytics and reporting

- **Progressive Web App (PWA)**
  - Full offline functionality
  - Install to home screen
  - Push notifications
  - Background sync
  - App shell architecture

- **Advanced Media Management**
  - Video hosting integration (YouTube, Vimeo, self-hosted)
  - Image gallery enhancements
  - 3D model support
  - Audio player integration
  - Media CDN optimization

**Infrastructure**:
- Edge computing support
- Serverless deployment options
- Advanced caching with Redis/Memcached
- Real-time collaboration features

---

#### v08.00.00 (Q4 2031) - Next-Generation Platform
**Status**: Conceptual  
**Target Release**: December 2031

**Major Features**:
- **Next-Gen Web Standards**
  - HTTP/3 optimization
  - WebAssembly components
  - Web Components integration
  - Modern CSS features (Container Queries, Cascade Layers)
  - Advanced animations and transitions

- **Immersive Technologies**
  - WebXR support for AR/VR content
  - 3D visualization tools
  - Interactive media experiences
  - Spatial navigation

- **Blockchain Integration** (if relevant)
  - Decentralized content verification
  - NFT showcase capabilities
  - Web3 wallet integration
  - Smart contract interactions

- **Advanced Analytics & Business Intelligence**
  - Real-time visitor analytics
  - Conversion tracking and optimization
  - Heatmap and session recording
  - Custom reporting dashboards
  - Data warehouse integration

- **Ecosystem & Marketplace**
  - Extensive plugin marketplace
  - Template derivatives and child themes
  - Professional support network
  - Training and certification programs
  - Community-driven roadmap

**Infrastructure**:
- Quantum-ready cryptography
- Carbon-neutral hosting optimization
- Advanced security with zero-trust architecture
- Multi-cloud deployment strategies

---

## Current Release (v03.05.00)

### 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 (v2.1.5 - Mentioned)
**Status**: Planned/In Development  
**Description**: Keep selected categories accessible during maintenance mode
**Use Cases**:
- Legal documents remain viewable during downtime
- Policy pages accessible for compliance
- Terms of service always available
**Configuration**:
- Admin-selectable categories
- Per-category offline access control

#### 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

**Performance Optimizations**:
- Critical CSS inlining
- Lazy loading for below-the-fold content
- WebP image support with fallbacks
- Service worker for offline functionality

**Additional Integrations**:
- More e-commerce platform support
- Newsletter integration (Mailchimp, Sendinblue)
- Social media feed aggregation
- Advanced SEO tools

**Content Builder**:
- Visual page builder integration
- Drag-and-drop layout editor
- Preset layout templates
- Style presets library

---

## Development Priorities

### Immediate Focus (v03.x - 2026)
1. **TODO Tracking System**: Implement separate file for issue tracking
2. **Soft Offline Mode**: Complete category-based offline access
3. **Security Updates**: Maintain Dependabot and CodeQL scans
4. **Documentation**: Keep docs synchronized with features
5. **Bug Fixes**: Address reported issues and edge cases

### v04.00.00 Priorities (2027)
1. **WCAG 2.1 AA Compliance**: Full accessibility audit and implementation
2. **Performance Optimizations**: Critical CSS, lazy loading, WebP support
3. **Development Mode**: Enable comprehensive developer tools
4. **Testing**: Achieve 80%+ Codeception coverage

### v05.00.00 Priorities (2028)
1. **Visual Page Builder**: Drag-and-drop layout editor
2. **Advanced SEO**: Schema markup, meta optimization
3. **E-commerce Enhancements**: Expanded platform support
4. **Social Integration**: Feed aggregation and sharing

### v06.00.00 Priorities (2029)
1. **Headless CMS Mode**: API-first architecture
2. **Enterprise Features**: Advanced caching, CDN integration
3. **AI-Powered Tools**: Accessibility checker, content optimization
4. **Marketplace Ecosystem**: Theme and extension marketplace

### v07.00.00+ Priorities (2030+)
1. **AI Personalization**: Adaptive layouts and content recommendations
2. **Progressive Web App**: Full offline functionality
3. **Advanced Analytics**: Real-time insights and BI integration
4. **Immersive Technologies**: AR/VR support, 3D visualization

---

## Long-term Vision

### Mission Statement
Moko-Cassiopeia 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. **Security**: Proactive vulnerability management
6. **Developer Experience**: Clear docs, easy setup, powerful tools

### 5-Year Strategic Roadmap

#### 2027 (v04.00.00) - Accessibility & Performance
- Achieve WCAG 2.1 AA compliance
- Implement critical performance optimizations
- Enable development mode for developers
- Expand automated testing coverage

#### 2028 (v05.00.00) - Visual Builder & SEO
- Launch integrated visual page builder
- Deploy advanced SEO tools and schema markup
- Enhance e-commerce capabilities
- Integrate social media features

#### 2029 (v06.00.00) - Enterprise & Headless
- Introduce headless CMS capabilities
- Launch enterprise support tier
- Deploy AI-powered features
- Build marketplace ecosystem

#### 2030 (v07.00.00) - AI & Personalization
- AI-driven content personalization
- Progressive Web App functionality
- Advanced newsletter integration
- Real-time analytics and optimization

#### 2031 (v08.00.00) - Next-Generation Platform
- Next-gen web standards (HTTP/3, WebAssembly)
- Immersive technologies (WebXR)
- Advanced business intelligence
- Extensive ecosystem and marketplace

---

## External Resources

### Official Links
- **Full Roadmap**: [https://mokoconsulting.tech/support/joomla-cms/moko-cassiopeia-roadmap](https://mokoconsulting.tech/support/joomla-cms/moko-cassiopeia-roadmap)
- **Repository**: [https://github.com/mokoconsulting-tech/moko-cassiopeia](https://github.com/mokoconsulting-tech/moko-cassiopeia)
- **Issue Tracker**: [GitHub Issues](https://github.com/mokoconsulting-tech/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://github.com/mokoconsulting-tech/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://github.com/mokoconsulting-tech/moko-cassiopeia](https://github.com/mokoconsulting-tech/moko-cassiopeia)
* Path: /docs/ROADMAP.md
* Owner: Moko Consulting
* Version: 03.05.00
* Status: Active
* Last Updated: 2026-01-27
* 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 |