Contribute
Request or propose a theme
Every theme in the catalog landed as a PR. Yours can too — either start from the builder or hand us a description and we'll draft one.
1. You have the theme already
Open a PR against convergent-systems-co/theme-atoms: drop a file in themes/<id>.toml, add an entry to themes/index.json, run python3 scripts/validate.py locally to confirm. CI re-validates and Cloudflare Pages auto-deploys on merge — your theme is live at theme-atoms.com/themes/<id>.toml within a minute.
2. You want to design one interactively
Open the builder. Pick a seed, tune palette + prompt + segments + separator + glyphs, hit Propose on GitHub. We get a pre-filled issue with your TOML; we review, you iterate, we merge.
3. You just want to describe what you want
File a free-form theme request — palette inspiration, vibe, references. We'll draft the TOML and tag you for review.
Acceptance criteria
- Validates against
schemas/theme-v1.json - Palette is fully inlined (single-fetch contract — no
brand-atoms://refs) - Internal color references resolve within the theme's own
[palette] - Visually distinct from existing themes
display_nameanddescriptionare present and intentional