Como usar
- Digite o Nome e o Nome curto, depois a URL inicial e o Escopo do aplicativo.
- Escolha o Modo de exibição e digite a Cor de fundo e a Cor do tema como cores hexadecimais.
- Escreva um ícone por linha em Ícones: o endereço, depois os tamanhos, o tipo e as finalidades, separados por barras.
- Salve o texto em manifest.webmanifest e corrija cada aviso listado em Verificações de instalação.
O que significam os membros
O manifest é um arquivo JSON. Os seus membros são descritos na Web Application Manifest do W3C (seção 1, em inglês). Só os membros que você preenche são escritos, então um campo vazio deixa o seu membro de fora. O modo de exibição decide como o navegador mostra o aplicativo; se o navegador não suporta um modo, usa o próximo desta cadeia (seção 6): tela cheia, depois autônomo, depois interface mínima, depois aba do navegador.
Um endereço inicial em outra origem que a da página é ignorado, porque a especificação exige a mesma origem. Um escopo só é usado quando contém a URL inicial; caso contrário, os navegadores usam o escopo que é a URL inicial sem o nome do arquivo, a consulta e o fragmento.
O que os avisos verificam
A MDN lista os membros que os navegadores baseados em Chromium precisam antes de oferecer a instalação de um aplicativo web: um nome ou um nome curto, ícones de 192px e de 512px, uma URL inicial e um modo de exibição. Ela também diz que o site deve ser servido por https, ou a partir de localhost, e que um service worker não é obrigatório. O Firefox não instala um aplicativo web a partir de um arquivo de manifest em computadores.
A ferramenta verifica os membros acima e a regra do escopo. Ela não testa os arquivos de ícone, o endereço HTTPS nem o link nas suas páginas; isso cabe a você confirmar.
Os valores padrão
Com os valores com que a página abre, o manifest tem os membros abaixo. As verificações não mostram aviso, porque o nome, a URL inicial e os dois tamanhos de ícone estão presentes.
| Membro | Valor |
|---|---|
| name, short_name | Notes, Notes |
| start_url, scope | /, / |
| display | standalone |
| background_color, theme_color | #ffffff, #1f6feb |
| icons | arquivos PNG de 192x192 e 512x512; o ícone de 512 tem a finalidade any maskable |
Perguntas frequentes
Onde salvo o arquivo de manifest?
Salve-o na raiz do site, ou na pasta do aplicativo, com o nome manifest.webmanifest. Depois vincule-o em cada página do aplicativo com um elemento link cujo rel seja manifest, como a MDN descreve.
Preciso de um service worker para instalar o aplicativo?
Não. A MDN diz que um service worker não é um requisito para um PWA ser instalável, embora muitos aplicativos usem um para funcionar sem conexão. O site ainda precisa ser servido por https, ou a partir de localhost.
Quais tamanhos de ícone eu preciso?
A MDN lista um ícone de 192px e um de 512px para navegadores baseados em Chromium. Escreva os tamanhos como LARGURAxALTURA, separados por espaços quando um arquivo tem vários. Um arquivo SVG pode ter o tamanho any.
Qual é a diferença entre nome curto e nome?
O nome é o nome completo do aplicativo. O nome curto serve para os lugares em que o espaço é pouco, como o rótulo embaixo do ícone na tela inicial. Informe pelo menos um deles; esta ferramenta avisa quando os dois estão vazios.
Por que a ferramenta avisa sobre o escopo?
Um escopo só é usado quando contém a URL inicial (W3C, seção 1). Se a URL inicial estiver fora do escopo, os navegadores ignoram o escopo e usam o padrão, então o aplicativo pode abrir fora da área que você quis.
Fontes
- W3C, Web Application Manifest (Working Draft, 6 November 2026): sections 1, 2 and 6 (em inglês)
- MDN, Making PWAs installable (em inglês)
- MDN, display member of the web app manifest (em inglês)
- MDN, icons member of the web app manifest (em inglês)
Números e texto verificados pela última vez em terça-feira, 10 de novembro de 2026.