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

# Translations, icons and validation

> Dev panel languages, the icon list and how to validate the painel-dev/ folder before applying it.

## Translations

One file per language in `painel-dev/traducoes/`. The name is the language code: `pt-BR.json`, `en.json`, `es.json`, `fr.json`, `ja.json`…

```json painel-dev/traducoes/en.json theme={null}
{
  "@lang": "English",
  "nav.sales": "Sales",
  "aviso.titulo": "Notices",
  "comum.salvar": "Save"
}
```

| Rule | Limit |
| - | - |
| `@lang` | Language name, up to 30 characters |
| Key | Lowercase, numbers, `_`, `.` and `-`, up to 80 |
| Text | Up to 400 characters |
| Texts per language | 800 |
| Languages | 10 |

### Use a translation

Write `@t.key` in any text: `label`, `group`, `welcome`, screen titles and paragraphs.

```html theme={null}
<h2>@t.aviso.titulo</h2>
<dt-button action="@save" label="@t.comum.salvar" />
```

The final text follows this order: chosen language → Portuguese (BR) → the key itself.

### Extra language

Create the file (e.g. `fr.json` with `"@lang": "Français"`). It shows up by itself in the Dev panel language choice. The **Translations** screen shows, for each language, the keys missing compared with Portuguese (BR).

## Icons

Use the names below in `icon` (menu, `dt-stat`, `dt-alert`, `dt-button`). Any other name is an error.

```text theme={null}
home code rocket users user wallet bot webhook server settings languages monitor globe key lock shield
database activity chart bar-chart pie-chart trending bell mail message megaphone calendar clock history star
heart flag tag ticket gift shopping-bag credit coins percent package box layers folder file book bookmark
list grid table sliders palette brush image video music camera zap sparkles wand target trophy gamepad
terminal cpu cloud download upload link search filter refresh play pause power eye trash plus check
alert info help map pin phone smile crown graduation briefcase store truck puzzle
```

The same list is in `painel-dev/icones.md`, for the AI.

## Validation

**1. Validate a branch**

`dev_panel_validate` with `script_id` and `ref` (branch or commit). It applies nothing.

**2. Read the errors**

Each error has `path` (file) and `message` (reason).

**3. Apply**

Merge into main. `dev_panel_get` shows `applied_sha` (version in use) and the errors of the last check.

### Common errors

Validator messages are in Portuguese; the table shows them as they appear.

| Message | How to fix |
| - | - |
| `@nav.id deve ser "cupons"` | The `@nav` `id` must match the folder name |
| `ícone desconhecido "x"` | Use a name from the list above |
| `posição deve ser inteiro de 1 a 999` | E.g. `"position": 45`, without quotes |
| `funções do menu não podem ser apagadas aqui` | Remove `hidden`/`remove`/`delete`; only icon, name, group and position change |
| `bind="x" não está em connect.keys` | Add `x` to `keys` or change the `bind` |
| `Coleções são só leitura` | Use only `dt-table`, `dt-stat` and `@reload` |
| `@call só funciona com connect.type "function"` | Change the connection or use `@save` |
| `<dt-option> só dentro de <dt-select>` | Put the options inside the box |
| `Campo não editável no Início` | `inicio.json` only has `welcome`, `cards` and `shortcuts` |

> [!WARNING]
>
> With any error, the panel stays on the last valid version. Fix it, validate again and merge.

## Through the MCP

| Tool | What it does |
| - | - |
| `dev_panel_get` | Panel in use, applied version and errors |
| `dev_panel_validate` | Validates a branch or commit |
| `dev_panel_function_create` | Creates a function folder and validates |
| `get_dev_panel_guide` | Full guide for the AI |


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