> ## 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.

# Estructura de la carpeta

> Todos los archivos que recibe un script nuevo, cómo se organizan y qué controla cada uno.

Cada script de DoglyTdc es un **repositorio** con ramas, commits y versiones. Cuando creas un script (en el panel o con la IA mediante `create_script`), ya nace con esta carpeta:

```text theme={null}
mi-script/
├── doglytdc.json               datos del script (nombre, categoría, acceso, versión)
├── README.md                   lo que muestra "Abrir detalles"
├── SKILL.md                    guía que la IA lee antes de tocar el script
├── docs/
│   ├── CARD.md                 guía del card, popup y botón
│   ├── POPUP.md                guía del popup
│   └── usage/*.md              páginas extra de uso (opcional)
├── src/                        el código que se ejecuta en la página
│   ├── script.js               entrada
│   └── ui/
│       ├── theme.js            colores, esquinas, fuente
│       ├── styles.js           CSS generado del tema
│       ├── button.js           botón flotante
│       ├── popup.js            ventana del script
│       └── card.js             bloques dentro del popup
├── ui/site/                    cómo se ve el script en el sitio
│   ├── card.html               tarjeta del script en la lista
│   ├── popup.html              pantalla de detalles
│   ├── styles.css              estilo de ambos
│   └── actions.json            botones con @ (copiar, instalar…)
├── painel-dev/                 el Panel Dev del script (solo el dueño)
│   ├── painel.json             menú
│   ├── inicio.json             partes del Inicio
│   ├── funcoes/<id>/           funciones con pantalla propia
│   ├── traducoes/<idioma>.json traducciones
│   └── componentes.md · icones.md · SKILL.md
└── supabase/                   parte del servidor del script (próximamente)
```

## Las cuatro partes

> [card] src/ — el script
>
> Lo que se ejecuta en la página donde se usa el script. Va en el paquete publicado.

> [card] ui/site/ — la vitrina
>
> La tarjeta y la pantalla de detalles en el sitio de DoglyTdc. Se aplica al hacer merge en main.

> [card] painel-dev/ — el panel del dueño
>
> Menú, Inicio y funciones de tu Panel Dev. Solo tú lo ves.

> [card] supabase/ — el servidor
>
> Próximamente: esta parte tendrá su propia documentación.

## Para qué sirve cada archivo

| Archivo | Qué hace | ¿Lo editas? |
| - | - | - |
| `doglytdc.json` | Nombre, descripción (hasta 160 caracteres), categoría, plataformas, acceso, protección, logo, entrada y versión. | Sí |
| `README.md` | Texto de "Abrir detalles": cómo usarlo, sin revelar el sistema detrás. | Sí |
| `docs/usage/*.md` | Páginas extra de uso, mostradas junto al README. | Sí |
| `SKILL.md` | Reglas para la IA. | Sí |
| `src/script.js` | Entrada. Arma botón, popup y cards en un Shadow DOM. | Sí |
| `src/ui/theme.js` | Único lugar para los colores y formas del script. | Sí |
| `src/ui/*.js` | Botón, popup, card y CSS. | Sí, con cuidado |
| `ui/site/card.html` | Tarjeta del script en la lista del sitio. | Sí |
| `ui/site/popup.html` | Pantalla de detalles en el sitio. | Sí |
| `ui/site/styles.css` | Estilo de la tarjeta y de la pantalla de detalles. | Sí |
| `ui/site/actions.json` | Botones marcados con `@`. Las acciones protegidas (copiar, instalar, comprar) siguen siendo de DoglyTdc. | Solo nombre y posición |
| `painel-dev/` | Todo el Panel Dev. Ver [Panel Dev](https://docs.doglytdc.dev/es/scripts/dev-panel/overview.md). | Sí |
| `supabase/` | Próximamente. | — |

## Qué va en el paquete publicado

| Carpeta | ¿Va en el paquete? | Cuándo cambia en el sitio |
| - | - | - |
| `src/` | **Sí**, unido en un solo archivo, comprimido y (con protección) cifrado. | Al publicar una versión |
| `ui/site/` | No | Al hacer merge en main |
| `painel-dev/` | No | Al hacer merge en main |
| `README.md`, `docs/` | No | Al hacer merge en main |

* La entrada siempre es `src/script.js`; los archivos usan `require("./archivo.js")` y `module.exports`.
* El paquete final puede tener hasta **2 MB**. Por encima, la publicación falla con `PAYLOAD_TOO_LARGE`.

## Flujo de trabajo

**1. Crea una rama**

Nunca edites main directamente. Por MCP: `create_branch`.

**2. Edita los archivos**

Un commit puede tener hasta 100 archivos.

**3. Valida**

Panel Dev: `dev_panel_validate`. Vitrina: `validate_presentation`.

**4. Haz merge en main**

El sitio, los detalles y el Panel Dev cambian al instante.

**5. Publica una versión**

Solo cuando cambió algo en `src/`.

## Reglas de nombres

| Elemento | Regla |
| - | - |
| Carpeta de función del Panel Dev | Minúsculas, números y `-`, de 2 a 32 caracteres, empezando con letra |
| Archivo de traducción | Código del idioma: `pt-BR.json`, `en.json`, `fr.json` |
| Ruta de archivo | Hasta 300 caracteres |
| Commit | Hasta 100 archivos; mensaje de 1 a 200 caracteres |

> [card] [doglytdc.json](https://docs.doglytdc.dev/es/scripts/folder/doglytdc-json.md)
>
> Todos los campos.

> [card] [Tema, card, popup y botón](https://docs.doglytdc.dev/es/scripts/folder/interface.md)
>
> El aspecto del script.

> [card] [Panel Dev](https://docs.doglytdc.dev/es/scripts/dev-panel/overview.md)
>
> El panel del dueño.

> [card] [Ejemplo completo](https://docs.doglytdc.dev/es/scripts/folder/full-example.md)
>
> Todos los archivos de la plantilla.


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