Codex Dream Skin
GitHub中文

Theme contributions

Add your theme to the gallery

Themes are versioned, validated, declarative asset packages. The repository does not accept runtime scripts, remote injection code, or assets with unclear provenance.

Package allowlist

Each public theme directory may contain only these five files:

  • manifest.json
  • background.webp
  • preview-light.webp
  • preview-dark.webp
  • LICENSE.txt

Validation

The manifest must pass the version 1 JSON Schema and asset paths may not leave the theme directory. The catalog build also checks format, dimensions, symlinks, size, and source URLs.

shell
npm run catalog:build

Preview and license

Real Codex captures use screenshot; images composed or simulated for the browser preview use concept.

Include a clear license and HTTPS source. Portrait, character, or IP assets require a bilingual assetNotice, and the contributor must confirm public redistribution rights.

Pull request

  1. Branch from upstream and add one unique kebab-case theme directory.
  2. Run the catalog build and full tests, confirming a repeatable ZIP hash.
  3. Document asset provenance, license, and preview type in the PR.
  4. Merge only after visual, asset-rights, and package-boundary review.