Back to Skills

theme-factory

Step-by-step guide to add a new UI theme to AiderDesk (SCSS + CSS variables + types + i18n).

1,025stars79forksUpdated 1/23/2026

Security Assessment

Safe(100/100)
Security Score100/100

About theme-factory

The 'theme-factory' skill is designed to guide users in adding new UI themes to AiderDesk, a platform that utilizes SCSS files for styling. The skill provides a comprehensive step-by-step approach for creating and integrating custom themes into the system. It helps solve the problem of adding personalized visual designs to the AiderDesk interface by leveraging the power of CSS custom properties (variables) and Tailwind utilities, enabling easy customization while ensuring consistency across the platform.

This skill encompasses several key capabilities including theme creation through SCSS, theme registration in both TypeScript and the theme aggregator, and the addition of internationalization (i18n) support for theme names. It also emphasizes the importance of thorough testing, including verifying color contrast and UI element visibility, ensuring a seamless and accessible user experience. The process is designed to be simple yet robust, requiring minimal setup from the user while maintaining high customization flexibility.

The primary use cases for this skill are developers and designers working with AiderDesk who need to integrate custom themes into the platform. It's targeted at those who want to modify the look and feel of AiderDesk without altering its core functionality, ensuring the UI aligns with brand identity or user preferences. It's especially useful for teams looking to provide different visual options for users or to create a visually cohesive experience across various AiderDesk instances.

FAQ

How do I add a new theme to AiderDesk?

To add a new theme, follow the step-by-step checklist which includes choosing a theme name, creating an SCSS file, registering the theme in the theme aggregator, updating TypeScript types, adding i18n support, and verifying the theme in the UI.

What should I do if the new theme doesn't appear in the settings?

Ensure the theme's SCSS file is imported in the theme aggregator (`themes.scss`) and that the theme name is registered in the `THEMES` array in `types.ts`. Also, check for any typos or mismatches between the class name and the stored settings.

Can I use my own color variables for the new theme?

Yes, you can define your own color variables in the theme's SCSS file. Ensure you define all required `--color-*` variables to maintain consistency across the UI.

Are there any requirements for the color contrast in the new theme?

Yes, make sure the theme meets WCAG AA standards for color contrast to ensure text is readable against all background colors.

What if parts of the UI appear unstyled after switching themes?

This issue is often due to missing `--color-*` variables. Compare your theme with a working one (like `theme-dark.scss`) and fill in any missing variables.

Install theme-factory

Download and extract the skill files to your .claude/skills/ directory.

Quick Setup:

  1. Copy the skill folder to .claude/skills/
  2. Claude will automatically detect and use the skill