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

# Design & Theme Customization

> Personalize o visual e a experiência do seu checkout, vitrine e portal do cliente em um só lugar. Escolha temas prontos, configure tipografia e cores e aplique ajustes por seção, tudo com visualização ao vivo.

<Frame>
  <img src="https://mintcdn.com/dodopayments/vsqWNGxzquCPMqJB/images/design/general-overview.jpg?fit=max&auto=format&n=vsqWNGxzquCPMqJB&q=85&s=89f19bfb791cb903fccb3ea7127246ba" alt="Página de configurações de design com visualização ao vivo do checkout, portal do cliente e vitrine" style={{ maxHeight: '500px', width: 'auto' }} width="2880" height="1920" data-path="images/design/general-overview.jpg" />
</Frame>

<Info>
  A página de Design é o seu centro de controle para branding de todas as superfícies voltadas ao cliente: checkout, vitrine e portal do cliente. As alterações são aplicadas instantaneamente nas três áreas e são exibidas em tempo real antes de salvar.
</Info>

## Principais Destaques

1. **Central de Design Unificada** - Configure a aparência do checkout, da vitrine e do portal do cliente em uma única página.
2. **Temas Prontos** - Comece com um tema curado e personalize a partir dele.
3. **Modo Claro e Escuro** - Defina paletas de cores separadas para cada modo.
4. **Visualização ao Vivo** - Veja como suas alterações ficam no checkout, portal do cliente e vitrine antes de salvar.
5. **Substituições por Seção** - Ajuste seções individuais (checkout, vitrine, portal do cliente) sem impactar as demais.
6. **Controle Programático** - Substitua temas no momento do checkout por meio da API ou do Checkout SDK.

## Primeiros Passos

Navegue até **Configurações → Design** no seu Painel de Controle do Comerciante. A página de Design tem quatro abas:

| Aba                   | Objetivo                                                                     |
| --------------------- | ---------------------------------------------------------------------------- |
| **Geral**             | Nome da empresa, logotipo, seleção de tema e configurações avançadas globais |
| **Checkout**          | Substituir configurações de tema especificamente para a página de checkout   |
| **Vitrine**           | Substituir configurações de tema e configurar o layout da vitrine            |
| **Portal do Cliente** | Substituir configurações de tema para o portal do cliente                    |

## Configurações Gerais

A aba **Geral** controla sua identidade de marca base e o tema global.

<Frame>
  <img src="https://mintcdn.com/dodopayments/vsqWNGxzquCPMqJB/images/design/general-advanced-settings.jpg?fit=max&auto=format&n=vsqWNGxzquCPMqJB&q=85&s=00131c2a9d74d4c120bf85f588e358d8" alt="Aba Geral mostrando configurações avançadas com tipografia, cores e configuração de bordas" style={{ maxHeight: '500px', width: 'auto' }} width="2880" height="2672" data-path="images/design/general-advanced-settings.jpg" />
</Frame>

### Configuração Básica

| Configuração            | Descrição                                                                |
| ----------------------- | ------------------------------------------------------------------------ |
| **Nome da Empresa**     | O nome exibido no checkout, na vitrine e no portal do cliente            |
| **Logotipo da Empresa** | O logotipo da sua marca mostrado em todas as páginas voltadas ao cliente |
| **Tema**                | Selecione um tema pronto como ponto de partida                           |

### Configurações Avançadas

Expanda **Configurações Avançadas** para acessar controles granulares:

<Frame>
  <img src="https://mintcdn.com/dodopayments/vsqWNGxzquCPMqJB/images/design/general-color-settings.jpg?fit=max&auto=format&n=vsqWNGxzquCPMqJB&q=85&s=c09ecc738beb79cff0d130f46bb72b0a" alt="Configurações avançadas expandidas mostrando a configuração completa de cores para modos claro e escuro" style={{ maxHeight: '500px', width: 'auto' }} width="2880" height="4192" data-path="images/design/general-color-settings.jpg" />
</Frame>

#### Tipografia

