Theme authoring

How to preview and export a Codex theme without editing CSS

Use adapter-supported media controls and representative UI scenes to create a private, inspectable Codex theme package in the browser.

Updated

Use only adapter-supported controls

The current macOS adapters accept local image/video, finite ripple and directional-atlas backgrounds together with their allowlisted position, scrim, blur and fallback controls. Studio locks native colors, fonts, radii, spacing and component layout instead of presenting controls the runtime cannot truthfully apply.

Preview representative states

A theme that works on an empty home screen may fail around code, diffs, status badges or settings. Review every available scene and check focus, error and selection states.

  • Task and composer
  • Terminal and code
  • Added and removed diff lines
  • Settings and secondary text

Export an inspectable package

The archive records the target application, platform and version, declares included files and hashes their contents. Reopen it in Studio before sharing to confirm the same preview is restored.

Frequently asked questions

Does a .cctheme package contain JavaScript?

No. CC Theme exports declarative theme data and allowlisted local media, not executable theme scripts.

Can I reopen an exported package?

Yes. A valid .cctheme archive can be imported back into Studio for inspection and editing.