Favicon Deployment Template

After generating your favicon suite with /favicon, use this template to deploy the files.

1. File Placement

Root Directory Files

# Copy to website root
cp assets/favicon/favicon.ico ./favicon.ico
cp assets/favicon/apple-touch-icon.png ./apple-touch-icon.png

Assets Directory (optional, for organized structure)

# Keep organized copies in assets
# (main files still need to be in root for browser compatibility)

2. HTML Head Updates

Replace the current favicon links in _includes/head.html:

<!-- Current (replace this) -->
<link rel="shortcut icon" type="image/ico" href="/favicon.ico">
<link rel="apple-touch-icon" href="/assets/index/profile_photo.png">

<!-- New enterprise favicon suite -->
<link rel="icon" type="image/x-icon" href="/favicon.ico">
<link rel="icon" type="image/png" sizes="16x16" href="/assets/favicon/favicon-16x16.png">
<link rel="icon" type="image/png" sizes="32x32" href="/assets/favicon/favicon-32x32.png">
<link rel="icon" type="image/png" sizes="48x48" href="/assets/favicon/favicon-48x48.png">
<link rel="apple-touch-icon" sizes="180x180" href="/apple-touch-icon.png">
<link rel="manifest" href="/manifest.json">

3. Manifest.json Updates

Update manifest.json with new icon references:

{
  "icons": [
    {
      "src": "/assets/favicon/favicon-192x192.png",
      "sizes": "192x192",
      "type": "image/png",
      "purpose": "any maskable"
    },
    {
      "src": "/assets/favicon/favicon-512x512.png", 
      "sizes": "512x512",
      "type": "image/png",
      "purpose": "any maskable"
    }
  ]
}

4. Browser Compatibility

The generated suite provides:

  • favicon.ico: Multi-size ICO for legacy browser support
  • PNG sizes: Modern browsers with specific size requirements
  • Apple touch icon: iOS Safari, home screen bookmarks
  • Manifest icons: Progressive Web App support, Android

5. Testing Checklist

After deployment, test:

  • Browser tab shows new favicon
  • Bookmark displays correct icon
  • iOS “Add to Home Screen” shows apple-touch-icon
  • Android “Add to Home Screen” uses manifest icons
  • All sizes display clearly at different zoom levels
  • Icon works in both light/dark browser themes

6. Cleanup

After successful deployment:

# Optional: Remove old profile_photo references if no longer needed
# Check that apple-touch-icon.png is not used elsewhere first