GeniXCMS

Themes

categoryUser Guide edit_calendar31 Mar 2026

Theme & Appearance Management


GeniXCMS features a sophisticated, decoupled theme engine that allows you to instantly change the visual presentation of your site without affecting your underlying content or data structure.


🎨 Activating a New Theme

Changing your site's aesthetic is an instantaneous process through the Appearance dashboard.

  1. Deployment: Upload your theme directory to inc/themes/{theme-slug}/.
  2. Selection: Navigate to Admin > Appearance.
  3. Activation: A list of available themes will be displayed along with their name, description, and preview icon. Click Activate to instantly make the theme live.

⚙️ Theme Configuration (Options)

Premium themes often provide a dedicated administration panel (options.php) for granular control over colors, layouts, and typography.

  • Access Level: If a theme supports options, a Theme Settings link will appear in the left sidebar menu under the Appearance group.
  • Dynamic Updates: Changes made in the theme options are applied instantly to the frontend.

🏗️ Managing Widget Placement

Widgets provide dynamic functional blocks for your theme's sidebars and footers (e.g., Categories, Recent Posts, Search).

  1. Navigate to Admin > Appearance > Widgets.
  2. The dashboard displays all Available Widgets and the core Widget Areas defined by your active theme.
  3. Assigning: Use the Select Widget and Select Area dropdowns to dispatch a widget to a specific sidebar or footer zone.

🚀 Theme Development Quick Start

If you are a developer or designer interested in crafting your own unique experience:

  • CLI Engine: Use php genix make:theme my-theme to scaffold an entire theme structure in seconds.
  • Engine: GeniXCMS consumes Latte files for lightning-fast, secure template rendering.
  • Guide: Read the Create a Theme documentation for a technical deep-dive.

priority_high
ImportantAsset Loading: Modern GeniXCMS themes (v2.0.0+) often leverage Vite for asset bundling. If your theme assets are not loading correctly, ensure your Vite dev server is running or that a production npm run build has been executed.