> ## Documentation Index
> Fetch the complete documentation index at: https://docs-loja.usecorvex.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# color_scheme

> Field type color_scheme — referência ao esquema global de cores do tema.

# `color_scheme`

| | |
| - | - |
| **type** | `color_scheme` |
| **Valor salvo** | `string` — **ID** do esquema em `color_schemes[]` (ex.: `"scheme-light"`) |
| **Obrigatório** | `id`, `type` |

## Propriedades OPTIONAL

`label` (recomendado no inspetor; o validador não exige), `default`, `info`

O valor gravado é o `id` do esquema (`onChange(scheme.id)`). Se `color_schemes` estiver vazio, o inspetor não oferece escolha e pede o arquivo de settings.

## Pré-requisito

Declare esquemas em `config/settings.schema.json`:

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "color_schemes": [
    {
      "id": "scheme-light",
      "label": "Claro",
      "settings": {
        "color_primary": "#7c3aed",
        "color_background": "#ffffff"
      }
    }
  ],
  "groups": [
    {
      "name": "Esquema",
      "settings": [
        {
          "id": "color_scheme",
          "type": "color_scheme",
          "label": "Esquema global",
          "default": "scheme-light"
        }
      ]
    }
  ]
}
```

## Runtime

A section recebe o **ID do esquema**, não o objeto completo:

```jsx theme={"theme":{"light":"github-light","dark":"github-dark"}}
settings.color_scheme // "scheme-light"
```

Para cores resolvidas, leia `theme settings` via hooks do SDK ou props de layout — o field type só persiste a referência.

## Onde usar

* Theme settings (`groups[].settings[]`) — esquema global da loja
* Section settings — section pode escolher qual esquema aplicar localmente


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