> ## 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 y botón

> Cómo funciona y cómo cambiar la interfaz lista del script.

El script ya nace con una interfaz lista: un **botón** flotante que abre un **popup**, y dentro de él **cards**. Todo vive en un Shadow DOM, así que el CSS del sitio no entra y el tuyo no se filtra.

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

Es el único lugar para cambiar colores y formas. El editor visual del panel guarda este archivo en un 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` (Oscuro puro), `custom` (Personalizado) |
| `colors` | `bg`, `surface`, `text`, `muted`, `accent`, `accent2`, `border` |
| `radius` | Esquinas en píxeles |
| `font` | Fuente CSS |
| `card.style` | `glass`, `solid` o `outline` |
| `popup.position` | `center`, `right` o `bottom` |
| `popup.width` | De 280 a 640 |
| `button.shape` | `pill`, `rounded` o `square` |
| `button.position` | `bottom-right`, `bottom-left` o `top-right` |
| `button.label` | Texto del botón |

## Crear un card

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

## Popup

`createPopup(root, { title })` devuelve `{ body, open(), close(), toggle() }`. Para cambiar de pantalla, límpialo con `popup.body.replaceChildren()` y arma los cards de nuevo. El popup tiene `role="dialog"`, `aria-modal`, enfoca el botón Cerrar al abrirse y se cierra con Esc.

## window\.DoglyScript

En la página, DoglyTdc le entrega al script:

| Campo | Qué es |
| - | - |
| `version` | Versión que se está ejecutando |
| `config` | Configuración remota que editas en el panel (sin publicar una versión nueva) |
| `reportError(err)` | Envía el error a la pestaña Errores del panel |

La plantilla usa `config.welcome` como texto del primer card, si defines esa clave en la configuración remota.

## No lo rompas

* Mantén todo dentro del Shadow DOM (`root`).
* Usa `textContent`, nunca `innerHTML` con texto del sitio.
* Las clases empiezan con `dts-`.
* Respeta `prefers-reduced-motion`.


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