O Que É um Web Manifest? Metadados Para Apps Instaláveis
Um web manifest é um arquivo JSON que descreve seu web app para o navegador: seu nome, ícones, cores e como ele deve ser iniciado quando instalado.
Quando um usuário instala um web app na tela inicial, o navegador precisa saber como chamá-lo, qual ícone usar e como ele deve aparecer. O web manifest fornece esses metadados em um pequeno arquivo JSON referenciado a partir do seu HTML. Ele é um ingrediente obrigatório para um PWA instalável e um artifact de build simples para a CI produzir e verificar.
O que o manifest contém
- name e short_name para o app instalado.
- icons em múltiplos tamanhos para diferentes dispositivos.
- start_url e modo de exibição (standalone, fullscreen, browser).
- theme_color e background_color para a tela de inicialização.
Como ele é referenciado
Uma tag <link rel="manifest" href="..."> no HTML aponta o navegador para o arquivo. O navegador o lê ao decidir se o app é instalável e como renderizar o prompt de instalação e a tela de inicialização.
Por que o modo de exibição importa
O campo display controla se o app instalado exibe o chrome do navegador. Os modos standalone ou fullscreen são o que fazem um PWA parecer nativo, iniciando sem uma barra de endereço.
Ícones e o build
O manifest referencia arquivos de ícone que precisam realmente existir nos caminhos e tamanhos listados. Gerar esses ícones a partir de uma única imagem de origem é um passo comum de build para que cada tamanho necessário esteja presente.
O manifest na CI/CD
O build gera o manifest, muitas vezes injetando caminhos de ícone com hash de conteúdo para que tenham bom cache. A CI deve validar que o manifest é um JSON válido, que cada ícone referenciado foi emitido e que os campos obrigatórios estão presentes, já que um manifest quebrado desativa silenciosamente a instalabilidade.
Principais conclusões
- Um web manifest é um metadado JSON que descreve como instalar e exibir o app.
- O modo de exibição e os ícones são o que fazem um PWA instalado parecer nativo.
- A CI deve validar o manifest e confirmar que cada ícone referenciado existe.