Skip to content
Automatically build and include all the various platform / device favicon formats from a single source favicon.png
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
addon
app
config Upgrades Mar 14, 2019
tests Fix test assertion Jun 10, 2019
vendor
.editorconfig ember-cli upgrade to 2.15 Sep 9, 2017
.ember-cli Initial Commit from Ember CLI v0.2.5 May 19, 2015
.eslintignore
.eslintrc.js
.github_changelog_generator v2.2.0 Jun 10, 2019
.gitignore
.npmignore
.template-lintrc.js Update to Ember 3.5 Nov 10, 2018
.travis.yml
.watchmanconfig
CHANGELOG.md
CONTRIBUTING.md
LICENSE.md Upgrades Mar 14, 2019
README.md
ember-cli-build.js
index.js Replace broccoli-replace with alternative Jun 10, 2019
package-lock.json v2.2.0 Jun 10, 2019
package.json
testem.js Update to Ember 3.3 Sep 2, 2018

README.md

ember-cli-favicon

Build Status Dependency Status

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 v2.18 or above
  • Ember CLI v2.13 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:

// ember-cli-build.js
var app = new EmberApp({
  'ember-cli-favicon': {
    enabled: env != 'test', // By default favicons are NOT generated in TEST env to speedup builds

    onSuccess() {}, // You can call your callback when favicons are generated successfully

    iconPath: 'favicon.png', // icon path related to `public` folder

    // See the [favicons](https://github.com/itgalaxy/favicons) module for details on the available configuration options.
    faviconsConfig: {
      // these options are passed directly to the favicons module
      path: projectConfig.rootUrl,
      appName: package.name,
      appShortName: package.name,
      appDescription: package.description,
      developerName: package.author,
      version: package.version,
      icons: {
        favicons: true,
        android: isProductionEnv,
        appleIcon: isProductionEnv,
        appleStartup: isProductionEnv,
        coast: isProductionEnv,
        firefox: isProductionEnv,
        windows: isProductionEnv,
        yandex: isProductionEnv
      }
    }
  }
});

Contributing

See the Contributing guide for details.

License

This project is licensed under the MIT License.

You can’t perform that action at this time.