Ícones de serviço
Este guia é para a equipe da plataforma (papel platform_admin). Em Administração › Catálogo › Ícones (/admin/catalog/icons) fica a biblioteca de ícones que o canvas, a paleta e a lista de recursos de Coda Cloud usam para cada tipo de recurso.
Pacote padrão
A plataforma traz um pacote com um ícone monocromático por tipo de recurso e um para a entrada da Internet. Os desenhos são do projeto Lucide (licença ISC, com alguns ícones do Feather sob MIT), sem logotipos de marca. O pacote é somente leitura: não pode ser alterado nem excluído. Por ser monocromático, o ícone herda a cor do tema e funciona em claro e escuro.
Enviar um ícone
- Escolha Enviar ícone e informe nome, identificador (minúsculas, números e hífens, até 64 caracteres) e o arquivo.
- A prévia mostra o ícone sobre fundo claro e escuro. Cada ícone guarda versões imutáveis: Nova versão troca o desenho sem perder o histórico, e enviar o mesmo arquivo da versão atual não cria versão nova.
Formatos e limites:
| Formato | Limite |
|---|---|
| SVG | até 64 KiB, com viewBox quadrado |
| PNG | quadrado, de 32 a 1024 px, até 256 KiB |
O tipo é detectado pelo conteúdo, nunca pela extensão. Outros formatos (JPEG, WebP, GIF) não são aceitos.
Não envie logotipos de marcas registradas sem autorização. A responsabilidade pelo uso do ícone é de quem o envia.
Por que um envio é recusado
Todo arquivo é validado, sanitizado e verificado contra malware antes de ser gravado. A tela mostra o motivo, com o elemento ou atributo quando for o caso:
| Motivo | O que aconteceu |
|---|---|
| Formato não aceito | o conteúdo não é SVG nem PNG |
| Arquivo grande demais | passou do limite do formato |
| Dimensões inválidas | SVG sem viewBox quadrado ou PNG fora do quadrado e dos limites |
| SVG com conteúdo inseguro | scripts, foreignObject, imagens embutidas, animações, estilos, atributos on*, links externos ou data: |
| Arquivo corrompido | PNG com CRC inválido |
| Malware detectado | o antivírus sinalizou o arquivo |
| Antivírus indisponível | a verificação não pôde ser feita; nada é gravado e você pode tentar de novo |
Os envios recusados e os aceitos ficam na auditoria, sem o conteúdo do arquivo.
Atribuir por tipo de recurso e engine
Em Atribuir ícone, escolha o tipo de recurso, a engine (ou "todas as engines") e o ícone. A ordem de resolução é: atribuição por tipo e engine, atribuição só por tipo, ícone do pacote padrão e, por fim, a sigla do tipo. Remover a atribuição devolve o pacote padrão. Um ícone atribuído não pode ser excluído até a atribuição ser removida.
Os ícones são entregues por um endereço de origem separada do portal, com cabeçalhos que impedem a execução de qualquer conteúdo, e o portal os desenha sempre como imagem, nunca como HTML inline.