Theme Alternatives

Alternatives let one theme offer several looks, such as a light and a dark version, without making separate theme packages. Users choose one in Configuration > Customisation > Alternative Theme.

Two kinds of alternative

Scheme alternative An INI file in alternate, such as alternate/Dark.ini. The file name is the name users see. It can change any scheme setting and is applied after the theme's own schemes, which suits colours, transparency and spacing.
Packaged alternative A .muxalt archive in alternate, for variations that need different images, fonts, glyphs or several scheme files. It is unpacked into the theme when selected, so its paths start from the theme folder it replaces.

Extras

active.txtHolds the name of the alternative to use when the theme is first selected. It must match an .ini or .muxalt name in alternate.
alternate/rgb/{name}/rgbconf.shA matching lighting setup, applied with that alternative on devices with lighting controls.

Give every alternative a unique name, test each one at every resolution your theme supports, and keep a .muxalt to only the files it actually replaces.