Create a Codex Desktop theme

Start visually

Import a local image to generate four curated visual directions from its luminance, dominant color, accent, and contrast. Then refine layout, icon treatment, details, surfaces, radius, motion, and companion placement in the live preview.

A theme is data, not code

A .codex-styler-theme package contains theme.json, local PNG, JPEG, or WebP assets, and LICENSES.json. JavaScript, remote URLs, SVG, video, arbitrary CSS, and executable fonts are rejected.

The compact appearance colors generate a complete accessible palette for surfaces, controls, interaction states, code, diffs, terminals, charts, and status feedback. Advanced packages may override stable semantic roles without depending on Codex CSS variables.

Use the checked-in JSON Schema and the theme validation command before sharing a package.

Design for restoration

Keep the workspace readable when the background fails or motion is reduced. Every theme must provide light and dark variants and remain usable in isolated safe mode.