extensions-themes

Register theme extensions and manage lifecycle API flows for Madoc TS.

57|15|Updated Nov 28, 2018
One-click install
npx skills add https://github.com/digirati-co-uk/madoc-platform --skill extensions-themes
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: extensions-themes
Source: https://github.com/digirati-co-uk/madoc-platform/tree/main/.agents/skills/extensions-themes
Command: npx skills add https://github.com/digirati-co-uk/madoc-platform --skill extensions-themes

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Integrating and managing theme extensions in Madoc TS can be error-prone without a clear registry and lifecycle flow, causing themes or plugin overrides to be registered incorrectly or API calls to mismatch backend routes. This Skill captures how theme extensions are registered, how plugin override events are emitted, and how theme management APIs should be invoked to ensure consistent install/enable/disable/uninstall behavior.

Core Features & Use Cases

  • Registry-based Theme Registration: Explains the ThemeExtension pattern and the required registry name and registration lifecycle.
  • Theme Management API Flows: Describes list, get, install, enable, disable, and uninstall flows against the /api/madoc/system/themes endpoints.
  • Plugin Overrides & Event Handling: Covers how extensions emit register/remove events via the shared emitter to apply plugin-scoped overrides.
  • Use Case: Add a new theme definition, register plugin overrides for a site, and verify the install + enable sequence matches backend routes.

Quick Start

Register a new theme extension via the services/madoc-ts registry, add any plugin-scoped overrides, and verify install and enable flows against the /api/madoc/system/themes endpoints.

Frequently Asked Questions about extensions-themes

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I register a new theme extension in Madoc TS?

You register a Madoc TS theme extension by applying the ThemeExtension pattern via the services/madoc-ts registry, ensuring the required registry name and lifecycle are correctly configured for consistent frontend-backend behavior.

What is the correct API flow for installing and enabling Madoc themes?

The correct theme management API flow involves invoking list, install, and enable operations against the /api/madoc/system/themes endpoints to ensure the sequence matches backend routes and achieves consistent behavior.

How do plugin overrides work when emitting events in Madoc TS?

Plugin overrides in Madoc TS work by having extensions emit register and remove events via a shared emitter, which applies plugin-scoped overrides to the active theme during the lifecycle.

Can I manage the full lifecycle of Madoc TS themes using API endpoints?

Yes, you can manage the full theme lifecycle by invoking list, get, install, enable, disable, and uninstall API flows against the /api/madoc/system/themes endpoints for complete backend route alignment.

Why does my Madoc TS theme registration fail or mismatch backend routes?

Theme registration fails or mismatches backend routes when the registry name is incorrect or the ThemeExtension pattern is improperly applied, causing API calls to misalign with the /api/madoc/system/themes endpoints.