Publishing and Review

Reviewed community listing installs theme assets into the active vault.

Required Release Assets

Publish:

manifest.json
light.css
dark.css

The CSS filenames can differ when the manifest references different safe relative paths.

For each colorscheme, Cortex looks for:

1. The exact relative path from manifest.colorschemes.
2. The basename of that path.
3. <colorscheme>.css, such as light.css or dark.css.

Manifest checks

The reviewed listing flow verifies:

• manifest.json is valid JSON.
• manifest.id matches the listing entry id.
• colorschemes.light and colorschemes.dark are safe relative paths.
• Both stylesheet assets exist before replacing an installed theme.

Install and rollback behavior

Cortex installs into:

<vault>/.cortex/themes/<theme-id>

Theme install and update use staging inside the vault themes directory. Cortex preserves the previous installation until staging is promoted and community themes reload successfully. On failure, it removes staging and restores the previous theme best effort.

Release checklist

1. Include manifest.json.
2. Include both light and dark CSS assets.
3. Keep stylesheet paths relative and free of ...
4. Test applying the theme from light, dark, and system appearance modes.
5. Test uninstall while the theme is active.