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

# Tema, card, popup e botão

> Como funciona e como mudar a interface pronta do script.

O script já nasce com uma interface pronta: um **botão** flutuante que abre um **popup**, e dentro dele **cards**. Tudo fica num Shadow DOM, então o CSS do site não entra e o seu não vaza.

## Tema (`src/ui/theme.js`)

É o único lugar para trocar cores e formatos. O editor visual do painel grava este arquivo num commit.

```js theme={null}
// Tema do card, do popup e do botão. Único lugar para trocar cores e formatos.
// O editor visual do painel grava este arquivo num commit.
module.exports = {
  "radius": 16,
  "font": "system-ui, sans-serif",
  "card": {
    "style": "glass"
  },
  "popup": {
    "position": "center",
    "width": 380
  },
  "button": {
    "shape": "pill",
    "position": "bottom-right",
    "label": "Abrir"
  },
  "preset": "doglytdc",
  "colors": {
    "bg": "#0b0712",
    "surface": "#171022",
    "text": "#f5f3ff",
    "muted": "#a59fb8",
    "accent": "#8b5cf6",
    "accent2": "#c084fc",
    "border": "#2c2240"
  }
};
```

| Campo | Valores |
| - | - |
| `preset` | `doglytdc` (DoglyTdc), `wayground` (Wayground), `lovable` (Lovable), `dark` (Escuro puro), `custom` (Personalizado) |
| `colors` | `bg`, `surface`, `text`, `muted`, `accent`, `accent2`, `border` |
| `radius` | Cantos em pixels |
| `font` | Fonte CSS |
| `card.style` | `glass`, `solid` ou `outline` |
| `popup.position` | `center`, `right` ou `bottom` |
| `popup.width` | De 280 a 640 |
| `button.shape` | `pill`, `rounded` ou `square` |
| `button.position` | `bottom-right`, `bottom-left` ou `top-right` |
| `button.label` | Texto do botão |

## Criar um card

```js theme={null}
popup.body.appendChild(createCard({
  title: "Título",
  text: "Texto",
  actions: [{ label: "Ok", onClick() { /* ... */ } }],
}));
```

## Popup

`createPopup(root, { title })` devolve `{ body, open(), close(), toggle() }`. Para trocar de tela, limpe com `popup.body.replaceChildren()` e monte os cards de novo. O popup tem `role="dialog"`, `aria-modal`, foca o botão Fechar ao abrir e fecha no Esc.

## window\.DoglyScript

Na página, o DoglyTdc entrega ao script:

| Campo | O que é |
| - | - |
| `version` | Versão que está rodando |
| `config` | Configuração remota que você edita no painel (sem publicar versão nova) |
| `reportError(err)` | Envia o erro para a aba Erros do painel |

O modelo usa `config.welcome` como texto do primeiro card, se você definir essa chave na configuração remota.

## Não quebre

* Mantenha tudo dentro do Shadow DOM (`root`).
* Use `textContent`, nunca `innerHTML` com texto do site.
* Classes começam com `dts-`.
* Respeite `prefers-reduced-motion`.


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