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

# Menu e @nav

> Como mudar a ordem, o nome, o ícone e o grupo dos itens do Painel Dev e colocar funções novas no menu.

O menu do Painel Dev é a lista `nav` de `painel-dev/painel.json`. Cada item aponta para uma função com `@nav`:

| Marca | Aponta para |
| - | - |
| `@core:<id>` | Uma função fixa |
| `@fn:<id>` | Uma função sua, da pasta `painel-dev/funcoes/<id>/` |

## Campos de um item

| Campo | Tipo | Regra |
| - | - | - |
| `@nav` | texto | Obrigatório. `@core:<id>` ou `@fn:<id>`, sem repetir |
| `label` | texto | Até 40 caracteres ou `@t.chave` |
| `icon` | texto | Um nome da [lista de ícones](https://docs.doglytdc.dev/pt-BR/scripts/dev-panel/translations-and-validation.md#ícones) |
| `group` | texto | Título do grupo, até 32 caracteres ou `@t.chave` |
| `position` | inteiro | De 1 a 999. Menor fica mais em cima |

Qualquer outro campo é recusado. `hidden`, `remove` e `delete` dão erro: **nenhuma função do menu pode ser apagada por aqui**.

## Funções fixas

| `@core:` | Nome padrão | Ícone | Grupo | Posição |
| - | - | - | - | - |
| `home` | Início | `home` | Visão geral | 10 |
| `code` | Código | `code` | Visão geral | 20 |
| `releases` | Versões | `rocket` | Distribuição | 30 |
| `installations` | Instalações | `monitor` | Distribuição | 35 |
| `users` | Usuários | `users` | Pessoas | 40 |
| `sales` | Vendas | `wallet` | Pessoas | 50 |
| `discord` | Bot Discord | `bot` | Integrações | 55 |
| `api` | MCP e API | `bot` | Integrações | 60 |
| `webhook` | Webhook | `webhook` | Integrações | 70 |
| `backend` | Funções | `server` | Avançado | 80 |
| `config` | Configurações | `settings` | Avançado | 90 |
| `translations` | Traduções | `languages` | Avançado | 95 |

`installations` só aparece nos scripts que são instalados no computador ou celular; `discord`, só nos bots do Discord.

## Exemplos

### Subir Vendas para logo depois do Início

```json painel-dev/painel.json theme={null}
{
  "nav": [
    { "@nav": "@core:sales", "label": "Faturamento", "icon": "trending", "position": 15 }
  ]
}
```

Itens que você não lista ficam como no padrão.

### Colocar uma função sua no menu

A função já se coloca no menu sozinha pelo `@nav` do `funcao.json`. Use `painel.json` só para mudar o lugar dela depois:

```json painel-dev/painel.json theme={null}
{
  "nav": [
    { "@nav": "@fn:avisos", "group": "Pessoas", "position": 45 }
  ]
}
```

### Criar um grupo novo

Basta usar o mesmo `group` em mais de um item:

```json painel-dev/painel.json theme={null}
{
  "nav": [
    { "@nav": "@core:sales", "group": "@t.group.money", "position": 41 },
    { "@nav": "@fn:avisos", "group": "@t.group.money", "position": 42 }
  ]
}
```

E a tradução, em cada idioma:

```json painel-dev/traducoes/pt-BR.json theme={null}
{ "@lang": "Português (BR)", "group.money": "Dinheiro" }
```

## Ordem final

1. Menor `position` primeiro.
2. Empate: a função fixa vem antes da sua.
3. Empate entre duas suas: ordem alfabética do id.

Funções suas sem `group` ficam no grupo **Funções do painel**.

## Endereço de cada item

Cada item abre no mesmo sistema de abas do Dashboard: `?tab=<id>`. Uma função na pasta `funcoes/cupons/` abre em `?tab=cupons`; o Voltar do navegador volta para a aba anterior.


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