FaviconFactory

Tired of managing dozens of favicons to support all the browsers, resolutions, and formats?

favicon_factory generates from an SVG the minimal set of icons needed by modern browsers.

The source SVG is ideal for modern browsers. And it may contain a <style> tag with @media (prefers-color-scheme: dark) to support light/dark themes, which is ignored when generating favicons.

Icons will be generated in the same folder as the source SVG unless already existing:

favicon.ico (32x32) for legacy browsers; serve it from /favicon.ico because tools, like RSS readers, just look there.
apple-touch-icon.png (180x180) for Apple devices when adding a webpage to the home screen; a background and a padding around the icon is applied to make it look pretty.
manifest.webmanifest that includes icon-192.png, icon-512.png, and icon-mask.png for Android devices; the first two for display on the home screen and on splash screen while the PWA is loading, respectively, and the last one for different Android launchers.

Users

Installation

Vips or ImageMagick are required. If both are present, FaviconFactory defaults to Vips.

Vips:

brew install vips

sudo apt-get install libvips
sudo apt-get install libvips-tools

ImageMagick:

brew install imagemagick

sudo apt-get install imagemagick # consider https://github.com/SoftCreatR/imei/

Add favicon_factory to the Gemfile:

bundle add favicon_factory

Or just install the executable:

gem install favicon_factory

Usage

To generate the favicons:

favicon_factory samples/favicon.svg

# Info: Generating samples/favicon.ico
# Info: Generating samples/icon-192.png
# Info: Generating samples/icon-512.png
# Info: Generating samples/icon-mask.png
# Info: Generating samples/apple-touch-icon.png
# Info: Generating samples/manifest.webmanifest
# Info: Add the following to the `<head>`
#   <!-- favicons generated with the favicon_factory gem -->
#   <link rel="icon" href="/favicon.svg" type="image/svg+xml">
#   <link rel="icon" href="/favicon.ico" sizes="32x32">
#   <link rel="apple-touch-icon" href="/apple-touch-icon.png">
#   <link rel="manifest" href="/manifest.webmanifest">

To show all the options:

favicon_factory --help

Samples

See the samples in samples/.

To recreate them:

docker run -v $(pwd):/usr/src/app $(docker build -q .) bash -c "bin/favicon_factory -b '#ffffff' samples/github.com/vips/favicon.svg"
docker run -v $(pwd):/usr/src/app $(docker build -q .) bash -c "unpath libvips unpath libvips-tools unpath vips bin/favicon_factory -b '#ffffff' samples/github.com/image_magick/favicon.svg"

docker run -v $(pwd):/usr/src/app $(docker build -q .) bash -c "bin/favicon_factory -b '#f5ebdb' samples/rictionary/vips/favicon.svg"
docker run -v $(pwd):/usr/src/app $(docker build -q .) bash -c "unpath libvips unpath libvips-tools unpath vips bin/favicon_factory -b '#f5ebdb' samples/rictionary/image_magick/favicon.svg"

Development

After checking out the repo, run bin/setup to install the dependencies. Then, run rake test to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and the created tag, and push the .gem file to rubygems.org.

Contributing

Bug reports and pull requests are welcome on GitHub.

License

The gem is available as open source under the terms of the MIT License.

Credits

This gem was inspired by an article on Evil Martians.

favicon_factory

Runtime