> ## Documentation Index
> Fetch the complete documentation index at: https://recircles.rekosk.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Palette fields and defaults

> Look up every ring, capsule, text, and accent color in the default Amber palette, plus the theme IDs you can select in your launcher configuration.

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

| Key | Amber | What it colors |
| - | - | - |
| `ring.top` | `#422614` | Top of the ring surface |
| `ring.mid` | `#26160d` | Middle of the surface gradient |
| `ring.bottom` | `#2e1a0f` | Bottom of the surface |
| `ring.rim_top` | `#ffd19e` | Top highlight on the rim |
| `ring.rim_bottom` | `#f59447` | Bottom of the rim |
| `ring.divider` | `#ffd6ad` | Lines between sectors |
| `ring.shadow` | `#030100` | Shadow around the 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.

| Key | Amber | What it colors |
| - | - | - |
| `capsule.top` | `#362114` | Top of the search capsule |
| `capsule.bottom` | `#21130d` | Bottom of the capsule |
| `capsule.border` | `#ffd1a8` | Capsule outline |
| `text.primary` | `#fff7f0` | Primary labels |
| `text.capsule` | `#fff5eb` | Text in the capsule |
| `text.suggestion` | `#d7b9a4` | Suggested completion |
| `text.shadow` | `#090402` | Shadow behind text |

## Accents

| Key | Amber | Used for |
| - | - | - |
| `accents.files` | `#ff9e47` | Files |
| `accents.apps` | `#ffc75c` | Applications |
| `accents.windows` | `#ff7a57` | Alt-Tab |
| `accents.wifi` | `#5cd6b3` | Wi-Fi |
| `accents.bluetooth` | `#6ba8ff` | Bluetooth |
| `accents.custom` | `#ffb86b` | Custom menus and Settings |
| `accents.action` | `#fa8f5c` | Action items |

## Named themes in recircles.json

| Settings label | `colors.theme` |
| - | - |
| Amber (Default) | `default` |
| Light Green | `light_green` |
| Forest | `forest` |
| Midnight Blue | `midnight` |
| Rose Quartz | `rose` |
| Amethyst | `violet` |
| Monochrome | `monochrome` |

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.

```json theme={null}
{
  "colors": {
    "theme": "forest",
    "accents": { "files": "#ffae72" }
  }
}
```

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`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.