ember-cli-favicon

Take a single favicon source file at public/favicon.png, and convert to the various formats and sizes required for popular devices and platforms. Also injects the appropriate HTML into your index.html file during the build process.

Compatibility

• Ember.js v3.20 or above
• Ember CLI v3.20 or above
• Node.js v12 or above

Installation

ember install ember-cli-favicon

Usage

Just save an image to public/favicon.png (try to make sure it's at least 256x256). Additional configuration options are supplied in your ember-cli-build.js file with following defaults:

1// ember-cli-build.js
2var app = new EmberApp({
3  'ember-cli-favicon': {
4    enabled: env != 'test', // By default favicons are NOT generated in TEST env to speedup builds
5
6    onSuccess() {}, // You can call your callback when favicons are generated successfully
7
8    iconPath: 'favicon.png', // icon path related to `public` folder
9
10    // See the [favicons](https://github.com/itgalaxy/favicons) module for details on the available configuration options.
11    faviconsConfig: {
12      // these options are passed directly to the favicons module
13      path: projectConfig.rootUrl,
14      appName: package.name,
15      appShortName: package.name,
16      appDescription: package.description,
17      developerName: package.author,
18      version: package.version,
19      icons: {
20        favicons: true,
21        android: isProductionEnv,
22        appleIcon: isProductionEnv,
23        appleStartup: isProductionEnv,
24        windows: isProductionEnv,
25        yandex: isProductionEnv
26      }
27    }
28  }
29});

Contributing

See the Contributing guide for details.

License

This project is licensed under the MIT License.