Installation

Install bud-favicons to your project.

Yarn:

yarn add bud-favicons --dev

npm:

npm install bud-favicons --save-dev

Configuration

bud-favicons works with zero configuration. But there is a robust and developer friendly configuration API should you need to make a modification to the provided defaults. You can see the full list of options in the favicons documentation.

Default configuration

const options = {
  logo: bud.path('resources/images/favicon.svg'),
  mode: 'webapp',
  devMode: 'webapp',
  outputPath: bud.path('public'),
  favicons: {
      icons: {
          android: true,
          appleIcon: true,
          appleStartup: true,
          favicons: true,
          windows: true,
          yandex: false,
      },
  },
};

Configuration with bud.favicons.config

You can configure favicons with the bud.favicons method:

bud.favicons.setup({
  logo: bud.path('resources/images/favicon.svg'),
});

OR

bud.favicons.setup({
  logo: bud.path('resources/images/favicon.svg'),
  mode: 'webapp',
  devMode: 'webapp',
  outputPath: bud.path('public'),
  favicons: {
      background: '#030321',
      theme_color: '#ffffff',
      icons: {
          android: true,
          appleIcon: true,
          appleStartup: true,
          favicons: true,
          windows: true,
          yandex: false,
      },
  },
});

Contributing

Contributions are welcome from everyone.

Credits

Bud Favicons is a Itineris Limited project created by Dan Lapteacru.

Full list of contributors can be found here.

License

Bud Favicons is released under the MIT License.