FIELD NOTE / 01
Submit your theme
Put your theme in a public GitHub repository with colors.toml at the root, then choose Submit a theme in the header, or press ⌘K (Ctrl K) and pick Submit a theme. Paste the repository URL and submit. No account is needed.
- The gallery pins your repository to its current commit and reads
colors.tomlas data. Nothing in the repository is run. - The palette, description and tags are checked automatically. Anything unclear goes to a person instead of being approved.
- You get a private receipt link. Keep it: it is the only way to check the status of that submission.
- Once approved, the theme appears in the gallery with an install command that points at your repository.
Before you submit, run through the publishing checklist: a licence GitHub recognises, a README with background credits, and a real install test from the URL.
FIELD NOTE / 02
Keep your listing current
A listing is pinned to one commit, so pushing to GitHub does not change it by itself. When you have pushed changes, open your theme in the gallery and choose “Update from GitHub”. The gallery checks your default branch and, if there is a newer commit, inspects it exactly as it did your first submission.
Submitting the same repository again does the same thing: it updates the existing listing to the latest commit rather than creating a second one. You never need to delete and resubmit, and a theme never appears twice.
- What updates: the palette, configuration, description, tags and pinned commit.
- What stays: the listing’s name and author, its ratings, saves and desktop trial counts.
- If the new commit fails inspection, the version already listed stays live and unchanged.
- Each listing can be checked once every 15 minutes.
FIELD NOTE / 03
New images are reviewed first
A repository licence covers the palette, but not necessarily every image in the repository. So new backgrounds and screenshots, whether from a first submission or an update, are held privately until a person has reviewed the rights to show them. Until then the listing shows your colours with the images already approved.
Credit your images in the README, and say if they are licensed differently from the palette. It makes the review quick. See Backgrounds for the licensing question in full.