Publishing and Review
Prepare theme release assets for review and community listing.
Reviewed community listing installs theme assets into the active vault.
Release a Version#
cortex checkcortex release patch # or minor, majorcortex release runs the checks, bumps version in manifest.json and package.json, commits,
tags v<version>, and pushes. The release workflow scaffolded by cortex create then runs
cortex pack and publishes the GitHub release with the manifest and both stylesheets.
Versions are plain MAJOR.MINOR.PATCH; pre-release suffixes break update checks.
List in the Marketplace#
cortex submitcortex submit verifies the latest GitHub release, then opens a pull request to the Marketplace
registry. Run it only for the first release and when the name, description, author, or cover image
change. Every later release reaches users automatically.
Required Release Assets#
Publish:
manifest.json
light.css
dark.cssThe CSS filenames can differ when the manifest references different safe relative paths.
For each colorscheme, Cortex looks for:
- The exact relative path from
manifest.colorschemes. - The basename of that path.
<colorscheme>.css, such aslight.cssordark.css.
Manifest checks#
The reviewed listing flow verifies:
manifest.jsonis valid JSON.manifest.idmatches the listing entry id.manifest.nameequalsmanifest.id.colorschemes.lightandcolorschemes.darkare 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.
Votes, Downloads, and Review#
Once listed, the Marketplace and the website show community signals for your theme, published by the registry's GitHub Actions:
- Votes are upvotes on the theme's Discussion in
cortex-md/registry. "Vote on GitHub" in Cortex and on the website opens it; counts refresh every 30 minutes. - Downloads add up the stylesheet downloads of every GitHub release, including updates.
- Automated review scans the latest release every day with the same static rules as
cortex check. A failing release opens an issue and a proposed block for a maintainer to decide. - Verified items are hand-picked by maintainers. Pulled versions stop being offered as installs or updates; installed copies are never removed automatically.
Run cortex stats to see all of this for your project. cortex submit also checks that you own the
repository, or are a public member of its organization, before opening the registry pull request.
Release checklist#
- Run
cortex checkand fix every error. - Include
manifest.json. - Include both light and dark CSS assets.
- Keep stylesheet paths relative and free of
... - Test applying the theme from light, dark, and system appearance modes.
- Test uninstall while the theme is active.