{"canonical_url":"https://engineer.company/es/glossary/webmanifest/","content_markdown":"# Manifiesto de aplicación web\n\n## Qué es\n\nUn manifiesto de aplicación web es un documento JSON que describe un sitio\nweb como aplicación: cómo se llama, en qué dirección se abre, qué direcciones\nle pertenecen, cómo debe verse su ventana y qué imágenes lo representan. Una\npágina señala el archivo mediante un elemento `link` cuyo `rel` es\n`manifest`; un navegador que ofrece instalación lo lee para decidir cómo será\nla copia instalada. La especificación del W3C que lo define lo llama simplemente\nmanifiesto, y así se suele llamar también en el uso cotidiano.\n\nEl archivo es JSON corriente. Su tipo de medio registrado es\n`application/manifest+json` y su extensión registrada es `.webmanifest`, aunque\nla especificación acepta cualquier tipo de medio JSON y muchos sitios sirven\nun `manifest.json`. Todos los miembros son opcionales. Un manifiesto pequeño\npara un sitio imaginario de tablas de mareas sería así:\n\n```json\n{\n    \"name\": \"Harbour Tide Tables\",\n    \"short_name\": \"Tides\",\n    \"start_url\": \"/tides/\",\n    \"display\": \"standalone\",\n    \"background_color\": \"#ffffff\",\n    \"icons\": [\n        {\n            \"src\": \"/icons/tides-512.png\",\n            \"sizes\": \"512x512\",\n            \"type\": \"image/png\"\n        }\n    ]\n}\n```\n\nTres miembros deciden qué es la aplicación, a diferencia de cómo se ve.\n`start_url` propone la página que abre la aplicación instalada; el navegador\npuede ignorarla o permitir que el usuario la cambie. `scope` es el conjunto\nde direcciones que se consideran parte de la aplicación. Si falta, la\nespecificación toma la URL inicial y le quita el nombre del archivo, la cadena\nde consulta y el fragmento, de modo que el ejemplo abarca todo lo situado bajo\n`/tides/`. `id` es la identidad de la aplicación y, si falta, toma la URL\ninicial. Las direcciones relativas de los iconos y la URL inicial se resuelven\ncon respecto a la URL del propio manifiesto, no a la página que lo enlazó.\nUn `id` relativo, en cambio, se resuelve con respecto al origen de la URL\ninicial.\n\nEl resto es presentación. `display` solicita `fullscreen`, `standalone`,\n`minimal-ui` o `browser`; un navegador que no puede cumplirlo desciende por\nesa lista en orden. Cada icono puede llevar un `purpose`: `any` de forma predeterminada,\n`maskable` para una imagen diseñada para resistir recortes, o `monochrome`\npara una cuyo color se descarta y de la que solo se usa el canal alfa.\n`theme_color` tiñe la ventana que rodea a la aplicación. Una nota complementaria\ndel W3C añade `description`, `categories` y `screenshots`, que pueden mostrarse\nen diálogos de instalación y tiendas de aplicaciones.\n\n## Por qué importa\n\nEl manifiesto aporta metadatos de instalación controlados por el sitio.\nLa especificación deja la decisión de instalar al navegador: puede ofrecer\nuna forma de hacerlo, y cada navegador fija sus condiciones, algunas de las\ncuales requieren ciertos miembros. El equipo entrega los datos de entrada y\nel navegador decide qué hacer con ellos. La pregunta útil no es tanto si\nconviene tener un manifiesto como qué promete.\n\nLa identidad es la promesa que dura más que el archivo. Cuando un navegador\nvuelve a obtener el manifiesto, la especificación indica que debería usar un\n`id` coincidente como señal de que el nuevo archivo sustituye al manifiesto\nde una aplicación ya instalada. Como un `id` ausente toma la URL inicial,\nmover la página de inicio cambia silenciosamente la identidad; el navegador\ndebería tratar el nuevo archivo como una aplicación distinta de la que tiene\nel lector en su dispositivo. Fijar `id` en la primera versión cuesta una\nlínea y elimina ese riesgo.\n\nEl alcance decide dónde termina la ventana de la aplicación. La navegación\ndentro de ese alcance permanece en la ventana instalada. Un enlace que sale\nde él se abre igualmente, pero la especificación espera que el navegador\nindique al lector que está fuera de la aplicación. Un alcance más estrecho que\nel sitio hace que los enlaces habituales entre secciones parezcan salidas.\n\nLos iconos concentran la mayoría de los daños visibles. Los lanzadores los\nrecortan en círculos, cuadrados redondeados y otras formas; un logotipo que\nllena todo su cuadrado pierde los bordes. La especificación define la zona\nsegura de un icono enmascarable como un círculo central cuyo radio es dos\nquintos del lado más corto del icono; lo que quede fuera puede recortarse.\nUn icono monocromo conserva solo su canal alfa, por lo que uno dibujado sobre\nun fondo opaco se convierte en un cuadrado sólido.\n\nLos miembros de color tienen un alcance menor del que parece.\n`background_color` está pensado solo para el momento anterior a la llegada\nde la hoja de estilos, y la especificación prohíbe al navegador usarlo cuando\nesta ya está disponible. Es el color del primer fotograma, y de nada posterior.\n\n## Cómo se aplica en la práctica\n\nEste sitio genera su manifiesto a partir de una plantilla en lugar de\nmantener un archivo a mano. Su configuración de Hugo registra\n`application/manifest+json` con el sufijo `webmanifest` y establece el\nmanifiesto como salida de la página de inicio de cada idioma. Así, cada idioma\ntiene su propio archivo y la cabecera de cada página enlaza el correspondiente\na su idioma. La configuración deja escrita la razón: una sola copia global\nsolo puede indicar una URL inicial, y un visitante que instalaba la versión danesa del\nsitio obtenía una aplicación que abría la página de inicio en inglés.\n\nLa plantilla compone el manifiesto como un mapa y lo entrega al codificador\nJSON de Hugo: el escape y las comas son responsabilidad del codificador, y no\npuede publicarse un JSON al que le falte una coma. Cada dirección de icono parte de la raíz\ndel servidor. El comentario explica por qué: una dirección relativa en\n`/da/manifest.webmanifest` se resolvería bajo `/da/`, y todos los iconos en\ndanés darían un 404. Los iconos se leen del disco desde tres carpetas, una por\npropósito, con diez tamaños cada una, de 36 a 512 píxeles. El tamaño se obtiene\ndel nombre del archivo, así que uno añadido por el generador aparece en el\nmanifiesto sin editar nada.\n\n`id` está fijado a la dirección de inicio del idioma, y `scope` abarca todo\nel origen, por lo que un enlace a otro idioma sigue dentro de la ventana\ninstalada. Las capturas se llaman `\u003clang\u003e-\u003cform_factor\u003e-\u003cWxH\u003e.webp`, y la\nplantilla extrae los tres datos del nombre: inglés y danés tienen cada uno\nuna captura ancha de 1.280 por 800 y otra estrecha de 780 por 1.688. Un idioma\nsin capturas no recibe ningún miembro `screenshots`, en lugar de una lista\nvacía.\n\n[La página de créditos](/es/credits/) incluye la especificación del W3C\nentre los estándares que sigue el sitio, y PWABuilder entre las comprobaciones\nexternas que cualquiera puede ejecutar: un servicio que lee el manifiesto y\nlos demás elementos que permiten instalar el sitio, desde equipos de Microsoft.\n\n[La página de instalación](/es/install/) es la parte del mismo archivo\ndirigida al lector. Explica dónde tiene cada navegador el comando de instalación\ny señala que los navegadores de Apple nunca lo ofrecen por iniciativa propia.\nFirefox dispone de una función separada de ventanas de aplicaciones web,\nactivada de forma predeterminada en Windows desde la versión 143, o desde la 150 para\ninstalaciones de Microsoft Store. La documentación de implementación de Mozilla\nindica que el soporte de Linux está desactivado de forma predeterminada y que el de macOS\nno está disponible. La página también aclara qué esperar de este sitio: la\naplicación instalada es un icono y una ventana propia. El sitio no publica\nningún service worker ni una copia sin conexión gestionada, por lo que necesita\nconexión para el uso normal.\n\n## Dónde surgen los problemas\n\n**Todos los iconos devuelven un 404 bajo una ruta traducida.** Un `src`\nrelativo se resuelve con respecto a la URL del manifiesto. Si este se sirve\nbajo un prefijo de idioma, pide los iconos bajo ese mismo prefijo. Escriba las\ndirecciones de los iconos desde la raíz del servidor o como URL completas.\n\n**La aplicación instalada abre el idioma equivocado.** Un manifiesto puede\nindicar una URL inicial, por lo que todos los lectores instalan la misma página\nde inicio. Sirva un manifiesto por idioma, cada uno con sus propios `start_url`\ne `id`, y enlace el correspondiente desde cada página.\n\n**Las copias instaladas ignoran el nuevo manifiesto.** Sin `id`, la identidad\nes la URL inicial. Mover la página de inicio da al archivo una identidad nueva\ny el navegador debería tratarlo como una aplicación distinta de la que ya\ntienen los lectores. Defina `id` antes de la primera versión y no lo cambie\ndespués.\n\n**El lanzador recorta el logotipo.** Un icono con propósito `any` se coloca\no recorta como decida la plataforma. Añada un icono `maskable` que mantenga\ntodo lo importante dentro del círculo central, con un radio del 40 % del lado\nmás corto del icono.\n\n**Editar el manifiesto no cambia nada.** El estándar HTML usa solo el primer\nelemento `link` cuyo `rel` contiene `manifest`. Si un tema o complemento ha\ninsertado su propio enlace antes en la página, el archivo editado nunca es el\nque se lee. Mantenga exactamente un enlace al manifiesto por página.\n\n## Lecturas adicionales\n\n- [Web Application Manifest](https://www.w3.org/TR/appmanifest/) — todos los\n  miembros, procesamiento del archivo por el navegador y reglas de `id`,\n  `scope` y propósitos de los iconos.\n- [Web App Manifest - Application Information](https://www.w3.org/TR/manifest-app-info/)\n  — `description`, `categories` y `screenshots`, con factores de forma y\n  etiquetas.\n- [IANA: application/manifest+json](https://www.iana.org/assignments/media-types/application/manifest+json)\n  — registro del tipo de medio y de su extensión `.webmanifest`.\n- [HTML Standard: link type manifest](https://html.spec.whatwg.org/multipage/links.html#link-type-manifest)\n  — obtención del enlace al manifiesto y por qué solo cuenta el primero.\n- [Use web apps in Firefox for Windows](https://support.mozilla.org/en-US/kb/web-apps-firefox-windows)\n  — función de Windows, disponible desde la versión 143, o desde la 150 para\n  instalaciones de Microsoft Store.\n- [Firefox Source Docs: Web Apps in Firefox](https://firefox-source-docs.mozilla.org/browser/components/taskbartabs/docs/index.html)\n  — implementación actual: Windows activado de forma predeterminada, Linux desactivado\n  de forma predeterminada y macOS no admitido.\n\n\u003chttps://engineer.company/es/glossary/webmanifest/\u003e\n","date_modified":"2026-11-09T21:50:25Z","description":"Qué decide el manifiesto de una aplicación web instalada, por qué su id debe permanecer estable y cómo los lanzadores recortan sus iconos.","formats":{"gemtext":"https://engineer.company/es/glossary/webmanifest/index.gmi","gopher":"https://engineer.company/es/glossary/webmanifest/gophermap","html":"https://engineer.company/es/glossary/webmanifest/","json":"https://engineer.company/es/glossary/webmanifest/index.json","markdown":"https://engineer.company/es/glossary/webmanifest/index.md","pdf":"https://engineer.company/es/glossary/webmanifest/index.pdf"},"kind":"page","language":"es","title":"¿Qué es un manifiesto de aplicación web?","url":"https://engineer.company/es/glossary/webmanifest/","version":1}