Si alguna vez has creado un proyecto con Webpack y has visto que la pestaña del navegador muestra un globo genérico o un cuadrado en blanco, no eres el único. Webpack no gestiona los favicons de forma nativa: tendrás que conectarlo tú. La buena noticia es que solo necesitas unas líneas de configuración cuando sabes dónde colocar el archivo y cómo insertar el link tag.

En esta guía te explicamos cómo añadir un favicon a un proyecto de Webpack, desde colocar el archivo hasta comprobarlo en el navegador. Veremos tanto el enfoque sencillo de copia como el método con HtmlWebpackPlugin, además de las trampas que hacen tropezar a la mayoría de los desarrolladores.

Requisitos previos

Deberías tener un proyecto de Webpack funcionando con webpack y webpack-cli instalados. Si utilizas html-webpack-plugin para generar tu HTML, mejor todavía: lo usaremos en el enfoque recomendado. También necesitarás un archivo favicon (ICO, PNG o SVG) listo para usar. Si no tienes uno, puedes generar un ICO de varios tamaños con nuestra guía.

Paso 1: Coloca el favicon en tu proyecto

Crea una carpeta para los assets estáticos si aún no tienes una. Una convención habitual es src/assets/ o public/. Coloca allí tu archivo favicon; puedes llamarlo favicon.ico para lograr la máxima compatibilidad con los navegadores. También puedes usar favicon.png o favicon.svg; los navegadores modernos admiten SVG, pero necesita un fallback para los más antiguos (consulta SVG con fallback PNG).

En esta guía, supondremos que el archivo está en src/assets/favicon.ico.

Paso 2: Configura Webpack para copiar el favicon

Webpack debe conocer el archivo para que termine en el directorio de salida de tu build. La forma más sencilla de hacerlo es utilizar copy-webpack-plugin. Instálalo:

npm install --save-dev copy-webpack-plugin

Después, añádelo a tu webpack.config.js:

const CopyPlugin = require('copy-webpack-plugin');

module.exports = {
  // ... other config
  plugins: [
    new CopyPlugin({
      patterns: [
        { from: 'src/assets/favicon.ico', to: 'favicon.ico' }
      ]
    })
  ]
};

Esto copia el favicon a la raíz de tu directorio de salida (p. ej., dist/favicon.ico). Los navegadores solicitan automáticamente /favicon.ico si no hay una etiqueta link, por lo que esto puede ser suficiente; sin embargo, las etiquetas link explícitas son mejores porque te ofrecen más control y permiten usar formatos que no sean ICO.

Paso 3: Inyecta la etiqueta link con HtmlWebpackPlugin

Si usas html-webpack-plugin, puedes añadir el enlace al favicon directamente en tu plantilla HTML. En tu plantilla index.html (normalmente en src/), añade esto dentro de <head>:

<link rel='icon' href='favicon.ico' type='image/x-icon'>

Como el archivo se copia a la raíz de salida, la ruta relativa favicon.ico se resuelve correctamente. Si sirves el sitio desde un subdirectorio, utiliza una ruta absoluta como /favicon.ico o configura publicPath en Webpack.

Para los favicons SVG, utiliza:

<link rel='icon' href='favicon.svg' type='image/svg+xml'>

Y para los PNG:

<link rel='icon' href='favicon.png' type='image/png'>

El atributo rel='icon' está definido en el estándar HTML como la forma de especificar el icono de un sitio. Los navegadores lo utilizan para elegir el icono más adecuado para las pestañas, los marcadores y el historial.

Paso 4: Compila y verifica

Ejecuta tu comando de compilación (p. ej., npm run build). Comprueba que favicon.ico aparezca en la carpeta de salida. Después, sirve la compilación localmente (p. ej., con npx serve dist) y ábrela en un navegador. La pestaña debería mostrar tu icono. Si no lo hace, haz una recarga forzada (Ctrl+Shift+R o Cmd+Shift+R) para omitir la caché.

También puedes inspeccionar el código fuente de la página para confirmar que la etiqueta link está presente y que la ruta es correcta.

Problemas habituales

Conclusión

Añadir un favicon a un proyecto Webpack es sencillo una vez que conoces los dos elementos clave: copiar el archivo a la salida y referenciarlo en tu HTML. Usa copy-webpack-plugin para mover el asset y añade una etiqueta link rel='icon' en tu template. Eso es todo: tus pestañas se verán pulidas y profesionales.

Si necesitas generar un conjunto completo de favicons (ICO, PNG, Apple Touch, manifest icons), prueba Mzu favicondl para crear todos los archivos de una sola vez.