| Configuração         | Opções                                  | Descrição                                           |
| -------------------- | --------------------------------------- | --------------------------------------------------- |
| **Fontes Primária**  | Qualquer fonte do Google                | Fonte principal para títulos e texto do corpo       |
| **Fonte Secundária** | Qualquer fonte do Google                | Fonte de destaque para rótulos e textos secundários |
| **Tamanho da Fonte** | `xs`, `sm`, `md`, `lg`, `xl`, `2xl`     | Tamanho base global da fonte                        |
| **Peso da Fonte**    | `normal`, `medium`, `bold`, `extraBold` | Peso padrão da fonte                                |

#### Configuração de Cores

Defina paletas de cores separadas para **Modo Claro** e **Modo Escuro**. Cada modo oferece suporte às seguintes propriedades:

| Propriedade                   | Descrição                                 |
| ----------------------------- | ----------------------------------------- |
| **Plano de Fundo Primário**   | Cor principal do plano de fundo           |
| **Plano de Fundo Secundário** | Plano de fundo secundário (abas, cartões) |
| **Texto Primário**            | Cor principal do texto                    |
| **Texto Secundário**          | Cor de texto secundário (menos destacada) |
| **Botão Primário**            | Cor de fundo do botão primário            |
| **Texto do Botão Primário**   | Cor do texto nos botões primários         |
| **Botão Secundário**          | Cor de fundo do botão secundário          |
| **Texto do Botão Secundário** | Cor do texto nos botões secundários       |
| **Borda Primária**            | Cor principal da borda                    |
| **Borda Secundária**          | Cor de borda de destaque                  |

#### Borda

| Configuração      | Descrição                                                                                                                                           |
| ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Raio da Borda** | Controla o arredondamento de campos, botões, abas e cartões (ex.: `0` para cantos retos, `8px` para cantos arredondados, `16px` para estilo pílula) |

## Temas Prontos

Dodo Payments oferece quatro temas curados. Selecione um no menu suspenso **Tema** na aba Geral para aplicar instantaneamente um design coeso ao checkout, à vitrine e ao portal do cliente.

### Dodo Pulses

O tema padrão da Dodo Payments. Detalhes em verde-limão conferem um visual energético e fresco. Tipografia sans-serif limpa com espaçamento generoso.

<Tabs>
  <Tab title="Light Mode">
    <Frame caption="Dodo Pulses in light mode">
      <img src="https://mintcdn.com/dodopayments/fsVpks_kbNisjAe1/images/design/theme-dodo-pulses-light.png?fit=max&auto=format&n=fsVpks_kbNisjAe1&q=85&s=f081086300770146c0df373b6304ea12" alt="Tema Dodo Pulses no modo claro mostrando checkout, portal do cliente e vitrine" style={{ maxHeight: '500px', width: 'auto' }} width="912" height="525" data-path="images/design/theme-dodo-pulses-light.png" />
    </Frame>
  </Tab>

  <Tab title="Dark Mode">
    <Frame caption="Dodo Pulses in dark mode">
      <img src="https://mintcdn.com/dodopayments/fsVpks_kbNisjAe1/images/design/theme-dodo-pulses-dark.png?fit=max&auto=format&n=fsVpks_kbNisjAe1&q=85&s=d2fe47c69734ccb419471609095627fe" alt="Tema Dodo Pulses no modo escuro mostrando checkout, portal do cliente e vitrine" style={{ maxHeight: '500px', width: 'auto' }} width="912" height="525" data-path="images/design/theme-dodo-pulses-dark.png" />
    </Frame>
  </Tab>
</Tabs>

### Terminal

Um tema orientado a desenvolvedores com tipografia monoespaçada e detalhes em azul royal. Cantos retos e estética técnica que combinam bem com ferramentas de desenvolvedor e produtos API-first.

