> For the complete documentation index, see [llms.txt](https://docs.caf.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.caf.io/caf-sdk/caf-sdk-pt-br/react-native/captura-inteligente-de-documentos/personalizacao-de-cores.md).

# Personalização de cores

As cores do Smart Capture são personalizadas em duas camadas, e ambas se aplicam ao mesmo tempo no iOS. No Android, os mesmos papéis visuais existem como recursos de cor — não há uma API de cores em TypeScript para essa plataforma.

{% hint style="warning" %}
Em React Native:

* Android: declare cores com o mesmo ID de recurso em `android/app/src/main/res/values/colors.xml`. `colorCustomization` em `CerttaSmartCaptureConfiguration` é ignorado.
* iOS: passe strings hex em TypeScript — `colorConfiguration` em `configureSDK(...)` para funções compartilhadas, `colorCustomization` em `open(...)` para tokens do Smart Capture.
  {% endhint %}

{% tabs %}
{% tab title="Android" %}

### Visão geral

As cores do Smart Capture são declaradas como recursos de cor regulares do Android. Para restilizar o fluxo, declare uma cor com o mesmo nome no arquivo `res/values/colors.xml`. Veja Personalização para entender como a substituição de recursos funciona.

A paleta tem três grupos:

1. **Funções compartilhadas**: os mesmos nomes do iOS `CafColorConfiguration`.
2. **Tokens do Smart Capture**: os mesmos nomes do iOS `CerttaSmartCaptureColorCustomization`.
3. **Outras cores**: lidas diretamente pelo SDK e não cobertas por uma função ou token.

### API

| Mecanismo                      | Onde                                         | Descrição                                       |
| ------------------------------ | -------------------------------------------- | ----------------------------------------------- |
| Substituição de recurso de cor | `android/app/src/main/res/values/colors.xml` | Declare um `<color>` com o mesmo `nome` do SDK. |

Substitua uma função ou token para alterar apenas esse uso.

```xml
<!-- android/app/src/main/res/values/colors.xml -->
<resources>
    <color name="certta_sc_primary_color">#0057D8</color>

    <!-- Cada texto em todas as telas, exceto a tela do método de validação (essa usa content_color) -->
    <color name="certta_sc_text_primary">#1A1F2E</color>
</resources>
```

As cores aceitam `#RGB`, `#ARGB`, `#RRGGBB`, `#AARRGGBB` (alpha primeiro) ou uma referência como `@color/my_brand_blue`.

### Adicionando suas cores

1. Crie ou reutilize `colors.xml` no módulo do app Android.
2. Adicione apenas os nomes que você quer substituir. Os nomes omitidos mantêm a linha de base do SDK.
3. Recompile o app. Seus recursos substituem automaticamente os padrões do SDK.

### Ordem de resolução

Para cada cor, o Android resolve nesta ordem:

1. A cor do seu app com esse ID de recurso.
2. A própria cor do SDK para esse ID.

Substituições parciais são suportadas e recomendadas.

### Funções compartilhadas

Os mesmos nomes do `CafColorConfiguration` / RN `colorConfiguration`, então uma paleta pode ser compartilhada entre plataformas — no Android como recursos, no iOS como TypeScript.

| ID do recurso                       | Padrão    | Usado por                                                                                                                                                                                    |
| ----------------------------------- | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `certta_sc_primary_color`           | `#00A54B` | Preenchimento de um botão primário habilitado (por meio de `certta_sc_primary_button_color_selector`                                                                                         |
| `certta_sc_secondary_color`         | `#150A5C` | botão "Tirar outra foto" na Pré-visualização (estilo `CerttaPreviewRetakeButton`)                                                                                                            |
| `certta_sc_content_color`           | `#353535` | Títulos e textos dos cards na tela do método de validação. Todas as outras telas usam `certta_sc_text_primary`                                                                               |
| `certta_sc_background_color`        | `#FFFFFF` | Fundo da tela de Pré-visualização e Sucesso, e o rodapé atrás dos botões                                                                                                                     |
| `certta_sc_medium_color`            | `#D1D1D1` | Preenchimento de um botão primário desabilitado (por meio de `certta_sc_primary_button_color_selector`) e os divisores acima dos botões do rodapé em Instruções e Permissão de câmera negada |
| `certta_sc_dialog_background_color` | `#FFFFFF` | Fundo das folhas inferiores: Ajuda da câmera e a confirmação de remoção do arquivo (por meio de `certta_sc_bottom_sheet_background`)                                                         |
| `certta_sc_dialog_border_color`     | `#A8A8A8` | Borda dos cards na tela do método de validação (por meio de `certta_sc_validation_type_card_background`)                                                                                     |

### Tokens do Smart Capture

Os mesmos nomes do `CerttaSmartCaptureColorCustomization` / RN `colorCustomization` (mapeado para `certta_sc_*` snake\_case).

| ID do recurso                        | Padrão      | Usado por                                                                                                                                                                                                                    |
| ------------------------------------ | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `certta_sc_primary_button_text`      | `#003D1C`   | Rótulo de um botão primário habilitado ou pressionado (por meio de `certta_sc_primary_button_text_color_selector`)                                                                                                           |
| `certta_sc_accent`                   | `#150A5C`   | Texto dos botões secundários (Pular dicas, Anexar documento em Ajuda da câmera, Excluir na folha de remoção) e do botão tracejado Anexar documento em Envio. As bordas desses botões são fixas (`#150A5C`) e não seguem isso |
| `certta_sc_text_primary`             | `#353535`   | Títulos, descrições, chips e nomes de arquivos em todas as telas, exceto Método de validação                                                                                                                                 |
| `certta_sc_text_secondary`           | `#585858`   | Rótulos de arquivo e o título do estado vazio em Envio, a mensagem na folha de remoção, a dica em Ajuda da câmera e o rótulo de um botão primário desabilitado                                                               |
| `certta_sc_warning_foreground`       | `#493204`   | Texto do banner de erro na câmera e dos banners de erro em Envio                                                                                                                                                             |
| `certta_sc_warning_background`       | `#FEF6E7`   | Preenchimento dos banners de erro (por meio de `certta_sc_camera_error_background_drawable`)                                                                                                                                 |
| `certta_sc_warning_border`           | `#795306`   | Borda dos banners de erro (por meio de `certta_sc_camera_error_background_drawable`)                                                                                                                                         |
| `certta_sc_warning_icon`             | `#DA950B`   | Cor do triângulo de aviso nos banners de erro (por meio de `certta_sc_alert_triangle_icon`)                                                                                                                                  |
| `certta_sc_success`                  | `#30B814`   | Tom do indicador de progresso quando uma captura ou envio é validado, logo antes de o ícone de check aparecer                                                                                                                |
| `certta_sc_camera_overlay`           | `#80FFFFFF` | Preenchimento da máscara do documento desenhada sobre a câmera enquanto a captura automática detecta um documento                                                                                                            |
| `certta_sc_camera_chrome_background` | `#000000`   | Plano de fundo do quadro congelado na Câmera                                                                                                                                                                                 |
| `certta_sc_camera_chrome_foreground` | `#FFFFFF`   | Texto da cápsula de instrução na Câmera e o contorno da máscara do documento                                                                                                                                                 |

{% hint style="info" %}
`certta_sc_content_color` e `certta_sc_text_primary` têm o mesmo padrão, e o mesmo vale para `certta_sc_secondary_color` e `certta_sc_accent`. São recursos separados porque correspondem a duas propriedades distintas do iOS. Se você quiser a mesma cor de texto em todo lugar, substitua ambos
{% endhint %}

Não há `certta_sc_error` no conjunto de recursos do Android para o ícone de falha no envio da forma que o iOS expõe `error` — esse tom é coberto por drawables / outros tokens. Prefira a tabela acima.

### Outras cores

Lido diretamente pelo SDK e não coberto por uma função ou token.

| ID do recurso           | Padrão      | Usado por                                                                  |
| ----------------------- | ----------- | -------------------------------------------------------------------------- |
| `certta_sc_color_scrim` | `#CC000000` | Plano de fundo da caixa de diálogo de pré-visualização do arquivo em Envio |

### Cores que seguem uma função

Alguns drawables leem suas cores dos recursos acima, então uma substituição de cor os alcança sem substituir o drawable. As bordas dos botões secundário e de anexar não estão nesta lista: elas são fixas (`#150A5C`), assim como os outros drawables abaixo.

| Drawable                                     | Segue                                                                            |
| -------------------------------------------- | -------------------------------------------------------------------------------- |
| `certta_sc_preview_retake_button_background` | Borda: `certta_sc_secondary_color`                                               |
| `certta_sc_bottom_sheet_background`          | Preenchimento: `certta_sc_dialog_background_color`                               |
| `certta_sc_validation_type_card_background`  | Borda: `certta_sc_dialog_border_color`                                           |
| `certta_sc_camera_error_background_drawable` | Preenchimento: `certta_sc_warning_background`; borda: `certta_sc_warning_border` |
| `certta_sc_alert_triangle_icon`              | Preenchimento: `certta_sc_warning_icon`                                          |

### Cores que não são recursos

Algumas cores são literais dentro dos arquivos drawable, então `colors.xml` não pode alterá-las. Substitua o drawable em vez disso ([veja Imagens](https://docs.caf.io/caf-sdk/caf-sdk-pt-br/react-native/captura-inteligente-de-documentos/personalizacao-de-imagens.md)).

* O preenchimento branco e a borda (`#150A5C`) de `certta_sc_secondary_button_background` e `certta_sc_attach_button_background`, e o preenchimento branco de `certta_sc_preview_retake_button_background`.
* O preenchimento de `certta_sc_instructions_hint_background` (`#D1D1D1`), `certta_sc_camera_hint_drawable` (`#1B1B1B`) e `certta_sc_bottom_sheet_drag_handle` (`#A8A8A8`), e os pontos em `certta_sc_dot_selector`.
* Os ícones: `certta_sc_arrow_left`, `certta_sc_eye`, `certta_sc_trash`, `certta_sc_ic_help` e os botões de fechar (`#353535`); `certta_sc_validation_type_camera`, `certta_sc_validation_type_upload` e `certta_sc_close_icon` (`#150A5C`); as ilustrações de sucesso e dica (verdes como `#30B814`); e os estados do botão do obturador.

{% hint style="warning" %}
Se você der às telas um fundo escuro (`certta_sc_background_color`), os ícones acima mantêm suas cores escuras e os preenchimentos brancos dos botões permanecem brancos. Substitua esses drawables também, ou mantenha os fundos claros padrão.
{% endhint %}

### Seletores de estado da lista de botões

Dois botões usam um `seletor de` cor (lista de estados) em vez de uma única cor plana, para que os estados pressionado/habilitado/desabilitado possam ser diferentes. Substitua a função ou token para o qual eles apontam para um ajuste mais sutil, ou substitua o arquivo inteiro do seletor com o mesmo nome para mudar como um botão reage ao estado.

| ID do recurso                                  | Descrição                                 | Aponta para                                                                               |
| ---------------------------------------------- | ----------------------------------------- | ----------------------------------------------------------------------------------------- |
| `certta_sc_primary_button_color_selector`      | Cor de fundo do botão primário por estado | Desabilitado: `certta_sc_medium_color`. Caso contrário: `certta_sc_primary_color`         |
| `certta_sc_primary_button_text_color_selector` | Cor do texto do botão primário por estado | Desabilitado: `certta_sc_text_secondary`. Caso contrário: `certta_sc_primary_button_text` |

### Acessibilidade

Verifique o contraste após substituir. Em particular, `certta_sc_primary_button_text` contra `certta_sc_primary_color`e `certta_sc_warning_foreground` contra `certta_sc_warning_background`. Os padrões são compatíveis; uma substituição parcial pode quebrar a combinação.<br>
{% endtab %}

{% tab title="iOS" %}

### Visão geral

As cores do Smart Capture são personalizadas em duas camadas, e ambas se aplicam ao mesmo tempo. No React Native, ambas as camadas são strings hexadecimais de TypeScript.

* **Funções compartilhadas:** `CafColorConfiguration` (`colorConfiguration` em `configureSDK`). Sete funções do sistema de design compartilhadas com Face Liveness e Document Detector.
* **Tokens do Smart Capture:** `CerttaSmartCaptureColorCustomization` (`colorCustomization` em `open()`). Treze cores que existem apenas no fluxo do Smart Capture.

Todos os campos nas duas camadas são opcionais. Um campo que você deixar sem definir mantém a linha de base do SDK.

Chame `configureSDK` antes de `open()`. As funções compartilhadas são aplicadas na sessão ativa.

### API

| Camada                  | TypeScript                                                  | Onde                                |
| ----------------------- | ----------------------------------------------------------- | ----------------------------------- |
| Funções compartilhadas  | `colorConfiguration?: CafColorConfiguration`                | `useCerttaSdk().configureSDK(...)`  |
| Tokens do Smart Capture | `colorCustomization?: CerttaSmartCaptureColorCustomization` | `useCerttaSmartCapture().open(...)` |

Strings hexadecimais: `#RGB`, `#RRGGBB` ou `#AARRGGBB` (alpha primeiro). Uma string de qualquer outro comprimento, ou que não seja analisada, renderiza silenciosamente como preto.

```typescript
import {
  useCerttaSdk,
  useCerttaSmartCapture,
  CafEnvironment,
  CerttaAcceptedDocumentType,
  type CerttaSmartCaptureConfiguration,
} from '@caf.io/react-native-sdk';

const { configureSDK } = useCerttaSdk();
const { open } = useCerttaSmartCapture();

await configureSDK({
  mobileToken: '<MOBILE_TOKEN>',
  userId: '<USER_ID>',
  environment: CafEnvironment.PROD,
  securityEnabled: true,
  colorConfiguration: {
    primaryColor: '#1B5E20',
    secondaryColor: '#0D2818',
    contentColor: '#212121',
    backgroundColor: '#FFFFFF',
    mediumColor: '#E0E0E0',
    dialogBackgroundColor: '#FFFFFF',
    dialogBorderColor: '#BDBDBD',
  },
});

const config: CerttaSmartCaptureConfiguration = {
  acceptedDocuments: [
    CerttaAcceptedDocumentType.IDENTITY_CARD,
    CerttaAcceptedDocumentType.DRIVER_LICENSE,
  ],
  colorCustomization: {
    primaryButtonText: '#FFFFFF',
    accent: '#1B5E20',
    textPrimary: '#212121',
    textSecondary: '#595959',
    error: '#B81C1C',
    warningBackground: '#FFF7E0',
    warningBorder: '#FAC230',
    warningIcon: '#CC9100',
    warningForeground: '#332600',
    success: '#1B5E20',
    cameraOverlay: '#73FFFFFF',
    cameraChromeBackground: '#000000',
    cameraChromeForeground: '#FFFFFF',
  },
};

await open(config);
```

### Adicionando suas cores

1. Defina funções compartilhadas em `configureSDK` quando quiser que elas se apliquem aos produtos Certta.
2. Passe apenas os tokens do Smart Capture que você quer alterar em `open()`.
3. Campos omitidos mantêm a linha de base do SDK.

#### Personalização parcial

```typescript
const config: CerttaSmartCaptureConfiguration = {
  acceptedDocuments: [CerttaAcceptedDocumentType.IDENTITY_CARD],
  colorCustomization: {
    accent: '#4F46E5',
    cameraOverlay: '#4DFFFFFF',
  },
};

await open(config);
```

### Ordem de resolução

Para cada token:

1. O valor que você definiu em `colorCustomization` / `colorConfiguration`.
2. A linha de base do Smart Capture para esse token/função (não um padrão global do sistema de design).

As cores são aplicadas quando o fluxo começa e são redefinidas quando ele termina. Cada sessão substitui as cores da sessão anterior como um todo, em vez de mesclá-las.

Uma string hex vazia em uma `CafColorConfiguration` função é tratada como não definida e volta para a linha de base do Smart Capture.

### Funções compartilhadas

Essas sete funções vêm de `CafColorConfiguration` e são compartilhadas entre os produtos CAF. O Smart Capture volta para sua própria linha de base para qualquer função que você deixar sem definir.

| Campo em TS             | Padrão do Smart Capture            | Onde aparece                                            |
| ----------------------- | ---------------------------------- | ------------------------------------------------------- |
| `primaryColor`          | `#00A54B`                          | Preenchimento dos botões primários de chamada para ação |
| `secondaryColor`        | `#012D1F`                          | Superfícies secundárias e elementos de apoio            |
| `contentColor`          | `#323232` claro / `#CDCDCD` escuro | Conteúdo do corpo que segue a aparência do sistema      |
| `backgroundColor`       | `#FCFCFC`                          | Fundo da tela fora da câmera                            |
| `mediumColor`           | `#D1D1D1`                          | Divisórias, separadores e contornos neutros             |
| `dialogBackgroundColor` | `#FCFCFC`                          | Folhas inferiores e o cartão do método de validação     |
| `dialogBorderColor`     | `#A8A8A8`                          | Borda dessas folhas e cartões                           |

### Tokens do Smart Capture

Todos os treze tokens são strings opcionais e padrão para não definidos. A coluna Padrão é a cor que o Smart Capture usa quando o token é omitido.

| Campo em TS              | Padrão                      | Onde aparece                                                                                       |
| ------------------------ | --------------------------- | -------------------------------------------------------------------------------------------------- |
| `primaryButtonText`      | `#0B2905`                   | Rótulo da CTA primária. O preenchimento do botão vem de `primaryColor`                             |
| `accent`                 | `#150A5C`                   | Ações secundárias e de link, borda tracejada de anexo, tom do ícone do método de validação         |
| `textPrimary`            | `#353535`                   | Título/descrição de falha no envio, chip de documentos aceitos, nome do arquivo do slot preenchido |
| `textSecondary`          | `#585858`                   | Rodapé da Ajuda da câmera, título do estado vazio e rótulos de arquivo na revisão de envio         |
| `error`                  | `#E5114A`                   | Tom do ícone grande na tela de falha no envio                                                      |
| `warningBackground`      | `#FEF6E7`                   | Vista de aviso na câmera e banner de aviso na revisão de envio                                     |
| `warningBorder`          | Âmbar                       | Borda do banner de aviso da revisão de envio                                                       |
| `warningIcon`            | Âmbar escuro                | Tom do ícone do banner de aviso                                                                    |
| `warningForeground`      | Preto                       | Tom do texto e do botão dentro do aviso na câmera, texto de aviso no envio                         |
| `success`                | Verde                       | Tom do ícone de check em um slot de envio preenchido                                               |
| `cameraOverlay`          | Branco com 50% de opacidade | Preenchimento da máscara de captura automática. O traço vem de `cameraChromeForeground`            |
| `cameraChromeBackground` | Preto                       | Fundo da câmera, cápsula de instrução, flash do obturador                                          |
| `cameraChromeForeground` | Branco                      | Texto da instrução, tom do botão de ajuda, traço do retângulo de captura automática                |

`warningBorder`, `warningIcon`, `success` e `cameraOverlay` têm linhas de base definidas em RGB em vez de hex.

### O que não pode ser personalizado

Alguns elementos ainda são fixos e não podem ser acessados por nenhuma das camadas:

* O separador na folha de ajuda da câmera.
* Os pontos de controle de página no carrossel de instruções.
* O chrome da pré-visualização de envio e seu fundo de PDF.
* A descrição do estado vazio na revisão de envio.
* Os tons dos ícones de pré-visualização e exclusão em um slot de envio.

Fontes e espaçamento não são personalizáveis. Se você substituir uma imagem, as imagens únicas personalizadas são renderizadas como fornecidas e não recebem tom desses tokens de cor — veja Personalização de Imagem.

### Acessibilidade

Verifique o contraste após substituir. Em particular, `primaryButtonText` contra o `primaryColor` preenchimento, e `warningForeground` contra `warningBackground`. Os padrões são compatíveis; uma substituição parcial pode quebrar silenciosamente a combinação porque os dois valores vêm de camadas diferentes.
{% endtab %}
{% endtabs %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.caf.io/caf-sdk/caf-sdk-pt-br/react-native/captura-inteligente-de-documentos/personalizacao-de-cores.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
