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

# Dev panel overview

> Your script's admin panel, built from code in the painel-dev/ folder.

The **Dev panel** is your script's admin panel: code, releases, users, sales, MCP, webhook, functions and settings. It is built from the `painel-dev/` folder, which every script receives when it is created.

> [!NOTE]
>
> Only the script's **owner** sees the functions created from code and the Translations screen. Collaborators are refused on the server too, not just hidden on screen.

## The folder

```text theme={null}
painel-dev/
├── painel.json               menu: icon, name, group and position of each item
├── inicio.json               Home welcome, card order and shortcuts
├── funcoes/
│   └── avisos/               one folder per function (opens at ?tab=avisos)
│       ├── funcao.json       "@nav" + connection
│       └── tela.html         screen built with <dt-*> pieces
├── traducoes/
│   ├── pt-BR.json
│   ├── en.json
│   └── es.json
├── componentes.md            pieces guide (for you and the AI)
├── icones.md                 icon list
└── SKILL.md                  rules the AI follows when editing the panel
```

| File | What it controls | Required |
| - | - | - |
| `painel.json` | Order, name, icon and group of the menu items | No |
| `inicio.json` | Only `welcome`, `cards` and `shortcuts` on Home | No |
| `funcoes/<id>/funcao.json` | Menu item and where the data comes from | Yes, per function |
| `funcoes/<id>/tela.html` | The screen layout | Yes, per function |
| `traducoes/<lang>.json` | Texts for each language | No |

## Built-in and new functions

> [card] Built-in functions (@core)
>
> Home, Code, Releases, Users, Sales, MCP and API, Webhook, Functions, Settings and Translations (plus Installations and Discord bot for some types). They never leave the menu: only icon, name, group and position change.

> [card] New functions (@fn)
>
> Create as many as you want (up to 30). Each has its own screen, menu item and `?tab=<id>` address.

## Home

```json painel-dev/inicio.json theme={null}
{
  "welcome": "@t.home.welcome",
  "cards": ["@card:sales", "@card:users", "@card:releases", "@card:code"],
  "shortcuts": ["@fn:avisos", "@core:config"]
}
```

| Field | What it is |
| - | - |
| `welcome` | Welcome line (up to 120 characters or `@t.key`) |
| `cards` | Cards in the order you want: `@card:code`, `releases`, `users`, `discord`, `api`, `webhook`, `sales`, `config` |
| `shortcuts` | Up to 8 shortcuts: `@core:<id>` or `@fn:<id>` |

The numbers at the top of Home are fixed. Any other field is refused.

## How to apply

**1. Edit on a branch**

E.g. `new-panel`.

**2. Validate**

`dev_panel_validate` with `ref: "new-panel"`. The error list gives the file and the reason.

**3. Merge into main**

The panel changes right away. Check with `dev_panel_get` (`applied_sha`).

> [!WARNING]
>
> If the folder has any error, the panel keeps the **last valid version**. Nothing breaks for people using it.

> [card] [Menu and @nav](https://docs.doglytdc.dev/en/scripts/dev-panel/navigation.md)

> [card] [Create a function](https://docs.doglytdc.dev/en/scripts/dev-panel/create-function.md)

> [card] [Screen pieces](https://docs.doglytdc.dev/en/scripts/dev-panel/pieces.md)


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