<Tabs>
  <Tab title="Light Mode">
    <Frame caption="Terminal in light mode">
      <img src="https://mintcdn.com/dodopayments/fsVpks_kbNisjAe1/images/design/theme-terminal-light.png?fit=max&auto=format&n=fsVpks_kbNisjAe1&q=85&s=3e3320fc9c073ed9bf3ebe7b03bf7a3f" alt="Tema Terminal no modo claro mostrando checkout com acentos azuis e fonte monoespaçada" style={{ maxHeight: '500px', width: 'auto' }} width="912" height="526" data-path="images/design/theme-terminal-light.png" />
    </Frame>
  </Tab>

  <Tab title="Dark Mode">
    <Frame caption="Terminal in dark mode">
      <img src="https://mintcdn.com/dodopayments/fsVpks_kbNisjAe1/images/design/theme-terminal-dark.png?fit=max&auto=format&n=fsVpks_kbNisjAe1&q=85&s=dea087e1c0fad9cf7a66fc37cfbda8ac" alt="Tema Terminal no modo escuro mostrando checkout com acentos azuis e fonte monoespaçada" style={{ maxHeight: '500px', width: 'auto' }} width="912" height="526" data-path="images/design/theme-terminal-dark.png" />
    </Frame>
  </Tab>
</Tabs>

### Bumblebee

Detalhes em âmbar e dourado com estilo moderno e cantos arredondados. Visual audacioso e de alto contraste, ideal para produtos voltados ao consumidor que desejam transmitir sofisticação.

<Tabs>
  <Tab title="Light Mode">
    <Frame caption="Bumblebee in light mode">
      <img src="https://mintcdn.com/dodopayments/fsVpks_kbNisjAe1/images/design/theme-bumblebee-light.png?fit=max&auto=format&n=fsVpks_kbNisjAe1&q=85&s=e276288fe683a831d10add3f8af4eae0" alt="Tema Bumblebee no modo claro mostrando checkout com acentos âmbar" style={{ maxHeight: '500px', width: 'auto' }} width="912" height="536" data-path="images/design/theme-bumblebee-light.png" />
    </Frame>
  </Tab>

  <Tab title="Dark Mode">
    <Frame caption="Bumblebee in dark mode">
      <img src="https://mintcdn.com/dodopayments/vsqWNGxzquCPMqJB/images/design/theme-bumblebee-dark.png?fit=max&auto=format&n=vsqWNGxzquCPMqJB&q=85&s=a35df24ccd45a9acb717652ce5b5fd19" alt="Tema Bumblebee no modo escuro mostrando checkout com acentos dourados" style={{ maxHeight: '500px', width: 'auto' }} width="912" height="536" data-path="images/design/theme-bumblebee-dark.png" />
    </Frame>
  </Tab>
</Tabs>

### Bubblegum

Detalhes brincalhões em rosa e magenta com cantos totalmente arredondados. Visual moderno e acolhedor, ideal para ferramentas criativas, produtos de design e marcas de lifestyle.

<Tabs>
  <Tab title="Light Mode">
    <Frame caption="Bubblegum in light mode">
      <img src="https://mintcdn.com/dodopayments/vsqWNGxzquCPMqJB/images/design/theme-bubblegum-light.png?fit=max&auto=format&n=vsqWNGxzquCPMqJB&q=85&s=3b53c9d3c6d07ef0ff44d4c613520789" alt="Tema Bubblegum no modo claro mostrando checkout, portal do cliente e vitrine com acentos rosa" style={{ maxHeight: '500px', width: 'auto' }} width="912" height="536" data-path="images/design/theme-bubblegum-light.png" />
    </Frame>
  </Tab>

  <Tab title="Dark Mode">
    <Frame caption="Bubblegum in dark mode">
      <img src="https://mintcdn.com/dodopayments/vsqWNGxzquCPMqJB/images/design/theme-bubblegum-dark.png?fit=max&auto=format&n=vsqWNGxzquCPMqJB&q=85&s=ef4a70ff8f289715628377b0631adf25" alt="Tema Bubblegum no modo escuro mostrando checkout, portal do cliente e vitrine com acentos rosa" style={{ maxHeight: '500px', width: 'auto' }} width="912" height="536" data-path="images/design/theme-bubblegum-dark.png" />
    </Frame>
  </Tab>
</Tabs>

<Tip>
  Após selecionar um tema pronto, você pode personalizar ainda mais propriedades individuais nas Configurações Avançadas. Quaisquer propriedades não especificadas retornam aos padrões do tema.
</Tip>

## Substituições por Seção

Cada aba de seção (Checkout, Vitrine, Portal do Cliente) inclui um toggle **Substituir Tema**. Ao habilitar, você pode personalizar a aparência dessa seção de forma independente do tema global.

