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

# Estrutura da pasta

> Todos os arquivos que um script novo recebe, como eles se organizam e o que cada um controla.

Todo script do DoglyTdc é um **repositório** com branches, commits e versões. Quando você cria um script (pelo painel ou pela IA com `create_script`), ele já nasce com esta pasta:

```text theme={null}
meu-script/
├── doglytdc.json               dados do script (nome, categoria, acesso, versão)
├── README.md                   o que aparece em "Abrir detalhes"
├── SKILL.md                    guia que a IA lê antes de mexer no script
├── docs/
│   ├── CARD.md                 guia do card, popup e botão
│   ├── POPUP.md                guia do popup
│   └── usage/*.md              páginas extras de uso (opcional)
├── src/                        o código que roda na página
│   ├── script.js               entrada
│   └── ui/
│       ├── theme.js            cores, cantos, fonte
│       ├── styles.js           CSS gerado do tema
│       ├── button.js           botão flutuante
│       ├── popup.js            janela do script
│       └── card.js             blocos dentro do popup
├── ui/site/                    como o script aparece no site
│   ├── card.html               cartão do script na lista
│   ├── popup.html              tela de detalhes
│   ├── styles.css              estilo desses dois
│   └── actions.json            botões com @ (copiar, instalar…)
├── painel-dev/                 o Painel Dev do script (só o dono)
│   ├── painel.json             menu
│   ├── inicio.json             partes do Início
│   ├── funcoes/<id>/           funções com tela própria
│   ├── traducoes/<idioma>.json traduções
│   └── componentes.md · icones.md · SKILL.md
└── supabase/                   parte do servidor do script (em breve)
```

## As quatro partes

> [card] src/ — o script
>
> O que roda na página onde o script é usado. Vai no pacote publicado.

> [card] ui/site/ — a vitrine
>
> O cartão e a tela de detalhes no site do DoglyTdc. Aplicado ao fazer merge na main.

> [card] painel-dev/ — o painel do dono
>
> Menu, Início e funções do seu Painel Dev. Só você vê.

> [card] supabase/ — o servidor
>
> Em breve: esta parte ganha uma documentação própria.

## Para que serve cada arquivo

| Arquivo | O que faz | Você edita? |
| - | - | - |
| `doglytdc.json` | Nome, descrição (até 160 caracteres), categoria, plataformas, acesso, proteção, logo, entrada e versão. | Sim |
| `README.md` | Texto de "Abrir detalhes": como usar, sem revelar o sistema por trás. | Sim |
| `docs/usage/*.md` | Páginas extras de uso, mostradas junto do README. | Sim |
| `SKILL.md` | Regras para a IA. | Sim |
| `src/script.js` | Entrada. Monta botão, popup e cards num Shadow DOM. | Sim |
| `src/ui/theme.js` | Único lugar para cores e formatos do script. | Sim |
| `src/ui/*.js` | Botão, popup, card e CSS. | Sim, com cuidado |
| `ui/site/card.html` | Cartão do script na lista do site. | Sim |
| `ui/site/popup.html` | Tela de detalhes no site. | Sim |
| `ui/site/styles.css` | Estilo do cartão e da tela de detalhes. | Sim |
| `ui/site/actions.json` | Botões marcados com `@`. As ações protegidas (copiar, instalar, comprar) continuam do DoglyTdc. | Só nome e posição |
| `painel-dev/` | Painel Dev inteiro. Veja [Painel Dev](https://docs.doglytdc.dev/pt-BR/scripts/dev-panel/overview.md). | Sim |
| `supabase/` | Em breve. | — |

## O que vai no pacote publicado

| Pasta | Vai no pacote? | Quando muda no site |
| - | - | - |
| `src/` | **Sim**, junto num arquivo só, compactado e (com proteção) criptografado. | Ao publicar uma versão |
| `ui/site/` | Não | Ao fazer merge na main |
| `painel-dev/` | Não | Ao fazer merge na main |
| `README.md`, `docs/` | Não | Ao fazer merge na main |

* A entrada é sempre `src/script.js`; os arquivos usam `require("./arquivo.js")` e `module.exports`.
* O pacote final pode ter até **2 MB**. Acima disso a publicação falha com `PAYLOAD_TOO_LARGE`.

## Fluxo de trabalho

**1. Crie uma branch**

Nunca edite direto na main. Pelo MCP: `create_branch`.

**2. Edite os arquivos**

Um commit pode ter até 100 arquivos.

**3. Valide**

Painel Dev: `dev_panel_validate`. Vitrine: `validate_presentation`.

**4. Faça merge na main**

O site, os detalhes e o Painel Dev mudam na hora.

**5. Publique uma versão**

Só quando mudou algo em `src/`.

## Regras de nomes

| Item | Regra |
| - | - |
| Pasta de função do Painel Dev | Minúsculas, números e `-`, de 2 a 32 caracteres, começando com letra |
| Arquivo de tradução | Código do idioma: `pt-BR.json`, `en.json`, `fr.json` |
| Caminho de arquivo | Até 300 caracteres |
| Commit | Até 100 arquivos; mensagem de 1 a 200 caracteres |

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

> [card] [Tema, card, popup e botão](https://docs.doglytdc.dev/pt-BR/scripts/folder/interface.md)
>
> O visual do script.

> [card] [Painel Dev](https://docs.doglytdc.dev/pt-BR/scripts/dev-panel/overview.md)
>
> O painel do dono.

> [card] [Exemplo completo](https://docs.doglytdc.dev/pt-BR/scripts/folder/full-example.md)
>
> Todos os arquivos do modelo.


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