Skip to main content
A ReCircles theme file accepts ring, capsule, text, and accents as top-level groups or inside a colors object. Use one form per file. Most omitted fields use the default Amber values listed below. Colors are strings such as "#ffd19e" or "#fc9". The leading # is optional. Use name (alias title) for the display name. Without it, copper-dusk.json appears as Copper Dusk.

Ring

Capsule and text

If your theme file supplies a ring group and omits the entire capsule group, the capsule takes its top, bottom, and border from ring.top, ring.bottom, and ring.rim_top. Supply a capsule group to choose these colors independently.

Accents

Named themes in recircles.json

You can use a named theme as a base in recircles.json and override just one field. This example keeps Forest’s surfaces and changes the Files accent.
If you edit a generated configuration that already contains every color field, ReCircles loads the named palette in full. To preserve individual overrides, shorten colors to the theme ID and the fields you want to override. To use a complete hand-edited palette as written, remove the theme key from colors.