### Aba Checkout

<Frame>
  <img src="https://mintcdn.com/dodopayments/vsqWNGxzquCPMqJB/images/design/checkout-tab.jpg?fit=max&auto=format&n=vsqWNGxzquCPMqJB&q=85&s=a17880492490e6abe2f6b8b9e9f4680e" alt="Aba de checkout mostrando visualização completa do checkout com detalhes do produto e formulário de pagamento" style={{ maxHeight: '500px', width: 'auto' }} width="2880" height="2528" data-path="images/design/checkout-tab.jpg" />
</Frame>

Substitua tipografia, cores e configurações de borda especificamente para a experiência de checkout. A visualização ao vivo mostra:

* Informações do produto e preços
* Opções de checkout expresso (Apple Pay, Google Pay)
* Seleção de método de pagamento e formulário de cartão
* Campo de código de desconto e detalhamento de preços

### Aba Vitrine

<Frame>
  <img src="https://mintcdn.com/dodopayments/vsqWNGxzquCPMqJB/images/design/storefront-tab.jpg?fit=max&auto=format&n=vsqWNGxzquCPMqJB&q=85&s=3b45fc842eb771be573ae1a5744d82c5" alt="Aba de vitrine mostrando URL da loja, controles de branding e visualização da vitrine" style={{ maxHeight: '500px', width: 'auto' }} width="2880" height="2528" data-path="images/design/storefront-tab.jpg" />
</Frame>

Configure as configurações específicas da vitrine:

| Configuração             | Descrição                                                               |
| ------------------------ | ----------------------------------------------------------------------- |
| **URL da Loja**          | O endereço da sua vitrine (ex.: `store.dodopayments.com/your-store`)    |
| **Nome da Loja**         | Ative e defina o nome exibido na vitrine                                |
| **Logotipo da Loja**     | Ative e envie um logotipo para o cabeçalho da vitrine                   |
| **Banner da Loja**       | Ative e envie uma imagem de banner                                      |
| **Descrição do Produto** | Ative para mostrar ou ocultar descrições dos produtos nos cartões       |
| **Substituir Tema**      | Habilite para personalizar tipografia, cores e bordas apenas da vitrine |

### Aba do Portal do Cliente

<Frame>
  <img src="https://mintcdn.com/dodopayments/vsqWNGxzquCPMqJB/images/design/customer-portal-tab.jpg?fit=max&auto=format&n=vsqWNGxzquCPMqJB&q=85&s=38c16ef9ed1648f0f5d3851d7c91f17c" alt="Aba do portal do cliente mostrando gerenciamento de assinaturas, histórico de pagamentos e visualização de métodos de pagamento" style={{ maxHeight: '500px', width: 'auto' }} width="2880" height="2528" data-path="images/design/customer-portal-tab.jpg" />
</Frame>

Substitua o tema do portal do cliente, que inclui:

* Gerenciamento de assinaturas
* Histórico de faturamento
* Métodos de pagamento
* Carteira e créditos

## Recursos Relacionados

<CardGroup cols={2}>
  <Card title="Checkout Features" icon="cart-shopping" href="/features/checkout">
    Recursos de checkout incluindo moeda, idioma, impostos, descontos e mais.
  </Card>

  <Card title="Overlay Checkout SDK" icon="layer-group" href="/developer-resources/overlay-checkout">
    Incorpore o checkout como uma sobreposição modal na sua página.
  </Card>

  <Card title="Inline Checkout SDK" icon="credit-card" href="/developer-resources/inline-checkout">
    Incorpore o checkout diretamente no layout da sua página.
  </Card>

  <Card title="Storefront" icon="store" href="/features/storefront">
    Configure e gerencie sua vitrine personalizada.
  </Card>

  <Card title="Customer Portal" icon="user" href="/features/customer-portal">
    Portal de autosserviço para assinaturas e faturamento.
  </Card>

  <Card title="Multi-Brand Setup" icon="building-columns" href="/features/multi-brands">
    Gerencie múltiplas marcas em uma conta com branding separado.
  </Card>
</CardGroup>
