Files
Jonathan Miller e8f355f32e
Some checks failed
Repo Health / Access control (push) Successful in 1s
Repo Health / Release configuration (push) Failing after 4s
Repo Health / Scripts governance (push) Successful in 4s
Repo Health / Repository health (push) Failing after 4s
Remove custom theme CSS from tracking, update gitignore with glob
Custom palettes (*.custom.css) are site-specific overrides that
should not be version controlled. Glob pattern covers all locations.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-18 15:14:20 -05:00
..

MokoCassiopeia Templates Directory

This directory contains template files for custom color schemes that can be copied to your template installation.

Custom Theme Palette Templates

Template files are provided for both light and dark themes with complete Bootstrap button definitions:

Available Templates

File Theme Description
light.custom.css Light Custom light theme with all Bootstrap button variants
dark.custom.css Dark Custom dark theme with all Bootstrap button variants

Using Custom Theme Templates

  1. Copy the template file to your template's CSS theme directory:

    # For light theme
    cp templates/light.custom.css src/media/css/theme/light.custom.css
    
    # For dark theme
    cp templates/dark.custom.css src/media/css/theme/dark.custom.css
    
  2. Customize the CSS variables in your copied file:

    • Modify --color-primary, --accent-color-primary, etc. to match your brand
    • Adjust Bootstrap state colors (--success, --info, --warning, --danger)
    • Update button variants if needed
  3. Register in src/joomla.asset.json:

    • Ensure template.light.custom and template.dark.custom assets are defined
    • Already configured by default in the asset manifest
  4. Activate via Joomla admin:

    • Go to System → Site Templates → MokoCassiopeia
    • Select "Custom" in the Theme Palette dropdown
    • Save and check your site

Bootstrap Button Variants Included

All template files include complete definitions for:

Solid Buttons:

  • .btn-primary, .btn-secondary, .btn-success, .btn-info, .btn-warning, .btn-danger, .btn-light, .btn-dark

Outline Buttons:

  • .btn-outline-primary, .btn-outline-secondary, .btn-outline-success, .btn-outline-info, .btn-outline-warning, .btn-outline-danger, .btn-outline-light, .btn-outline-dark

Each button variant includes hover, active, focus, and disabled states using CSS variables.

Theme System Features

CSS Variable Structure

Colors are defined as CSS variables allowing easy customization:

:root[data-bs-theme="light"] {
  --color-primary: #0066cc;
  --accent-color-primary: #3399ff;
  --success: #28a745;
  --danger: #dc3545;
  /* ...and many more */
}

Opacity Utilities

Template includes opacity utility variables for creating translucent colors:

--opacity-5: 0.05;
--opacity-10: 0.1;
--opacity-15: 0.15;
--opacity-25: 0.25;
--opacity-50: 0.5;
--opacity-75: 0.75;
--opacity-100: 1;

Use with rgba():

background-color: rgba(var(--black-rgb), var(--opacity-10));

Shadow Color Utilities

Pre-defined shadow color variables:

--shadow-color-light: rgba(var(--black-rgb), var(--opacity-15));
--shadow-color-medium: rgba(var(--black-rgb), var(--opacity-25));
--shadow-color-dark: rgba(var(--black-rgb), var(--opacity-30));

📚 Additional Resources


Template Directory: /templates/
Version: 03.08.04
Maintained by: Moko Consulting